software.amazon.awscdk.services.apigateway

Class StageOptions.Builder

java.lang.Object

software.amazon.awscdk.services.apigateway.StageOptions.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<StageOptions>

Enclosing interface:

StageOptions

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

A builder for StageOptions

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
StageOptions.Builder	accessLogDestination(IAccessLogDestination accessLogDestination) Sets the value of StageOptions.getAccessLogDestination()
StageOptions.Builder	accessLogFormat(AccessLogFormat accessLogFormat) Sets the value of StageOptions.getAccessLogFormat()
StageOptions	build() Builds the configured instance.
StageOptions.Builder	cacheClusterEnabled(Boolean cacheClusterEnabled) Sets the value of StageOptions.getCacheClusterEnabled()
StageOptions.Builder	cacheClusterSize(String cacheClusterSize) Sets the value of StageOptions.getCacheClusterSize()
StageOptions.Builder	cacheDataEncrypted(Boolean cacheDataEncrypted) Sets the value of MethodDeploymentOptions.getCacheDataEncrypted()
StageOptions.Builder	cacheTtl(Duration cacheTtl) Sets the value of MethodDeploymentOptions.getCacheTtl()
StageOptions.Builder	cachingEnabled(Boolean cachingEnabled) Sets the value of MethodDeploymentOptions.getCachingEnabled()
StageOptions.Builder	clientCertificateId(String clientCertificateId) Sets the value of StageOptions.getClientCertificateId()
StageOptions.Builder	dataTraceEnabled(Boolean dataTraceEnabled) Sets the value of MethodDeploymentOptions.getDataTraceEnabled()
StageOptions.Builder	description(String description) Sets the value of StageOptions.getDescription()
StageOptions.Builder	documentationVersion(String documentationVersion) Sets the value of StageOptions.getDocumentationVersion()
StageOptions.Builder	loggingLevel(MethodLoggingLevel loggingLevel) Sets the value of MethodDeploymentOptions.getLoggingLevel()
StageOptions.Builder	methodOptions(Map<String,? extends MethodDeploymentOptions> methodOptions) Sets the value of StageOptions.getMethodOptions()
StageOptions.Builder	metricsEnabled(Boolean metricsEnabled) Sets the value of MethodDeploymentOptions.getMetricsEnabled()
StageOptions.Builder	stageName(String stageName) Sets the value of StageOptions.getStageName()
StageOptions.Builder	throttlingBurstLimit(Number throttlingBurstLimit) Sets the value of MethodDeploymentOptions.getThrottlingBurstLimit()
StageOptions.Builder	throttlingRateLimit(Number throttlingRateLimit) Sets the value of MethodDeploymentOptions.getThrottlingRateLimit()
StageOptions.Builder	tracingEnabled(Boolean tracingEnabled) Sets the value of StageOptions.getTracingEnabled()
StageOptions.Builder	variables(Map<String,String> variables) Sets the value of StageOptions.getVariables()

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

accessLogDestination

@Stability(value=Stable)
public StageOptions.Builder accessLogDestination(IAccessLogDestination accessLogDestination)

Sets the value of StageOptions.getAccessLogDestination()

Parameters:

accessLogDestination - The CloudWatch Logs log group.

Returns:

this

accessLogFormat

@Stability(value=Stable)
public StageOptions.Builder accessLogFormat(AccessLogFormat accessLogFormat)

Sets the value of StageOptions.getAccessLogFormat()

Parameters:

accessLogFormat - A single line format of access logs of data, as specified by selected $content variables. The format must include at least AccessLogFormat.contextRequestId().

Returns:

this

cacheClusterEnabled

@Stability(value=Stable)
public StageOptions.Builder cacheClusterEnabled(Boolean cacheClusterEnabled)

Sets the value of StageOptions.getCacheClusterEnabled()

Parameters:

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

Returns:

this

cacheClusterSize

@Stability(value=Stable)
public StageOptions.Builder cacheClusterSize(String cacheClusterSize)

Sets the value of StageOptions.getCacheClusterSize()

Parameters:

cacheClusterSize - The stage's cache cluster size.

Returns:

this

clientCertificateId

@Stability(value=Stable)
public StageOptions.Builder clientCertificateId(String clientCertificateId)

Sets the value of StageOptions.getClientCertificateId()

Parameters:

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

Returns:

this

description

