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
          • api_gateway

In this article:

  • Example usage
  • Schema
  • Optional
  • Read-Only
  • Nested Schema for canary
  • Nested Schema for connectivity
  • Nested Schema for custom_domains
  • Nested Schema for log_options
  1. Terraform reference
  2. Resources
  3. Yandex API Gateway
  4. Data Sources
  5. api_gateway

yandex_api_gateway (Data Source)

Written by
Yandex Cloud
Updated at September 11, 2025
  • Example usage
  • Schema
    • Optional
    • Read-Only
    • Nested Schema for canary
    • Nested Schema for connectivity
    • Nested Schema for custom_domains
    • Nested Schema for log_options

Get information about a Yandex Cloud API Gateway. For more information, see the official documentation Yandex Cloud API Gateway.

Warning

Either api_gateway_id or name must be specified.

Example usageExample usage

//
// Get information about existing API Gateway
//
data "yandex_api_gateway" "my-api-gateway" {
  name = "my-api-gateway"
}

SchemaSchema

OptionalOptional

  • api_gateway_id (String) Yandex Cloud API Gateway id used to define api gateway.
  • canary (Block List, Max: 1) (see below for nested schema)
  • connectivity (Block List, Max: 1) (see below for nested schema)
  • custom_domains (Block Set) (see below for nested schema)
  • execution_timeout (String) Execution timeout in seconds for the Yandex Cloud API Gateway.
  • folder_id (String) The folder identifier that resource belongs to. If it is not provided, the default provider folder-id is used.
  • name (String) The resource name.
  • variables (Map of String) A set of values for variables in gateway specification.

Read-OnlyRead-Only

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

  • description (String) The resource description.

  • domain (String) Default domain for the Yandex Cloud API Gateway. Generated at creation time.

  • id (String) The ID of this resource.

  • labels (Map of String) A set of key/value label pairs which assigned to resource.

  • log_group_id (String) ID of the log group for the Yandex Cloud API Gateway.

  • log_options (List of Object) (see below for nested schema)

  • status (String) Status of the Yandex Cloud API Gateway.

  • user_domains (Set of String, Deprecated)

    Warning

    DEPRECATED Use custom_domains instead. Set of user domains attached to Yandex Cloud API Gateway.

Nested Schema for Nested Schema for canary

Optional:

  • variables (Map of String) A list of values for variables in gateway specification of canary release.

  • weight (Number) Percentage of requests, which will be processed by canary release.

Nested Schema for Nested Schema for connectivity

Required:

  • network_id (String) Network the gateway will have access to. It's essential to specify network with subnets in all availability zones.

Nested Schema for Nested Schema for custom_domains

Required:

  • certificate_id (String)
  • fqdn (String)

Optional:

  • domain_id (String)

Nested Schema for Nested Schema for log_options

Read-Only:

  • disabled (Boolean) Is logging from Yandex Cloud API Gateway disabled.

  • folder_id (String) Log entries are written to default log group for specified folder.

  • log_group_id (String) Log entries are written to specified log group.

  • min_level (String) Minimum log entry level.

Was the article helpful?

Previous
vpc_subnet
Next
api_gateway
© 2025 Direct Cursus Technology L.L.C.