aws_apigateway_stage

access_log_settings

Type: STRUCT
Provider name: accessLogSettings
Description: Settings for logging access in this stage.

  • destination_arn
    Type: STRING
    Provider name: destinationArn
    Description: The Amazon Resource Name (ARN) of the CloudWatch Logs log group or Kinesis Data Firehose delivery stream to receive access logs. If you specify a Kinesis Data Firehose delivery stream, the stream name must begin with amazon-apigateway-.
  • format
    Type: STRING
    Provider name: format
    Description: A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.

account_id

Type: STRING

cache_cluster_enabled

Type: BOOLEAN
Provider name: cacheClusterEnabled
Description: Specifies whether a cache cluster is enabled for the stage.

cache_cluster_size

Type: STRING
Provider name: cacheClusterSize
Description: The stage’s cache capacity in GB. For more information about choosing a cache size, see Enabling API caching to enhance responsiveness.

cache_cluster_status

Type: STRING
Provider name: cacheClusterStatus
Description: The status of the cache cluster for the stage, if enabled.

canary_settings

Type: STRUCT
Provider name: canarySettings
Description: Settings for the canary deployment in this stage.

  • deployment_id
    Type: STRING
    Provider name: deploymentId
    Description: The ID of the canary deployment.
  • percent_traffic
    Type: DOUBLE
    Provider name: percentTraffic
    Description: The percent (0-100) of traffic diverted to a canary deployment.
  • stage_variable_overrides
    Type: MAP_STRING_STRING
    Provider name: stageVariableOverrides
    Description: Stage variables overridden for a canary release deployment, including new stage variables introduced in the canary. These stage variables are represented as a string-to-string map between stage variable names and their values.
  • use_stage_cache
    Type: BOOLEAN
    Provider name: useStageCache
    Description: A Boolean flag to indicate whether the canary deployment uses the stage cache or not.

client_certificate_id

Type: STRING
Provider name: clientCertificateId
Description: The identifier of a client certificate for an API stage.

created_date

Type: TIMESTAMP
Provider name: createdDate
Description: The timestamp when the stage was created.

deployment_id

Type: STRING
Provider name: deploymentId
Description: The identifier of the Deployment that the stage points to.

description

Type: STRING
Provider name: description
Description: The stage’s description.

documentation_version

Type: STRING
Provider name: documentationVersion
Description: The version of the associated API documentation.

last_updated_date

Type: TIMESTAMP
Provider name: lastUpdatedDate
Description: The timestamp when the stage last updated.

method_settings

Type: STRING
Provider name: methodSettings
Description: A map that defines the method settings for a Stage resource. Keys (designated as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} for an individual method override, or /*/* for overriding all methods in the stage.

stage_arn

Type: STRING

stage_name

Type: STRING
Provider name: stageName
Description: The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.

tags

Type: UNORDERED_LIST_STRING

tracing_enabled

Type: BOOLEAN
Provider name: tracingEnabled
Description: Specifies whether active tracing with X-ray is enabled for the Stage.

variables

Type: MAP_STRING_STRING
Provider name: variables
Description: A map that defines the stage variables for a Stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

web_acl_arn

Type: STRING
Provider name: webAclArn
Description: The ARN of the WebAcl associated with the Stage.