@Stability(value=Stable)
public StageOptions.Builder description(String description)

Sets the value of StageOptions.getDescription()

Parameters:

description - A description of the purpose of the stage.

Returns:

this

documentationVersion

@Stability(value=Stable)
public StageOptions.Builder documentationVersion(String documentationVersion)

Sets the value of StageOptions.getDocumentationVersion()

Parameters:

documentationVersion - The version identifier of the API documentation snapshot.

Returns:

this

methodOptions

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

Sets the value of StageOptions.getMethodOptions()

Parameters:

methodOptions - Method deployment options for specific resources/methods. These will override common options defined in StageOptions#methodOptions.

Returns:

this

stageName

@Stability(value=Stable)
public StageOptions.Builder stageName(String stageName)

Sets the value of StageOptions.getStageName()

Parameters:

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

Returns:

this

tracingEnabled

@Stability(value=Stable)
public StageOptions.Builder tracingEnabled(Boolean tracingEnabled)

Sets the value of StageOptions.getTracingEnabled()

Parameters:

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

Returns:

this

variables

@Stability(value=Stable)
public StageOptions.Builder variables(Map<String,String> variables)

Sets the value of StageOptions.getVariables()

Parameters:

variables - 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-._~:/?#&=,]+.

Returns:

this

cacheDataEncrypted

@Stability(value=Stable)
public StageOptions.Builder cacheDataEncrypted(Boolean cacheDataEncrypted)

Sets the value of MethodDeploymentOptions.getCacheDataEncrypted()

Parameters:

cacheDataEncrypted - Indicates whether the cached responses are encrypted.

Returns:

this

cacheTtl

@Stability(value=Stable)
public StageOptions.Builder cacheTtl(Duration cacheTtl)

Sets the value of MethodDeploymentOptions.getCacheTtl()

Parameters:

cacheTtl - Specifies the time to live (TTL), in seconds, for cached responses. The higher the TTL, the longer the response will be cached.

Returns:

this

cachingEnabled

@Stability(value=Stable)
public StageOptions.Builder cachingEnabled(Boolean cachingEnabled)

Sets the value of MethodDeploymentOptions.getCachingEnabled()

Parameters:

cachingEnabled - Specifies whether responses should be cached and returned for requests. A cache cluster must be enabled on the stage for responses to be cached.

Returns:

this

dataTraceEnabled

@Stability(value=Stable)
public StageOptions.Builder dataTraceEnabled(Boolean dataTraceEnabled)

Sets the value of MethodDeploymentOptions.getDataTraceEnabled()

Parameters:

dataTraceEnabled - Specifies whether data trace logging is enabled for this method. When enabled, API gateway will log the full API requests and responses. This can be useful to troubleshoot APIs, but can result in logging sensitive data. We recommend that you don't enable this feature for production APIs.

Returns:

this

loggingLevel

@Stability(value=Stable)
public StageOptions.Builder loggingLevel(MethodLoggingLevel loggingLevel)

Sets the value of MethodDeploymentOptions.getLoggingLevel()

Parameters:

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

Returns:

this

metricsEnabled

@Stability(value=Stable)
public StageOptions.Builder metricsEnabled(Boolean metricsEnabled)

Sets the value of MethodDeploymentOptions.getMetricsEnabled()

Parameters:

metricsEnabled - Specifies whether Amazon CloudWatch metrics are enabled for this method.

Returns:

this

throttlingBurstLimit

@Stability(value=Stable)
public StageOptions.Builder throttlingBurstLimit(Number throttlingBurstLimit)

Sets the value of MethodDeploymentOptions.getThrottlingBurstLimit()

Parameters:

throttlingBurstLimit - Specifies the throttling burst limit. The total rate of all requests in your AWS account is limited to 5,000 requests.

Returns:

this

throttlingRateLimit

@Stability(value=Stable)
public StageOptions.Builder throttlingRateLimit(Number throttlingRateLimit)

Sets the value of MethodDeploymentOptions.getThrottlingRateLimit()

Parameters:

throttlingRateLimit - Specifies the throttling rate limit. The total rate of all requests in your AWS account is limited to 10,000 requests per second (rps).

Returns:

this

build

@Stability(value=Stable)
public StageOptions build()

Builds the configured instance.

Specified by:

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

Returns:

a new instance of StageOptions

Throws:

NullPointerException - if any required attribute was not provided