Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • 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
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 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
  • Arguments & Attributes Reference
  1. Terraform reference
  2. Resources
  3. Application Load Balancer
  4. Data Sources
  5. alb_load_balancer

yandex_alb_load_balancer (DataSource)

Written by
Yandex Cloud
Updated at February 9, 2026
  • Example usage
  • Arguments & Attributes Reference

Get information about a Yandex Application Load Balancer. For more information, see Yandex Cloud Application Load Balancer.

This data source is used to define Application Load Balancer that can be used by other resources.

Warning

One of load_balancer_id or name should be specified.

Example usageExample usage

//
// Get information about existing Application Load Balancer (ALB).
//
data "yandex_alb_load_balancer" "tf-alb-data" {
  load_balancer_id = "my-alb-id"
}

Arguments & Attributes ReferenceArguments & Attributes Reference

  • allocation_policy [Block]. Allocation zones for the Load Balancer instance.
    • location [Block]. Unique set of locations.
      • disable_traffic (Bool). If set, will disable all L7 instances in the zone for request handling.
      • subnet_id (Required)(String). ID of the subnet that location is located at.
      • zone_id (Required)(String). The availability zone where resource is located. If it is not provided, the default provider zone will be used.
  • allow_zonal_shift (Bool). Specifies whether application load balancer is available to zonal shift
  • auto_scale_policy [Block]. Scaling settings of the application load balancer.
    • max_size (Number). Upper limit for total instance count (across all zones)
    • min_zone_size (Number). Lower limit for instance count in each zone.
  • created_at (Read-Only) (String). The creation timestamp of the resource.
  • 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.
  • id (String).
  • labels (Map Of String). A set of key/value label pairs which assigned to resource.
  • listener [Block]. List of listeners for the Load Balancer.
    • endpoint [Block]. Network endpoint (addresses and ports) of the listener.
      • address [Block]. One or more addresses to listen on.
        • external_ipv4_address [Block]. External IPv4 address.
          • address (String). Provided by the client or computed automatically.
        • external_ipv6_address [Block]. External IPv6 address.
          • address (String). Provided by the client or computed automatically.
        • internal_ipv4_address [Block]. Internal IPv4 address.
          • address (String). Provided by the client or computed automatically.
          • subnet_id (String). ID of the subnet that the address belongs to.
      • ports (Required)(List Of Number). One or more ports to listen on.
    • http [Block]. HTTP handler that sets plain text HTTP router.
      • handler [Block]. HTTP handler.
        • allow_http10 (Bool). If set, will enable only HTTP1 protocol with HTTP1.0 support.
        • http2_options [Block]. If set, will enable HTTP2 protocol for the handler.
          • max_concurrent_streams (Number). Maximum number of concurrent streams.
        • http_router_id (String). HTTP router id.
        • rewrite_request_id (Bool). When unset, will preserve the incoming x-request-id header, otherwise would rewrite it with a new value.
      • redirects [Block]. Shortcut for adding http -> https redirects.
        • http_to_https (Bool). If set redirects all unencrypted HTTP requests to the same URI with scheme changed to https.
    • name (Required)(String). Name of the listener.
    • stream [Block]. Stream configuration
      • handler [Block]. Stream handler resource.
        • backend_group_id (String). Backend Group ID.
        • idle_timeout (String). The idle timeout is the interval after which the connection will be forcibly closed if no data has been transmitted or received on either the upstream or downstream connection. If not configured, the default idle timeout is 1 hour. Setting it to 0 disables the timeout.
    • tls [Block]. TLS configuration
      • default_handler [Block]. TLS handler resource.
        • certificate_ids (Required)(Set Of String). Certificate IDs in the Certificate Manager. Multiple TLS certificates can be associated with the same context to allow both RSA and ECDSA certificates. Only the first certificate of each type will be used.
        • http_handler [Block]. HTTP handler.
          • allow_http10 (Bool). If set, will enable only HTTP1 protocol with HTTP1.0 support.
          • http2_options [Block]. If set, will enable HTTP2 protocol for the handler.
            • max_concurrent_streams (Number). Maximum number of concurrent streams.
          • http_router_id (String). HTTP router id.
          • rewrite_request_id (Bool). When unset, will preserve the incoming x-request-id header, otherwise would rewrite it with a new value.
        • stream_handler [Block]. Stream handler resource.
          • backend_group_id (String). Backend Group ID.
          • idle_timeout (String). The idle timeout is the interval after which the connection will be forcibly closed if no data has been transmitted or received on either the upstream or downstream connection. If not configured, the default idle timeout is 1 hour. Setting it to 0 disables the timeout.
      • sni_handler [Block]. Settings for handling requests with Server Name Indication (SNI)
        • handler [Block]. TLS handler resource.
          • certificate_ids (Required)(Set Of String). Certificate IDs in the Certificate Manager. Multiple TLS certificates can be associated with the same context to allow both RSA and ECDSA certificates. Only the first certificate of each type will be used.
          • http_handler [Block]. HTTP handler.
            • allow_http10 (Bool). If set, will enable only HTTP1 protocol with HTTP1.0 support.
            • http2_options [Block]. If set, will enable HTTP2 protocol for the handler.
              • max_concurrent_streams (Number). Maximum number of concurrent streams.
            • http_router_id (String). HTTP router id.
            • rewrite_request_id (Bool). When unset, will preserve the incoming x-request-id header, otherwise would rewrite it with a new value.
          • stream_handler [Block]. Stream handler resource.
            • backend_group_id (String). Backend Group ID.
            • idle_timeout (String). The idle timeout is the interval after which the connection will be forcibly closed if no data has been transmitted or received on either the upstream or downstream connection. If not configured, the default idle timeout is 1 hour. Setting it to 0 disables the timeout.
        • name (Required)(String). Name of the SNI handler
        • server_names (Required)(Set Of String). Server names that are matched by the SNI handler
  • load_balancer_id (String). The resource identifier.
  • log_group_id (Read-Only) (String). Cloud Logging group ID to send logs to. Leave empty to use the balancer folder default log group.
  • log_options [Block]. Cloud Logging settings.
    • disable (Bool). Set to true to disable Cloud Logging for the balancer.
    • discard_rule [Block]. List of rules to discard a fraction of logs.
      • discard_percent (Number). The percent of logs which will be discarded.
      • grpc_codes (List Of String). list of grpc codes by name, e.g, [NOT_FOUND, RESOURCE_EXHAUSTED].
      • http_code_intervals (List Of String). List of http code intervals 1XX-5XX or ALL
      • http_codes (List Of Number). List of http codes 100-599.
    • log_group_id (String). Cloud Logging group ID to send logs to. Leave empty to use the balancer folder default log group.
  • name (String). The resource name.
  • network_id (Required)(String). The VPC Network ID of subnets which resource attached to.
  • region_id (String). The region ID where Load Balancer is located at.
  • security_group_ids (Set Of String). The list of security groups applied to resource or their components.
  • status (Read-Only) (String). Status of the Load Balancer.

Was the article helpful?

Previous
alb_http_router
Next
alb_target_group
© 2026 Direct Cursus Technology L.L.C.