| Copyright | (c) 2013-2021 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
Amazonka.APIGateway.GetStage
Description
Gets information about a Stage resource.
Synopsis
- data GetStage = GetStage' {}
- newGetStage :: Text -> Text -> GetStage
- getStage_restApiId :: Lens' GetStage Text
- getStage_stageName :: Lens' GetStage Text
- data Stage = Stage' {
- deploymentId :: Maybe Text
- variables :: Maybe (HashMap Text Text)
- accessLogSettings :: Maybe AccessLogSettings
- documentationVersion :: Maybe Text
- clientCertificateId :: Maybe Text
- tracingEnabled :: Maybe Bool
- createdDate :: Maybe POSIX
- cacheClusterStatus :: Maybe CacheClusterStatus
- methodSettings :: Maybe (HashMap Text MethodSetting)
- lastUpdatedDate :: Maybe POSIX
- cacheClusterSize :: Maybe CacheClusterSize
- webAclArn :: Maybe Text
- canarySettings :: Maybe CanarySettings
- cacheClusterEnabled :: Maybe Bool
- stageName :: Maybe Text
- description :: Maybe Text
- tags :: Maybe (HashMap Text Text)
- newStage :: Stage
- stage_deploymentId :: Lens' Stage (Maybe Text)
- stage_variables :: Lens' Stage (Maybe (HashMap Text Text))
- stage_accessLogSettings :: Lens' Stage (Maybe AccessLogSettings)
- stage_documentationVersion :: Lens' Stage (Maybe Text)
- stage_clientCertificateId :: Lens' Stage (Maybe Text)
- stage_tracingEnabled :: Lens' Stage (Maybe Bool)
- stage_createdDate :: Lens' Stage (Maybe UTCTime)
- stage_cacheClusterStatus :: Lens' Stage (Maybe CacheClusterStatus)
- stage_methodSettings :: Lens' Stage (Maybe (HashMap Text MethodSetting))
- stage_lastUpdatedDate :: Lens' Stage (Maybe UTCTime)
- stage_cacheClusterSize :: Lens' Stage (Maybe CacheClusterSize)
- stage_webAclArn :: Lens' Stage (Maybe Text)
- stage_canarySettings :: Lens' Stage (Maybe CanarySettings)
- stage_cacheClusterEnabled :: Lens' Stage (Maybe Bool)
- stage_stageName :: Lens' Stage (Maybe Text)
- stage_description :: Lens' Stage (Maybe Text)
- stage_tags :: Lens' Stage (Maybe (HashMap Text Text))
Creating a Request
Requests API Gateway to get information about a Stage resource.
See: newGetStage smart constructor.
Constructors
| GetStage' | |
Instances
Create a value of GetStage with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:restApiId:GetStage', getStage_restApiId - [Required] The string identifier of the associated RestApi.
$sel:stageName:GetStage', getStage_stageName - [Required] The name of the Stage resource to get information about.
Request Lenses
getStage_restApiId :: Lens' GetStage Text Source #
- Required
- The string identifier of the associated RestApi.
getStage_stageName :: Lens' GetStage Text Source #
- Required
- The name of the Stage resource to get information about.
Destructuring the Response
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
See: newStage smart constructor.
Constructors
| Stage' | |
Fields
| |
Instances
Create a value of Stage with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:deploymentId:Stage', stage_deploymentId - The identifier of the Deployment that the stage points to.
$sel:variables:Stage', stage_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-._~:/?#&=,]+.
$sel:accessLogSettings:Stage', stage_accessLogSettings - Settings for logging access in this stage.
$sel:documentationVersion:Stage', stage_documentationVersion - The version of the associated API documentation.
$sel:clientCertificateId:Stage', stage_clientCertificateId - The identifier of a client certificate for an API stage.
$sel:tracingEnabled:Stage', stage_tracingEnabled - Specifies whether active tracing with X-ray is enabled for the Stage.
$sel:createdDate:Stage', stage_createdDate - The timestamp when the stage was created.
$sel:cacheClusterStatus:Stage', stage_cacheClusterStatus - The status of the cache cluster for the stage, if enabled.
$sel:methodSettings:Stage', stage_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.
$sel:lastUpdatedDate:Stage', stage_lastUpdatedDate - The timestamp when the stage last updated.
$sel:cacheClusterSize:Stage', stage_cacheClusterSize - The size of the cache cluster for the stage, if enabled.
$sel:webAclArn:Stage', stage_webAclArn - The ARN of the WebAcl associated with the Stage.
$sel:canarySettings:Stage', stage_canarySettings - Settings for the canary deployment in this stage.
$sel:cacheClusterEnabled:Stage', stage_cacheClusterEnabled - Specifies whether a cache cluster is enabled for the stage.
$sel:stageName:Stage', stage_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.
$sel:description:Stage', stage_description - The stage's description.
$sel:tags:Stage', stage_tags - The collection of tags. Each tag element is associated with a given
resource.
Response Lenses
stage_deploymentId :: Lens' Stage (Maybe Text) Source #
The identifier of the Deployment that the stage points to.
stage_variables :: Lens' Stage (Maybe (HashMap Text Text)) Source #
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-._~:/?#&=,]+.
stage_accessLogSettings :: Lens' Stage (Maybe AccessLogSettings) Source #
Settings for logging access in this stage.
stage_documentationVersion :: Lens' Stage (Maybe Text) Source #
The version of the associated API documentation.
stage_clientCertificateId :: Lens' Stage (Maybe Text) Source #
The identifier of a client certificate for an API stage.
stage_tracingEnabled :: Lens' Stage (Maybe Bool) Source #
Specifies whether active tracing with X-ray is enabled for the Stage.
stage_cacheClusterStatus :: Lens' Stage (Maybe CacheClusterStatus) Source #
The status of the cache cluster for the stage, if enabled.
stage_methodSettings :: Lens' Stage (Maybe (HashMap Text MethodSetting)) Source #
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_lastUpdatedDate :: Lens' Stage (Maybe UTCTime) Source #
The timestamp when the stage last updated.
stage_cacheClusterSize :: Lens' Stage (Maybe CacheClusterSize) Source #
The size of the cache cluster for the stage, if enabled.
stage_webAclArn :: Lens' Stage (Maybe Text) Source #
The ARN of the WebAcl associated with the Stage.
stage_canarySettings :: Lens' Stage (Maybe CanarySettings) Source #
Settings for the canary deployment in this stage.
stage_cacheClusterEnabled :: Lens' Stage (Maybe Bool) Source #
Specifies whether a cache cluster is enabled for the stage.