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.ApiGatewayV2.UpdateStage

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Updates a Stage.

Synopsis

data UpdateStage = UpdateStage' {
- deploymentId :: Maybe Text
- routeSettings :: Maybe (HashMap Text RouteSettings)
- accessLogSettings :: Maybe AccessLogSettings
- clientCertificateId :: Maybe Text
- stageVariables :: Maybe (HashMap Text Text)
- autoDeploy :: Maybe Bool
- defaultRouteSettings :: Maybe RouteSettings
- description :: Maybe Text
- stageName :: Text
- apiId :: Text
}
newUpdateStage :: Text -> Text -> UpdateStage
updateStage_deploymentId :: Lens' UpdateStage (Maybe Text)
updateStage_routeSettings :: Lens' UpdateStage (Maybe (HashMap Text RouteSettings))
updateStage_accessLogSettings :: Lens' UpdateStage (Maybe AccessLogSettings)
updateStage_clientCertificateId :: Lens' UpdateStage (Maybe Text)
updateStage_stageVariables :: Lens' UpdateStage (Maybe (HashMap Text Text))
updateStage_autoDeploy :: Lens' UpdateStage (Maybe Bool)
updateStage_defaultRouteSettings :: Lens' UpdateStage (Maybe RouteSettings)
updateStage_description :: Lens' UpdateStage (Maybe Text)
updateStage_stageName :: Lens' UpdateStage Text
updateStage_apiId :: Lens' UpdateStage Text
data UpdateStageResponse = UpdateStageResponse' {
- lastDeploymentStatusMessage :: Maybe Text
- deploymentId :: Maybe Text
- routeSettings :: Maybe (HashMap Text RouteSettings)
- accessLogSettings :: Maybe AccessLogSettings
- clientCertificateId :: Maybe Text
- stageVariables :: Maybe (HashMap Text Text)
- autoDeploy :: Maybe Bool
- createdDate :: Maybe POSIX
- defaultRouteSettings :: Maybe RouteSettings
- apiGatewayManaged :: Maybe Bool
- stageName :: Maybe Text
- lastUpdatedDate :: Maybe POSIX
- description :: Maybe Text
- tags :: Maybe (HashMap Text Text)
- httpStatus :: Int
}
newUpdateStageResponse :: Int -> UpdateStageResponse
updateStageResponse_lastDeploymentStatusMessage :: Lens' UpdateStageResponse (Maybe Text)
updateStageResponse_deploymentId :: Lens' UpdateStageResponse (Maybe Text)
updateStageResponse_routeSettings :: Lens' UpdateStageResponse (Maybe (HashMap Text RouteSettings))
updateStageResponse_accessLogSettings :: Lens' UpdateStageResponse (Maybe AccessLogSettings)
updateStageResponse_clientCertificateId :: Lens' UpdateStageResponse (Maybe Text)
updateStageResponse_stageVariables :: Lens' UpdateStageResponse (Maybe (HashMap Text Text))
updateStageResponse_autoDeploy :: Lens' UpdateStageResponse (Maybe Bool)
updateStageResponse_createdDate :: Lens' UpdateStageResponse (Maybe UTCTime)
updateStageResponse_defaultRouteSettings :: Lens' UpdateStageResponse (Maybe RouteSettings)
updateStageResponse_apiGatewayManaged :: Lens' UpdateStageResponse (Maybe Bool)
updateStageResponse_stageName :: Lens' UpdateStageResponse (Maybe Text)
updateStageResponse_lastUpdatedDate :: Lens' UpdateStageResponse (Maybe UTCTime)
updateStageResponse_description :: Lens' UpdateStageResponse (Maybe Text)
updateStageResponse_tags :: Lens' UpdateStageResponse (Maybe (HashMap Text Text))
updateStageResponse_httpStatus :: Lens' UpdateStageResponse Int

Creating a Request

data UpdateStage Source #

Updates a Stage.

See: newUpdateStage smart constructor.

Constructors

UpdateStage'

Fields

