HttpStageProps

class aws_cdk.aws_apigatewayv2.HttpStageProps(*, auto_deploy=None, domain_mapping=None, throttle=None, stage_name=None, http_api)

Bases: HttpStageOptions

(experimental) Properties to initialize an instance of HttpStage.

Parameters
  • auto_deploy (Optional[bool]) – (experimental) Whether updates to an API automatically trigger a new deployment. Default: false

  • domain_mapping (Union[DomainMappingOptions, Dict[str, Any], None]) – (experimental) The options for custom domain and api mapping. Default: - no custom domain and api mapping configuration

  • throttle (Union[ThrottleSettings, Dict[str, Any], None]) – (experimental) Throttle settings for the routes of this stage. Default: - no throttling configuration

  • stage_name (Optional[str]) – (experimental) The name of the stage. See StageName class for more details. Default: ‘$default’ the default stage of the API. This stage will have the URL at the root of the API endpoint.

  • http_api (IHttpApi) – (experimental) The HTTP API to which this stage is associated.

Stability

experimental

ExampleMetadata

infused

Example:

# api: apigwv2.HttpApi


apigwv2.HttpStage(self, "Stage",
    http_api=api,
    stage_name="beta"
)

Attributes

auto_deploy

(experimental) Whether updates to an API automatically trigger a new deployment.

Default

false

Stability

experimental

domain_mapping

(experimental) The options for custom domain and api mapping.

Default
  • no custom domain and api mapping configuration

Stability

experimental

http_api

(experimental) The HTTP API to which this stage is associated.

Stability

experimental

stage_name

(experimental) The name of the stage.

See StageName class for more details.

Default

‘$default’ the default stage of the API. This stage will have the URL at the root of the API endpoint.

Stability

experimental

throttle

(experimental) Throttle settings for the routes of this stage.

Default
  • no throttling configuration

Stability

experimental