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 (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

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

domain_mapping

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

Default:

no custom domain and api mapping configuration

Stability:

experimental

throttle

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

Default:

no throttling configuration

Stability:

experimental