Class CfnStage.Builder

java.lang.Object
software.amazon.awscdk.services.apigateway.CfnStage.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<CfnStage>
Enclosing class:
CfnStage

@Stability(Stable) public static final class CfnStage.Builder extends Object implements software.amazon.jsii.Builder<CfnStage>
A fluent builder for CfnStage.
  • Method Details

    • create

      @Stability(Stable) public static CfnStage.Builder create(Construct scope, String id)
      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
      Returns:
      a new instance of CfnStage.Builder.
    • restApiId

      @Stability(Stable) public CfnStage.Builder restApiId(String restApiId)
      The string identifier of the associated RestApi.

      Parameters:
      restApiId - The string identifier of the associated RestApi. This parameter is required.
      Returns:
      this
    • accessLogSetting

      @Stability(Stable) public CfnStage.Builder accessLogSetting(IResolvable accessLogSetting)
      Access log settings, including the access log format and access log destination ARN.

      Parameters:
      accessLogSetting - Access log settings, including the access log format and access log destination ARN. This parameter is required.
      Returns:
      this
    • accessLogSetting

      @Stability(Stable) public CfnStage.Builder accessLogSetting(CfnStage.AccessLogSettingProperty accessLogSetting)
      Access log settings, including the access log format and access log destination ARN.

      Parameters:
      accessLogSetting - Access log settings, including the access log format and access log destination ARN. This parameter is required.
      Returns:
      this
    • cacheClusterEnabled

      @Stability(Stable) public CfnStage.Builder cacheClusterEnabled(Boolean cacheClusterEnabled)
      Specifies whether a cache cluster is enabled for the stage.

      Parameters:
      cacheClusterEnabled - Specifies whether a cache cluster is enabled for the stage. This parameter is required.
      Returns:
      this
    • cacheClusterEnabled

      @Stability(Stable) public CfnStage.Builder cacheClusterEnabled(IResolvable cacheClusterEnabled)
      Specifies whether a cache cluster is enabled for the stage.

      Parameters:
      cacheClusterEnabled - Specifies whether a cache cluster is enabled for the stage. This parameter is required.
      Returns:
      this
    • cacheClusterSize

      @Stability(Stable) public CfnStage.Builder cacheClusterSize(String cacheClusterSize)
      The stage's cache capacity in GB.

      For more information about choosing a cache size, see Enabling API caching to enhance responsiveness .

      Parameters:
      cacheClusterSize - The stage's cache capacity in GB. This parameter is required.
      Returns:
      this
    • canarySetting

      @Stability(Stable) public CfnStage.Builder canarySetting(IResolvable canarySetting)
      Settings for the canary deployment in this stage.

      Parameters:
      canarySetting - Settings for the canary deployment in this stage. This parameter is required.
      Returns:
      this
    • canarySetting

      @Stability(Stable) public CfnStage.Builder canarySetting(CfnStage.CanarySettingProperty canarySetting)
      Settings for the canary deployment in this stage.

      Parameters:
      canarySetting - Settings for the canary deployment in this stage. This parameter is required.
      Returns:
      this
    • clientCertificateId

      @Stability(Stable) public CfnStage.Builder clientCertificateId(String clientCertificateId)
      The identifier of a client certificate for an API stage.

      Parameters:
      clientCertificateId - The identifier of a client certificate for an API stage. This parameter is required.
      Returns:
      this
    • deploymentId

      @Stability(Stable) public CfnStage.Builder deploymentId(String deploymentId)
      The identifier of the Deployment that the stage points to.

      Parameters:
      deploymentId - The identifier of the Deployment that the stage points to. This parameter is required.
      Returns:
      this
    • description

      @Stability(Stable) public CfnStage.Builder description(String description)
      The stage's description.

      Parameters:
      description - The stage's description. This parameter is required.
      Returns:
      this
    • documentationVersion

      @Stability(Stable) public CfnStage.Builder documentationVersion(String documentationVersion)
      The version of the associated API documentation.

      Parameters:
      documentationVersion - The version of the associated API documentation. This parameter is required.
      Returns:
      this
    • methodSettings

      @Stability(Stable) public CfnStage.Builder methodSettings(IResolvable methodSettings)
      A map that defines the method settings for a Stage resource.

      Keys (designated as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} for an individual method override, or /\* /\* for overriding all methods in the stage.

      Parameters:
      methodSettings - A map that defines the method settings for a Stage resource. This parameter is required.
      Returns:
      this
    • methodSettings

      @Stability(Stable) public CfnStage.Builder methodSettings(List<? extends Object> methodSettings)
      A map that defines the method settings for a Stage resource.

      Keys (designated as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} for an individual method override, or /\* /\* for overriding all methods in the stage.

      Parameters:
      methodSettings - A map that defines the method settings for a Stage resource. This parameter is required.
      Returns:
      this
    • stageName

      @Stability(Stable) public CfnStage.Builder stageName(String stageName)
      The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway.

      Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.

      Parameters:
      stageName - The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway. This parameter is required.
      Returns:
      this
    • tags

      @Stability(Stable) public CfnStage.Builder tags(List<? extends CfnTag> tags)
      The collection of tags.

      Each tag element is associated with a given resource.

      Parameters:
      tags - The collection of tags. This parameter is required.
      Returns:
      this
    • tracingEnabled

      @Stability(Stable) public CfnStage.Builder tracingEnabled(Boolean tracingEnabled)
      Specifies whether active tracing with X-ray is enabled for the Stage.

      Parameters:
      tracingEnabled - Specifies whether active tracing with X-ray is enabled for the Stage. This parameter is required.
      Returns:
      this
    • tracingEnabled

      @Stability(Stable) public CfnStage.Builder tracingEnabled(IResolvable tracingEnabled)
      Specifies whether active tracing with X-ray is enabled for the Stage.

      Parameters:
      tracingEnabled - Specifies whether active tracing with X-ray is enabled for the Stage. This parameter is required.
      Returns:
      this
    • variables

      @Stability(Stable) public CfnStage.Builder variables(IResolvable variables)
      A map (string-to-string map) that defines the stage variables, where the variable name is the key and the variable value is the value.

      Variable names are limited to alphanumeric characters. Values must match the following regular expression: [A-Za-z0-9-._~:/?#&=,]+ .

      Parameters:
      variables - A map (string-to-string map) that defines the stage variables, where the variable name is the key and the variable value is the value. This parameter is required.
      Returns:
      this
    • variables

      @Stability(Stable) public CfnStage.Builder variables(Map<String,String> variables)
      A map (string-to-string map) that defines the stage variables, where the variable name is the key and the variable value is the value.

      Variable names are limited to alphanumeric characters. Values must match the following regular expression: [A-Za-z0-9-._~:/?#&=,]+ .

      Parameters:
      variables - A map (string-to-string map) that defines the stage variables, where the variable name is the key and the variable value is the value. This parameter is required.
      Returns:
      this
    • build

      @Stability(Stable) public CfnStage build()
      Specified by:
      build in interface software.amazon.jsii.Builder<CfnStage>
      Returns:
      a newly built instance of CfnStage.