StageOptions

class aws_cdk.aws_apigatewayv2.StageOptions(*, auto_deploy=None, domain_mapping=None, throttle=None)

Bases: object

(experimental) Options required to create a new stage.

Options that are common between HTTP and Websocket APIs.

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

  • domain_mapping (Optional[DomainMappingOptions]) – (experimental) The options for custom domain and api mapping. Default: - no custom domain and api mapping configuration

  • throttle (Optional[ThrottleSettings]) – (experimental) Throttle settings for the routes of this stage. Default: - no throttling configuration

Stability

experimental

ExampleMetadata

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_apigatewayv2 as apigatewayv2

# domain_name: apigatewayv2.DomainName

stage_options = apigatewayv2.StageOptions(
    auto_deploy=False,
    domain_mapping=apigatewayv2.DomainMappingOptions(
        domain_name=domain_name,

        # the properties below are optional
        mapping_key="mappingKey"
    ),
    throttle=apigatewayv2.ThrottleSettings(
        burst_limit=123,
        rate_limit=123
    )
)

Attributes

auto_deploy

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

Default

false

Stability

experimental

Return type

Optional[bool]

domain_mapping

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

Default
  • no custom domain and api mapping configuration

Stability

experimental

Return type

Optional[DomainMappingOptions]

throttle

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

Default
  • no throttling configuration

Stability

experimental

Return type

Optional[ThrottleSettings]