AWS::ApiGateway::Deployment StageDescription - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::ApiGateway::Deployment StageDescription

StageDescription is a property of the AWS::ApiGateway::Deployment resource that configures a deployment stage.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{ "AccessLogSetting" : AccessLogSetting, "CacheClusterEnabled" : Boolean, "CacheClusterSize" : String, "CacheDataEncrypted" : Boolean, "CacheTtlInSeconds" : Integer, "CachingEnabled" : Boolean, "CanarySetting" : CanarySetting, "ClientCertificateId" : String, "DataTraceEnabled" : Boolean, "Description" : String, "DocumentationVersion" : String, "LoggingLevel" : String, "MethodSettings" : [ MethodSetting, ... ], "MetricsEnabled" : Boolean, "Tags" : [ Tag, ... ], "ThrottlingBurstLimit" : Integer, "ThrottlingRateLimit" : Number, "TracingEnabled" : Boolean, "Variables" : {Key: Value, ...} }

Properties

AccessLogSetting

Specifies settings for logging access in this stage.

Required: No

Type: AccessLogSetting

Update requires: No interruption

CacheClusterEnabled

Specifies whether a cache cluster is enabled for the stage. To activate a method-level cache, set CachingEnabled to true for a method.

Required: No

Type: Boolean

Update requires: No interruption

CacheClusterSize

The size of the stage's cache cluster. For more information, see cacheClusterSize in the API Gateway API Reference.

Required: No

Type: String

Update requires: No interruption

CacheDataEncrypted

Indicates whether the cached responses are encrypted.

Required: No

Type: Boolean

Update requires: No interruption

CacheTtlInSeconds

The time-to-live (TTL) period, in seconds, that specifies how long API Gateway caches responses.

Required: No

Type: Integer

Update requires: No interruption

CachingEnabled

Indicates whether responses are cached and returned for requests. You must enable a cache cluster on the stage to cache responses. For more information, see Enable API Gateway Caching in a Stage to Enhance API Performance in the API Gateway Developer Guide.

Required: No

Type: Boolean

Update requires: No interruption

CanarySetting

Specifies settings for the canary deployment in this stage.

Required: No

Type: CanarySetting

Update requires: No interruption

ClientCertificateId

The identifier of the client certificate that API Gateway uses to call your integration endpoints in the stage.

Required: No

Type: String

Update requires: No interruption

DataTraceEnabled

Indicates whether data trace logging is enabled for methods in the stage. API Gateway pushes these logs to Amazon CloudWatch Logs.

Required: No

Type: Boolean

Update requires: No interruption

Description

A description of the purpose of the stage.

Required: No

Type: String

Update requires: No interruption

DocumentationVersion

The version identifier of the API documentation snapshot.

Required: No

Type: String

Update requires: No interruption

LoggingLevel

The logging level for this method. For valid values, see the loggingLevel property of the MethodSetting resource in the Amazon API Gateway API Reference.

Required: No

Type: String

Update requires: No interruption

MethodSettings

Configures settings for all of the stage's methods.

Required: No

Type: Array of MethodSetting

Update requires: No interruption

MetricsEnabled

Indicates whether Amazon CloudWatch metrics are enabled for methods in the stage.

Required: No

Type: Boolean

Update requires: No interruption

Tags

An array of arbitrary tags (key-value pairs) to associate with the stage.

Required: No

Type: Array of Tag

Update requires: No interruption

ThrottlingBurstLimit

The target request burst rate limit. This allows more requests through for a period of time than the target rate limit. For more information, see Manage API Request Throttling in the API Gateway Developer Guide.

Required: No

Type: Integer

Update requires: No interruption

ThrottlingRateLimit

The target request steady-state rate limit. For more information, see Manage API Request Throttling in the API Gateway Developer Guide.

Required: No

Type: Number

Update requires: No interruption

TracingEnabled

Specifies whether active tracing with X-ray is enabled for this stage.

For more information, see Trace API Gateway API Execution with Amazon X-Ray in the API Gateway Developer Guide.

Required: No

Type: Boolean

Update requires: No interruption

Variables

A map that defines the stage variables. Variable names must consist of alphanumeric characters, and the values must match the following regular expression: [A-Za-z0-9-._~:/?#&=,]+.

Required: No

Type: Object of String

Pattern: [a-zA-Z0-9]+

Update requires: No interruption

See also

  • Stage in the Amazon API Gateway REST API Reference