Package software.amazon.awscdk.services.apigatewayv2

Interface StageOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

HttpStageOptions, HttpStageProps, WebSocketStageProps

All Known Implementing Classes:

HttpStageOptions.Jsii$Proxy, HttpStageProps.Jsii$Proxy, StageOptions.Jsii$Proxy, WebSocketStageProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.104.0 (build e79254c)",
           date="2024-11-06T23:25:03.716Z")
@Stability(Stable)
public interface StageOptions
extends software.amazon.jsii.JsiiSerializable

Options required to create a new stage.

Options that are common between HTTP and Websocket APIs.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.apigatewayv2.*;
 DomainName domainName;
 StageOptions stageOptions = StageOptions.builder()
         .autoDeploy(false)
         .description("description")
         .domainMapping(DomainMappingOptions.builder()
                 .domainName(domainName)
                 // the properties below are optional
                 .mappingKey("mappingKey")
                 .build())
         .throttle(ThrottleSettings.builder()
                 .burstLimit(123)
                 .rateLimit(123)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	StageOptions.Builder	A builder for StageOptions
static final class	StageOptions.Jsii$Proxy	An implementation for StageOptions

Method Summary

Modifier and Type	Method	Description
static StageOptions.Builder	builder()
default Boolean	getAutoDeploy()	Whether updates to an API automatically trigger a new deployment.
default String	getDescription()	The description for the API stage.
default DomainMappingOptions	getDomainMapping()	The options for custom domain and api mapping.
default ThrottleSettings	getThrottle()	Throttle settings for the routes of this stage.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAutoDeploy

@Stability(Stable)
@Nullable
default Boolean getAutoDeploy()

Whether updates to an API automatically trigger a new deployment.

Default: false

getDescription

@Stability(Stable)
@Nullable
default String getDescription()

The description for the API stage.

Default: - no description

getDomainMapping

@Stability(Stable)
@Nullable
default DomainMappingOptions getDomainMapping()

The options for custom domain and api mapping.

Default: - no custom domain and api mapping configuration

getThrottle

@Stability(Stable)
@Nullable
default ThrottleSettings getThrottle()

Throttle settings for the routes of this stage.

Default: - no throttling configuration

builder

@Stability(Stable)
static StageOptions.Builder builder()

Returns:

a StageOptions.Builder of StageOptions