Type object
Schema URL https://catalog.lintel.tools/schemas/schemastore/serverless-framework-configuration/_shared/latest--aws-apigateway-deployment.json
Parent schema serverless-framework-configuration
Type: object

Resource Type definition for AWS::ApiGateway::Deployment. Source:- https://github.com/aws-cloudformation/aws-cloudformation-resource-providers-apigateway

Properties

RestApiId string | Aws_CF_FunctionString required

The ID of the RestApi resource to deploy.

DeploymentCanarySettings object
3 nested properties
PercentTraffic number

The percentage (0-100) of traffic diverted to a canary deployment.

StageVariableOverrides object

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. Duplicates are not allowed.

UseStageCache boolean

Whether the canary deployment uses the stage cache.

Description string | Aws_CF_FunctionString

A description of the purpose of the API Gateway deployment.

StageDescription object
19 nested properties
AccessLogSetting object
2 nested properties
DestinationArn string | Aws_CF_FunctionString

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 string | Aws_CF_FunctionString

A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.

CacheClusterEnabled boolean

Indicates whether cache clustering is enabled for the stage.

CacheClusterSize string | Aws_CF_FunctionString

The size of the stage's cache cluster.

CacheDataEncrypted boolean

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

CacheTtlInSeconds integer

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

CachingEnabled boolean

Indicates whether responses are cached and returned for requests. You must enable a cache cluster on the stage to cache responses.

CanarySetting object
3 nested properties
PercentTraffic number

The percent (0-100) of traffic diverted to a canary deployment.

StageVariableOverrides object

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.

UseStageCache boolean

Whether the canary deployment uses the stage cache or not.

ClientCertificateId string | Aws_CF_FunctionString

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

DataTraceEnabled boolean

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

Description string | Aws_CF_FunctionString

A description of the purpose of the stage.

DocumentationVersion string | Aws_CF_FunctionString

The version identifier of the API documentation snapshot.

LoggingLevel string | Aws_CF_FunctionString

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

MethodSettings MethodSetting[]

Configures settings for all of the stage's methods.

uniqueItems=true
MetricsEnabled boolean

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

Tags Tag[]

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

ThrottlingBurstLimit integer

The number of burst requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.

ThrottlingRateLimit number

The number of steady-state requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.

TracingEnabled boolean

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

Variables object

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-._~:/?#&=,]+.

StageName string | Aws_CF_FunctionString

A name for the stage that API Gateway creates with this deployment. Use only alphanumeric characters.

Definitions

StageDescription object
AccessLogSetting object
2 nested properties
DestinationArn string | Aws_CF_FunctionString

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 string | Aws_CF_FunctionString

A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.

CacheClusterEnabled boolean

Indicates whether cache clustering is enabled for the stage.

CacheClusterSize string | Aws_CF_FunctionString

The size of the stage's cache cluster.

CacheDataEncrypted boolean

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

CacheTtlInSeconds integer

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

CachingEnabled boolean

Indicates whether responses are cached and returned for requests. You must enable a cache cluster on the stage to cache responses.

CanarySetting object
3 nested properties
PercentTraffic number

The percent (0-100) of traffic diverted to a canary deployment.

StageVariableOverrides object

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.

UseStageCache boolean

Whether the canary deployment uses the stage cache or not.

ClientCertificateId string | Aws_CF_FunctionString

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

DataTraceEnabled boolean

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

Description string | Aws_CF_FunctionString

A description of the purpose of the stage.

DocumentationVersion string | Aws_CF_FunctionString

The version identifier of the API documentation snapshot.

LoggingLevel string | Aws_CF_FunctionString

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

MethodSettings MethodSetting[]

Configures settings for all of the stage's methods.

uniqueItems=true
MetricsEnabled boolean

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

Tags Tag[]

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

ThrottlingBurstLimit integer

The number of burst requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.

ThrottlingRateLimit number

The number of steady-state requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.

TracingEnabled boolean

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

Variables object

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-._~:/?#&=,]+.

DeploymentCanarySettings object
PercentTraffic number

The percentage (0-100) of traffic diverted to a canary deployment.

StageVariableOverrides object

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. Duplicates are not allowed.

UseStageCache boolean

Whether the canary deployment uses the stage cache.

AccessLogSetting object
DestinationArn string | Aws_CF_FunctionString

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 string | Aws_CF_FunctionString

A single line format of the access logs of data, as specified by selected $context variables. The format must include at least $context.requestId.

CanarySetting object
PercentTraffic number

The percent (0-100) of traffic diverted to a canary deployment.

StageVariableOverrides object

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.

UseStageCache boolean

Whether the canary deployment uses the stage cache or not.

Tag object
Key string | Aws_CF_FunctionString required

The key name of the tag

Value string | Aws_CF_FunctionString required

The value for the tag

MethodSetting object
CacheDataEncrypted boolean

Indicates whether the cached responses are encrypted

CacheTtlInSeconds integer

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

CachingEnabled boolean

Indicates whether responses are cached and returned for requests. You must enable a cache cluster on the stage to cache responses.

DataTraceEnabled boolean

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

HttpMethod string | Aws_CF_FunctionString

The HTTP method.

LoggingLevel string | Aws_CF_FunctionString

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

MetricsEnabled boolean

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

ResourcePath string | Aws_CF_FunctionString

The resource path for this method. Forward slashes (/) are encoded as ~1 and the initial slash must include a forward slash.

ThrottlingBurstLimit integer

The number of burst requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.

ThrottlingRateLimit number

The number of steady-state requests per second that API Gateway permits across all APIs, stages, and methods in your AWS account.