software.amazon.awscdk.services.apigateway

Class Stage.Builder

java.lang.Object

software.amazon.awscdk.services.apigateway.Stage.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<Stage>

Enclosing class:

Stage

@Stability(value=Experimental)
public static final class Stage.Builder
extends Object
implements software.amazon.jsii.Builder<Stage>

(experimental) A fluent builder for Stage.

Method Summary

Modifier and Type	Method and Description
Stage.Builder	accessLogDestination(IAccessLogDestination accessLogDestination) (experimental) The CloudWatch Logs log group.
Stage.Builder	accessLogFormat(AccessLogFormat accessLogFormat) (experimental) A single line format of access logs of data, as specified by selected $content variables.
Stage	build()
Stage.Builder	cacheClusterEnabled(Boolean cacheClusterEnabled) (experimental) Indicates whether cache clustering is enabled for the stage.
Stage.Builder	cacheClusterSize(String cacheClusterSize) (experimental) The stage's cache cluster size.
Stage.Builder	cacheDataEncrypted(Boolean cacheDataEncrypted) (experimental) Indicates whether the cached responses are encrypted.
Stage.Builder	cacheTtl(Duration cacheTtl) (experimental) Specifies the time to live (TTL), in seconds, for cached responses.
Stage.Builder	cachingEnabled(Boolean cachingEnabled) (experimental) Specifies whether responses should be cached and returned for requests.
Stage.Builder	clientCertificateId(String clientCertificateId) (experimental) The identifier of the client certificate that API Gateway uses to call your integration endpoints in the stage.
static Stage.Builder	create(software.constructs.Construct scope, String id)
Stage.Builder	dataTraceEnabled(Boolean dataTraceEnabled) (experimental) Specifies whether data trace logging is enabled for this method, which effects the log entries pushed to Amazon CloudWatch Logs.
Stage.Builder	deployment(Deployment deployment) (experimental) The deployment that this stage points to [disable-awslint:ref-via-interface].
Stage.Builder	description(String description) (experimental) A description of the purpose of the stage.
Stage.Builder	documentationVersion(String documentationVersion) (experimental) The version identifier of the API documentation snapshot.
Stage.Builder	loggingLevel(MethodLoggingLevel loggingLevel) (experimental) Specifies the logging level for this method, which effects the log entries pushed to Amazon CloudWatch Logs.
Stage.Builder	methodOptions(Map<String,? extends MethodDeploymentOptions> methodOptions) (experimental) Method deployment options for specific resources/methods.
Stage.Builder	metricsEnabled(Boolean metricsEnabled) (experimental) Specifies whether Amazon CloudWatch metrics are enabled for this method.
Stage.Builder	stageName(String stageName) (experimental) The name of the stage, which API Gateway uses as the first path segment in the invoked Uniform Resource Identifier (URI).
Stage.Builder	throttlingBurstLimit(Number throttlingBurstLimit) (experimental) Specifies the throttling burst limit.
Stage.Builder	throttlingRateLimit(Number throttlingRateLimit) (experimental) Specifies the throttling rate limit.
Stage.Builder	tracingEnabled(Boolean tracingEnabled) (experimental) Specifies whether Amazon X-Ray tracing is enabled for this method.
Stage.Builder	variables(Map<String,String> variables) (experimental) A map that defines the stage variables.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