deploymentId :: Maybe Text
The deployment identifier for the API stage. Can't be updated if autoDeploy is enabled.
routeSettings :: Maybe (HashMap Text RouteSettings)
Route settings for the stage.
accessLogSettings :: Maybe AccessLogSettings
Settings for logging access in this stage.
clientCertificateId :: Maybe Text
The identifier of a client certificate for a Stage.
stageVariables :: Maybe (HashMap Text Text)
A map that defines the stage variables for a Stage. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.
autoDeploy :: Maybe Bool
Specifies whether updates to an API automatically trigger a new deployment. The default value is false.
defaultRouteSettings :: Maybe RouteSettings
The default route settings for the stage.
description :: Maybe Text
The description for the API stage.
stageName :: Text
The stage name. Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default. Maximum length is 128 characters.
apiId :: Text
The API identifier.

Instances

Instances details

Eq UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods (==) :: UpdateStage -> UpdateStage -> Bool # (/=) :: UpdateStage -> UpdateStage -> Bool #
Read UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods readsPrec :: Int -> ReadS UpdateStage # readList :: ReadS [UpdateStage] # readPrec :: ReadPrec UpdateStage # readListPrec :: ReadPrec [UpdateStage] #
Show UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods showsPrec :: Int -> UpdateStage -> ShowS # show :: UpdateStage -> String # showList :: [UpdateStage] -> ShowS #
Generic UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Associated Types type Rep UpdateStage :: Type -> Type # Methods from :: UpdateStage -> Rep UpdateStage x # to :: Rep UpdateStage x -> UpdateStage #
NFData UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods rnf :: UpdateStage -> () #
Hashable UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods hashWithSalt :: Int -> UpdateStage -> Int # hash :: UpdateStage -> Int #
ToJSON UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods toJSON :: UpdateStage -> Value # toEncoding :: UpdateStage -> Encoding # toJSONList :: [UpdateStage] -> Value # toEncodingList :: [UpdateStage] -> Encoding #
AWSRequest UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Associated Types type AWSResponse UpdateStage # Methods request :: UpdateStage -> Request UpdateStage # response :: MonadResource m => Logger -> Service -> Proxy UpdateStage -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse UpdateStage))) #
ToHeaders UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods toHeaders :: UpdateStage -> [Header] #
ToPath UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods toPath :: UpdateStage -> ByteString #
ToQuery UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods toQuery :: UpdateStage -> QueryString #
type Rep UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage type Rep UpdateStage = D1 ('MetaData "UpdateStage" "Amazonka.ApiGatewayV2.UpdateStage" "libZSservicesZSamazonka-apigatewayv2ZSamazonka-apigatewayv2" 'False) (C1 ('MetaCons "UpdateStage'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "deploymentId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "routeSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text RouteSettings)))) :: (S1 ('MetaSel ('Just "accessLogSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AccessLogSettings)) :: (S1 ('MetaSel ('Just "clientCertificateId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "stageVariables") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text)))))) :: ((S1 ('MetaSel ('Just "autoDeploy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "defaultRouteSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RouteSettings))) :: (S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "stageName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "apiId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))))
type AWSResponse UpdateStage Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage type AWSResponse UpdateStage = UpdateStageResponse

newUpdateStage Source #

Arguments

:: Text	`$sel:stageName:UpdateStage'`
-> Text	`$sel:apiId:UpdateStage'`
-> UpdateStage

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:deploymentId:UpdateStage', updateStage_deploymentId - The deployment identifier for the API stage. Can't be updated if autoDeploy is enabled.

$sel:routeSettings:UpdateStage', updateStage_routeSettings - Route settings for the stage.

$sel:accessLogSettings:UpdateStage', updateStage_accessLogSettings - Settings for logging access in this stage.

$sel:clientCertificateId:UpdateStage', updateStage_clientCertificateId - The identifier of a client certificate for a Stage.

$sel:stageVariables:UpdateStage', updateStage_stageVariables - A map that defines the stage variables for a Stage. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

$sel:autoDeploy:UpdateStage', updateStage_autoDeploy - Specifies whether updates to an API automatically trigger a new deployment. The default value is false.

$sel:defaultRouteSettings:UpdateStage', updateStage_defaultRouteSettings - The default route settings for the stage.

$sel:description:UpdateStage', updateStage_description - The description for the API stage.

$sel:stageName:UpdateStage', updateStage_stageName - The stage name. Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default. Maximum length is 128 characters.

$sel:apiId:UpdateStage', updateStage_apiId - The API identifier.

Request Lenses

updateStage_deploymentId :: Lens' UpdateStage (Maybe Text) Source #

The deployment identifier for the API stage. Can't be updated if autoDeploy is enabled.

updateStage_routeSettings :: Lens' UpdateStage (Maybe (HashMap Text RouteSettings)) Source #

