| 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.UpdateStage
Description
Changes information about a Stage resource.
Synopsis
- data UpdateStage = UpdateStage' {
- patchOperations :: Maybe [PatchOperation]
- restApiId :: Text
- stageName :: Text
- newUpdateStage :: Text -> Text -> UpdateStage
- updateStage_patchOperations :: Lens' UpdateStage (Maybe [PatchOperation])
- updateStage_restApiId :: Lens' UpdateStage Text
- updateStage_stageName :: Lens' UpdateStage 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
data UpdateStage Source #
Requests API Gateway to change information about a Stage resource.
See: newUpdateStage smart constructor.
Constructors
| UpdateStage' | |
Fields
| |
Instances
Create a value of UpdateStage 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:patchOperations:UpdateStage', updateStage_patchOperations - A list of update operations to be applied to the specified resource and
in the order specified in this list.
$sel:restApiId:UpdateStage', updateStage_restApiId - [Required] The string identifier of the associated RestApi.
$sel:stageName:UpdateStage', updateStage_stageName - [Required] The name of the Stage resource to change information about.
Request Lenses
updateStage_patchOperations :: Lens' UpdateStage (Maybe [PatchOperation]) Source #
A list of update operations to be applied to the specified resource and in the order specified in this list.
updateStage_restApiId :: Lens' UpdateStage Text Source #
- Required
- The string identifier of the associated RestApi.
updateStage_stageName :: Lens' UpdateStage Text Source #
- Required
- The name of the Stage resource to change 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.