Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Terraform in Yandex Cloud
  • Getting started
  • Solution library
    • Overview
    • Release notes
          • alb_backend_group
          • alb_http_router
          • alb_load_balancer
          • alb_target_group
          • alb_virtual_host

In this article:

  • Example usage
  • Schema
  • Optional
  • Read-Only
  • Nested Schema for route_options
  • Nested Schema for route_options.rbac
  • Nested Schema for route_options.rbac.principals
  • Nested Schema for route_options.rbac.principals.and_principals
  • Nested Schema for route_options.rbac.principals.and_principals.header
  • Nested Schema for route_options.rbac.principals.and_principals.header.value
  • Nested Schema for timeouts
  • Import
  1. Terraform reference
  2. Resources
  3. Application Load Balancer (ALB)
  4. Resources
  5. alb_http_router

yandex_alb_http_router (Resource)

Written by
Yandex Cloud
Updated at September 11, 2025
  • Example usage
  • Schema
    • Optional
    • Read-Only
    • Nested Schema for route_options
    • Nested Schema for route_options.rbac
    • Nested Schema for route_options.rbac.principals
    • Nested Schema for route_options.rbac.principals.and_principals
    • Nested Schema for route_options.rbac.principals.and_principals.header
    • Nested Schema for route_options.rbac.principals.and_principals.header.value
    • Nested Schema for timeouts
  • Import

Creates an HTTP Router in the specified folder. For more information, see the official documentation.

Example usageExample usage

//
// Create a new ALB HTTP Router
//
resource "yandex_alb_http_router" "tf-router" {
  name = "my-http-router"
  labels {
    tf-label    = "tf-label-value"
    empty-label = "s"
  }
}

SchemaSchema

OptionalOptional

  • description (String) The resource description.
  • folder_id (String) The folder identifier that resource belongs to. If it is not provided, the default provider folder-id is used.
  • labels (Map of String) A set of key/value label pairs which assigned to resource.
  • name (String) The resource name.
  • route_options (Block List, Max: 1) Route options for the virtual host. (see below for nested schema)
  • timeouts (Block, Optional) (see below for nested schema)

Read-OnlyRead-Only

  • created_at (String) The creation timestamp of the resource.
  • id (String) The ID of this resource.

Nested Schema for Nested Schema for route_options

Optional:

  • rbac (Block List, Max: 1) RBAC configuration. (see below for nested schema)
  • security_profile_id (String) SWS profile ID.

Nested Schema for Nested Schema for route_options.rbac

Required:

  • principals (Block List, Min: 1) (see below for nested schema)

Optional:

  • action (String)

Nested Schema for Nested Schema for route_options.rbac.principals

Required:

  • and_principals (Block List, Min: 1) (see below for nested schema)

Nested Schema for Nested Schema for route_options.rbac.principals.and_principals

Optional:

  • any (Boolean)
  • header (Block List, Max: 1) (see below for nested schema)
  • remote_ip (String)

Nested Schema for Nested Schema for route_options.rbac.principals.and_principals.header

Required:

  • name (String)

Optional:

  • value (Block List, Max: 1) The path and fqmn blocks.

Warning

Exactly one type of string matches exact, prefix or regex should be specified. (see below for nested schema)

Nested Schema for Nested Schema for route_options.rbac.principals.and_principals.header.value

Optional:

  • exact (String) Match exactly.
  • prefix (String) Match prefix.
  • regex (String) Match regex.

Nested Schema for Nested Schema for timeouts

Optional:

  • create (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
  • delete (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
  • update (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

ImportImport

The resource can be imported by using their resource ID. For getting the resource ID you can use Yandex Cloud Web Console or YC CLI.

# terraform import yandex_alb_http_router.<resource Name> <resource Id>
terraform import yandex_alb_http_router.my_router ds7ph**********hm4in

Was the article helpful?

Previous
alb_backend_group
Next
alb_load_balancer
© 2025 Direct Cursus Technology L.L.C.