Route settings for the stage.

updateStage_accessLogSettings :: Lens' UpdateStage (Maybe AccessLogSettings) Source #

Settings for logging access in this stage.

updateStage_clientCertificateId :: Lens' UpdateStage (Maybe Text) Source #

The identifier of a client certificate for a Stage.

updateStage_stageVariables :: Lens' UpdateStage (Maybe (HashMap Text Text)) Source #

A map that defines the stage variables for a Stage. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

updateStage_autoDeploy :: Lens' UpdateStage (Maybe Bool) Source #

Specifies whether updates to an API automatically trigger a new deployment. The default value is false.

updateStage_defaultRouteSettings :: Lens' UpdateStage (Maybe RouteSettings) Source #

The default route settings for the stage.

updateStage_description :: Lens' UpdateStage (Maybe Text) Source #

The description for the API stage.

updateStage_stageName :: Lens' UpdateStage Text Source #

The stage name. Stage names can contain only alphanumeric characters, hyphens, and underscores, or be $default. Maximum length is 128 characters.

updateStage_apiId :: Lens' UpdateStage Text Source #

The API identifier.

Destructuring the Response

data UpdateStageResponse Source #

See: newUpdateStageResponse smart constructor.

Constructors

UpdateStageResponse'

Fields

lastDeploymentStatusMessage :: Maybe Text
Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled.
deploymentId :: Maybe Text
The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled.
routeSettings :: Maybe (HashMap Text RouteSettings)
Route settings for the stage, by routeKey.
accessLogSettings :: Maybe AccessLogSettings
Settings for logging access in this stage.
clientCertificateId :: Maybe Text
The identifier of a client certificate for a Stage. Supported only for WebSocket APIs.
stageVariables :: Maybe (HashMap Text Text)
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-._~:/?#&=,]+.
autoDeploy :: Maybe Bool
Specifies whether updates to an API automatically trigger a new deployment. The default value is false.
createdDate :: Maybe POSIX
The timestamp when the stage was created.
defaultRouteSettings :: Maybe RouteSettings
Default route settings for the stage.
apiGatewayManaged :: Maybe Bool
Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can't modify the $default stage.
stageName :: Maybe Text
The name of the stage.
lastUpdatedDate :: Maybe POSIX
The timestamp when the stage was last updated.
description :: Maybe Text
The description of the stage.
tags :: Maybe (HashMap Text Text)
The collection of tags. Each tag element is associated with a given resource.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Eq UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods (==) :: UpdateStageResponse -> UpdateStageResponse -> Bool # (/=) :: UpdateStageResponse -> UpdateStageResponse -> Bool #
Read UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods readsPrec :: Int -> ReadS UpdateStageResponse # readList :: ReadS [UpdateStageResponse] # readPrec :: ReadPrec UpdateStageResponse # readListPrec :: ReadPrec [UpdateStageResponse] #
Show UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods showsPrec :: Int -> UpdateStageResponse -> ShowS # show :: UpdateStageResponse -> String # showList :: [UpdateStageResponse] -> ShowS #
Generic UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Associated Types type Rep UpdateStageResponse :: Type -> Type # Methods from :: UpdateStageResponse -> Rep UpdateStageResponse x # to :: Rep UpdateStageResponse x -> UpdateStageResponse #
NFData UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage Methods rnf :: UpdateStageResponse -> () #
type Rep UpdateStageResponse Source #
Instance details Defined in Amazonka.ApiGatewayV2.UpdateStage type Rep UpdateStageResponse = D1 ('MetaData "UpdateStageResponse" "Amazonka.ApiGatewayV2.UpdateStage" "libZSservicesZSamazonka-apigatewayv2ZSamazonka-apigatewayv2" 'False) (C1 ('MetaCons "UpdateStageResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "lastDeploymentStatusMessage") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "deploymentId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "routeSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text RouteSettings))))) :: ((S1 ('MetaSel ('Just "accessLogSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AccessLogSettings)) :: S1 ('MetaSel ('Just "clientCertificateId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "stageVariables") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :: S1 ('MetaSel ('Just "autoDeploy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))))) :: (((S1 ('MetaSel ('Just "createdDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :: S1 ('MetaSel ('Just "defaultRouteSettings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RouteSettings))) :: (S1 ('MetaSel ('Just "apiGatewayManaged") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "stageName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :: ((S1 ('MetaSel ('Just "lastUpdatedDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :: S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text))) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))))

newUpdateStageResponse Source #

Arguments

:: Int	`$sel:httpStatus:UpdateStageResponse'`
-> UpdateStageResponse

Create a value of UpdateStageResponse 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:lastDeploymentStatusMessage:UpdateStageResponse', updateStageResponse_lastDeploymentStatusMessage - Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled.

$sel:deploymentId:UpdateStage', updateStageResponse_deploymentId - The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled.

$sel:routeSettings:UpdateStage', updateStageResponse_routeSettings - Route settings for the stage, by routeKey.

$sel:accessLogSettings:UpdateStage', updateStageResponse_accessLogSettings - Settings for logging access in this stage.

$sel:clientCertificateId:UpdateStage', updateStageResponse_clientCertificateId - The identifier of a client certificate for a Stage. Supported only for WebSocket APIs.

$sel:stageVariables:UpdateStage', updateStageResponse_stageVariables - 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:autoDeploy:UpdateStage', updateStageResponse_autoDeploy - Specifies whether updates to an API automatically trigger a new deployment. The default value is false.

$sel:createdDate:UpdateStageResponse', updateStageResponse_createdDate - The timestamp when the stage was created.

$sel:defaultRouteSettings:UpdateStage', updateStageResponse_defaultRouteSettings - Default route settings for the stage.

$sel:apiGatewayManaged:UpdateStageResponse', updateStageResponse_apiGatewayManaged - Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can't modify the $default stage.

$sel:stageName:UpdateStage', updateStageResponse_stageName - The name of the stage.

$sel:lastUpdatedDate:UpdateStageResponse', updateStageResponse_lastUpdatedDate - The timestamp when the stage was last updated.

$sel:description:UpdateStage', updateStageResponse_description - The description of the stage.

$sel:tags:UpdateStageResponse', updateStageResponse_tags - The collection of tags. Each tag element is associated with a given resource.

$sel:httpStatus:UpdateStageResponse', updateStageResponse_httpStatus - The response's http status code.

Response Lenses

updateStageResponse_lastDeploymentStatusMessage :: Lens' UpdateStageResponse (Maybe Text) Source #

Describes the status of the last deployment of a stage. Supported only for stages with autoDeploy enabled.

updateStageResponse_deploymentId :: Lens' UpdateStageResponse (Maybe Text) Source #

The identifier of the Deployment that the Stage is associated with. Can't be updated if autoDeploy is enabled.

updateStageResponse_routeSettings :: Lens' UpdateStageResponse (Maybe (HashMap Text RouteSettings)) Source #

Route settings for the stage, by routeKey.

updateStageResponse_accessLogSettings :: Lens' UpdateStageResponse (Maybe AccessLogSettings) Source #

Settings for logging access in this stage.

updateStageResponse_clientCertificateId :: Lens' UpdateStageResponse (Maybe Text) Source #

The identifier of a client certificate for a Stage. Supported only for WebSocket APIs.

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

updateStageResponse_autoDeploy :: Lens' UpdateStageResponse (Maybe Bool) Source #

Specifies whether updates to an API automatically trigger a new deployment. The default value is false.

updateStageResponse_createdDate :: Lens' UpdateStageResponse (Maybe UTCTime) Source #

The timestamp when the stage was created.

updateStageResponse_defaultRouteSettings :: Lens' UpdateStageResponse (Maybe RouteSettings) Source #

Default route settings for the stage.

updateStageResponse_apiGatewayManaged :: Lens' UpdateStageResponse (Maybe Bool) Source #

Specifies whether a stage is managed by API Gateway. If you created an API using quick create, the $default stage is managed by API Gateway. You can't modify the $default stage.

updateStageResponse_stageName :: Lens' UpdateStageResponse (Maybe Text) Source #

The name of the stage.

updateStageResponse_lastUpdatedDate :: Lens' UpdateStageResponse (Maybe UTCTime) Source #

The timestamp when the stage was last updated.

updateStageResponse_description :: Lens' UpdateStageResponse (Maybe Text) Source #

The description of the stage.

updateStageResponse_tags :: Lens' UpdateStageResponse (Maybe (HashMap Text Text)) Source #

The collection of tags. Each tag element is associated with a given resource.

updateStageResponse_httpStatus :: Lens' UpdateStageResponse Int Source #

The response's http status code.