@Stability(value=Experimental)
public static Stage.Builder create(software.constructs.Construct scope,
                                                                  String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of Stage.Builder.

cacheDataEncrypted

@Stability(value=Experimental)
public Stage.Builder cacheDataEncrypted(Boolean cacheDataEncrypted)

(experimental) Indicates whether the cached responses are encrypted.

Default: false

Parameters:

cacheDataEncrypted - Indicates whether the cached responses are encrypted. This parameter is required.

Returns:

this

cacheTtl

@Stability(value=Experimental)
public Stage.Builder cacheTtl(Duration cacheTtl)

(experimental) Specifies the time to live (TTL), in seconds, for cached responses.

The higher the TTL, the longer the response will be cached.

Default: Duration.minutes(5)

Parameters:

cacheTtl - Specifies the time to live (TTL), in seconds, for cached responses. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-caching.html

cachingEnabled

@Stability(value=Experimental)
public Stage.Builder cachingEnabled(Boolean cachingEnabled)

(experimental) Specifies whether responses should be cached and returned for requests.

A cache cluster must be enabled on the stage for responses to be cached.

Default: - Caching is Disabled.

Parameters:

cachingEnabled - Specifies whether responses should be cached and returned for requests. This parameter is required.

Returns:

this

dataTraceEnabled

@Stability(value=Experimental)
public Stage.Builder dataTraceEnabled(Boolean dataTraceEnabled)

(experimental) Specifies whether data trace logging is enabled for this method, which effects the log entries pushed to Amazon CloudWatch Logs.

Default: false

Parameters:

dataTraceEnabled - Specifies whether data trace logging is enabled for this method, which effects the log entries pushed to Amazon CloudWatch Logs. This parameter is required.

Returns:

this

loggingLevel

@Stability(value=Experimental)
public Stage.Builder loggingLevel(MethodLoggingLevel loggingLevel)

(experimental) Specifies the logging level for this method, which effects the log entries pushed to Amazon CloudWatch Logs.

Default: - Off

Parameters:

loggingLevel - Specifies the logging level for this method, which effects the log entries pushed to Amazon CloudWatch Logs. This parameter is required.

Returns:

this

metricsEnabled

@Stability(value=Experimental)
public Stage.Builder metricsEnabled(Boolean metricsEnabled)

(experimental) Specifies whether Amazon CloudWatch metrics are enabled for this method.

Default: false

Parameters:

metricsEnabled - Specifies whether Amazon CloudWatch metrics are enabled for this method. This parameter is required.

Returns:

this

throttlingBurstLimit

@Stability(value=Experimental)
public Stage.Builder throttlingBurstLimit(Number throttlingBurstLimit)

(experimental) Specifies the throttling burst limit.

The total rate of all requests in your AWS account is limited to 5,000 requests.

Default: - No additional restriction.

Parameters:

throttlingBurstLimit - Specifies the throttling burst limit. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html

throttlingRateLimit

@Stability(value=Experimental)
public Stage.Builder throttlingRateLimit(Number throttlingRateLimit)

(experimental) Specifies the throttling rate limit.

The total rate of all requests in your AWS account is limited to 10,000 requests per second (rps).

Default: - No additional restriction.

Parameters:

throttlingRateLimit - Specifies the throttling rate limit. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-request-throttling.html

accessLogDestination

@Stability(value=Experimental)
public Stage.Builder accessLogDestination(IAccessLogDestination accessLogDestination)

(experimental) The CloudWatch Logs log group.

Default: - No destination

Parameters:

accessLogDestination - The CloudWatch Logs log group. This parameter is required.

Returns:

this

accessLogFormat

@Stability(value=Experimental)
public Stage.Builder accessLogFormat(AccessLogFormat accessLogFormat)

(experimental) A single line format of access logs of data, as specified by selected $content variables.

The format must include at least AccessLogFormat.contextRequestId().

Default: - Common Log Format

Parameters:

accessLogFormat - A single line format of access logs of data, as specified by selected $content variables. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#context-variable-reference

cacheClusterEnabled

@Stability(value=Experimental)
public Stage.Builder cacheClusterEnabled(Boolean cacheClusterEnabled)

(experimental) Indicates whether cache clustering is enabled for the stage.

Default: - Disabled for the stage.

Parameters:

cacheClusterEnabled - Indicates whether cache clustering is enabled for the stage. This parameter is required.

Returns:

this

cacheClusterSize

@Stability(value=Experimental)
public Stage.Builder cacheClusterSize(String cacheClusterSize)

(experimental) The stage's cache cluster size.

Default: 0.5

Parameters:

cacheClusterSize - The stage's cache cluster size. This parameter is required.

Returns:

this

clientCertificateId

@Stability(value=Experimental)
public Stage.Builder clientCertificateId(String clientCertificateId)

(experimental) The identifier of the client certificate that API Gateway uses to call your integration endpoints in the stage.

Default: - None.

Parameters:

clientCertificateId - The identifier of the client certificate that API Gateway uses to call your integration endpoints in the stage. This parameter is required.

Returns:

this

description

@Stability(value=Experimental)
public Stage.Builder description(String description)

(experimental) A description of the purpose of the stage.

Default: - No description.

Parameters:

description - A description of the purpose of the stage. This parameter is required.

Returns:

this

documentationVersion

@Stability(value=Experimental)
public Stage.Builder documentationVersion(String documentationVersion)

(experimental) The version identifier of the API documentation snapshot.

Default: - No documentation version.

Parameters:

documentationVersion - The version identifier of the API documentation snapshot. This parameter is required.

Returns:

this

methodOptions

@Stability(value=Experimental)
public Stage.Builder methodOptions(Map<String,? extends MethodDeploymentOptions> methodOptions)

(experimental) Method deployment options for specific resources/methods.

These will override common options defined in StageOptions#methodOptions.

Default: - Common options will be used.

Parameters:

methodOptions - Method deployment options for specific resources/methods. This parameter is required.

Returns:

this

stageName

@Stability(value=Experimental)
public Stage.Builder stageName(String stageName)

(experimental) The name of the stage, which API Gateway uses as the first path segment in the invoked Uniform Resource Identifier (URI).

Default: - "prod"

Parameters:

stageName - The name of the stage, which API Gateway uses as the first path segment in the invoked Uniform Resource Identifier (URI). This parameter is required.

Returns:

this

tracingEnabled

@Stability(value=Experimental)
public Stage.Builder tracingEnabled(Boolean tracingEnabled)

(experimental) Specifies whether Amazon X-Ray tracing is enabled for this method.

Default: false

Parameters:

tracingEnabled - Specifies whether Amazon X-Ray tracing is enabled for this method. This parameter is required.

Returns:

this

variables

@Stability(value=Experimental)
public Stage.Builder variables(Map<String,String> variables)

(experimental) A map that defines the stage variables.

Variable names must consist of alphanumeric characters, and the values must match the following regular expression: [A-Za-z0-9-._~:/?#&=,]+.

Default: - No stage variables.

Parameters:

variables - A map that defines the stage variables. This parameter is required.

Returns:

this

deployment

@Stability(value=Experimental)
public Stage.Builder deployment(Deployment deployment)

(experimental) The deployment that this stage points to [disable-awslint:ref-via-interface].

Parameters:

deployment - The deployment that this stage points to [disable-awslint:ref-via-interface]. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public Stage build()

Specified by:

build in interface software.amazon.jsii.Builder<Stage>