Stage - Amazon API Gateway (original) (raw)
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
Contents
accessLogSettings
Settings for logging access in this stage.
Type: AccessLogSettings object
Required: No
cacheClusterEnabled
Specifies whether a cache cluster is enabled for the stage. To activate a method-level cache, set CachingEnabled
to true
for a method.
Type: Boolean
Required: No
cacheClusterSize
The stage's cache capacity in GB. For more information about choosing a cache size, see Enabling API caching to enhance responsiveness.
Type: String
Valid Values: 0.5 | 1.6 | 6.1 | 13.5 | 28.4 | 58.2 | 118 | 237
Required: No
cacheClusterStatus
The status of the cache cluster for the stage, if enabled.
Type: String
Valid Values: CREATE_IN_PROGRESS | AVAILABLE | DELETE_IN_PROGRESS | NOT_AVAILABLE | FLUSH_IN_PROGRESS
Required: No
canarySettings
Settings for the canary deployment in this stage.
Type: CanarySettings object
Required: No
clientCertificateId
The identifier of a client certificate for an API stage.
Type: String
Required: No
createdDate
The timestamp when the stage was created.
Type: Timestamp
Required: No
deploymentId
The identifier of the Deployment that the stage points to.
Type: String
Required: No
description
The stage's description.
Type: String
Required: No
documentationVersion
The version of the associated API documentation.
Type: String
Required: No
lastUpdatedDate
The timestamp when the stage last updated.
Type: Timestamp
Required: No
methodSettings
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.
Type: String to MethodSetting object map
Required: No
stageName
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.
Type: String
Required: No
tags
The collection of tags. Each tag element is associated with a given resource.
Type: String to string map
Required: No
tracingEnabled
Specifies whether active tracing with X-ray is enabled for the Stage.
Type: Boolean
Required: No
variables
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-._~:/?#&=,]+
.
Type: String to string map
Required: No
webAclArn
The ARN of the WebAcl associated with the Stage.
Type: String
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.