Package software.amazon.awscdk.cfnpropertymixins.services.apigateway

Class CfnRestApiMixinProps.Builder

java.lang.Object
software.amazon.awscdk.cfnpropertymixins.services.apigateway.CfnRestApiMixinProps.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<CfnRestApiMixinProps>
Enclosing interface:
CfnRestApiMixinProps
@Stability(Stable) public static final class CfnRestApiMixinProps.Builder extends Object implements software.amazon.jsii.Builder<CfnRestApiMixinProps>
A builder for CfnRestApiMixinProps

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • apiKeySourceType

      @Stability(Stable) public CfnRestApiMixinProps.Builder apiKeySourceType(String apiKeySourceType)
      Sets the value of CfnRestApiMixinProps.getApiKeySourceType()
      Parameters:
      apiKeySourceType - The source of the API key for metering requests according to a usage plan. Valid values are: HEADER to read the API key from the X-API-Key header of a request. AUTHORIZER to read the API key from the UsageIdentifierKey from a custom authorizer.
      Returns:
      this

    • binaryMediaTypes

      @Stability(Stable) public CfnRestApiMixinProps.Builder binaryMediaTypes(List<String> binaryMediaTypes)
      Sets the value of CfnRestApiMixinProps.getBinaryMediaTypes()
      Parameters:
      binaryMediaTypes - The list of binary media types supported by the RestApi. By default, the RestApi supports only UTF-8-encoded text payloads.
      Returns:
      this

    • body

      @Stability(Stable) public CfnRestApiMixinProps.Builder body(Object body)
      Sets the value of CfnRestApiMixinProps.getBody()
      Parameters:
      body - An OpenAPI specification that defines a set of RESTful APIs in JSON format. For YAML templates, you can also provide the specification in YAML format.
      Returns:
      this

    • bodyS3Location

      @Stability(Stable) public CfnRestApiMixinProps.Builder bodyS3Location(IResolvable bodyS3Location)
      Sets the value of CfnRestApiMixinProps.getBodyS3Location()
      Parameters:
      bodyS3Location - The Amazon Simple Storage Service (Amazon S3) location that points to an OpenAPI file, which defines a set of RESTful APIs in JSON or YAML format.
      Returns:
      this

    • bodyS3Location

      @Stability(Stable) public CfnRestApiMixinProps.Builder bodyS3Location(CfnRestApiPropsMixin.S3LocationProperty bodyS3Location)
      Sets the value of CfnRestApiMixinProps.getBodyS3Location()
      Parameters:
      bodyS3Location - The Amazon Simple Storage Service (Amazon S3) location that points to an OpenAPI file, which defines a set of RESTful APIs in JSON or YAML format.
      Returns:
      this

    • cloneFrom

      @Stability(Stable) public CfnRestApiMixinProps.Builder cloneFrom(String cloneFrom)
      Sets the value of CfnRestApiMixinProps.getCloneFrom()
      Parameters:
      cloneFrom - The ID of the RestApi that you want to clone from.
      Returns:
      this

    • cloneFrom

      @Stability(Stable) public CfnRestApiMixinProps.Builder cloneFrom(IRestApiRef cloneFrom)
      Sets the value of CfnRestApiMixinProps.getCloneFrom()
      Parameters:
      cloneFrom - The ID of the RestApi that you want to clone from.
      Returns:
      this

    • description

      @Stability(Stable) public CfnRestApiMixinProps.Builder description(String description)
      Sets the value of CfnRestApiMixinProps.getDescription()
      Parameters:
      description - The description of the RestApi.
      Returns:
      this

    • disableExecuteApiEndpoint

      @Stability(Stable) public CfnRestApiMixinProps.Builder disableExecuteApiEndpoint(Boolean disableExecuteApiEndpoint)
      Sets the value of CfnRestApiMixinProps.getDisableExecuteApiEndpoint()
      Parameters:
      disableExecuteApiEndpoint - Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint
      Returns:
      this

    • disableExecuteApiEndpoint

      @Stability(Stable) public CfnRestApiMixinProps.Builder disableExecuteApiEndpoint(IResolvable disableExecuteApiEndpoint)
      Sets the value of CfnRestApiMixinProps.getDisableExecuteApiEndpoint()
      Parameters:
      disableExecuteApiEndpoint - Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint
      Returns:
      this

    • endpointAccessMode

      @Stability(Stable) public CfnRestApiMixinProps.Builder endpointAccessMode(String endpointAccessMode)
      Sets the value of CfnRestApiMixinProps.getEndpointAccessMode()
      Parameters:
      endpointAccessMode - The endpoint access mode for your RestApi.
      Returns:
      this

    • endpointConfiguration

      @Stability(Stable) public CfnRestApiMixinProps.Builder endpointConfiguration(IResolvable endpointConfiguration)
      Sets the value of CfnRestApiMixinProps.getEndpointConfiguration()
      Parameters:
      endpointConfiguration - A list of the endpoint types and IP address types of the API. Use this property when creating an API. When importing an existing API, specify the endpoint configuration types using the Parameters property.
      Returns:
      this

    • endpointConfiguration

      @Stability(Stable) public CfnRestApiMixinProps.Builder endpointConfiguration(CfnRestApiPropsMixin.EndpointConfigurationProperty endpointConfiguration)
      Sets the value of CfnRestApiMixinProps.getEndpointConfiguration()
      Parameters:
      endpointConfiguration - A list of the endpoint types and IP address types of the API. Use this property when creating an API. When importing an existing API, specify the endpoint configuration types using the Parameters property.
      Returns:
      this

    • failOnWarnings

      @Stability(Stable) public CfnRestApiMixinProps.Builder failOnWarnings(Boolean failOnWarnings)
      Sets the value of CfnRestApiMixinProps.getFailOnWarnings()
      Parameters:
      failOnWarnings - A query parameter to indicate whether to rollback the API update ( true ) or not ( false ) when a warning is encountered. The default value is false .
      Returns:
      this

    • failOnWarnings

      @Stability(Stable) public CfnRestApiMixinProps.Builder failOnWarnings(IResolvable failOnWarnings)
      Sets the value of CfnRestApiMixinProps.getFailOnWarnings()
      Parameters:
      failOnWarnings - A query parameter to indicate whether to rollback the API update ( true ) or not ( false ) when a warning is encountered. The default value is false .
      Returns:
      this

    • minimumCompressionSize

      @Stability(Stable) public CfnRestApiMixinProps.Builder minimumCompressionSize(Number minimumCompressionSize)
      Sets the value of CfnRestApiMixinProps.getMinimumCompressionSize()
      Parameters:
      minimumCompressionSize - A nullable integer that is used to enable compression (with non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable compression (with a null value) on an API. When compression is enabled, compression or decompression is not applied on the payload if the payload size is smaller than this value. Setting it to zero allows compression for any payload size.
      Returns:
      this

    • mode

      @Stability(Stable) public CfnRestApiMixinProps.Builder mode(String mode)
      Sets the value of CfnRestApiMixinProps.getMode()
      Parameters:
      mode - This property applies only when you use OpenAPI to define your REST API. The Mode determines how API Gateway handles resource updates.

      Valid values are overwrite or merge .

      For overwrite , the new API definition replaces the existing one. The existing API identifier remains unchanged.

      For merge , the new API definition is merged with the existing API.

      If you don't specify this property, a default value is chosen. For REST APIs created before March 29, 2021, the default is overwrite . For REST APIs created after March 29, 2021, the new API definition takes precedence, but any container types such as endpoint configurations and binary media types are merged with the existing API.

      Use the default mode to define top-level RestApi properties in addition to using OpenAPI. Generally, it's preferred to use API Gateway's OpenAPI extensions to model these properties.

      Returns:
      this

    • name

      @Stability(Stable) public CfnRestApiMixinProps.Builder name(String name)
      Sets the value of CfnRestApiMixinProps.getName()
      Parameters:
      name - The name of the RestApi. A name is required if the REST API is not based on an OpenAPI specification.
      Returns:
      this

    • parameters

      @Stability(Stable) public CfnRestApiMixinProps.Builder parameters(Map<String,String> parameters)
      Sets the value of CfnRestApiMixinProps.getParameters()
      Parameters:
      parameters - Custom header parameters as part of the request. For example, to exclude DocumentationParts from an imported API, set ignore=documentation as a parameters value, as in the AWS CLI command of aws apigateway import-rest-api --parameters ignore=documentation --body 'file:///path/to/imported-api-body.json' .
      Returns:
      this

    • parameters

      @Stability(Stable) public CfnRestApiMixinProps.Builder parameters(IResolvable parameters)
      Sets the value of CfnRestApiMixinProps.getParameters()
      Parameters:
      parameters - Custom header parameters as part of the request. For example, to exclude DocumentationParts from an imported API, set ignore=documentation as a parameters value, as in the AWS CLI command of aws apigateway import-rest-api --parameters ignore=documentation --body 'file:///path/to/imported-api-body.json' .
      Returns:
      this

    • policy

      @Stability(Stable) public CfnRestApiMixinProps.Builder policy(Object policy)
      Sets the value of CfnRestApiMixinProps.getPolicy()
      Parameters:
      policy - A policy document that contains the permissions for the RestApi resource. To set the ARN for the policy, use the !Join intrinsic function with "" as delimiter and values of "execute-api:/" and "*" .
      Returns:
      this

    • securityPolicy

      @Stability(Stable) public CfnRestApiMixinProps.Builder securityPolicy(String securityPolicy)
      Sets the value of CfnRestApiMixinProps.getSecurityPolicy()
      Parameters:
      securityPolicy - The Transport Layer Security (TLS) version + cipher suite for this RestApi.
      Returns:
      this

    • tags

      @Stability(Stable) public CfnRestApiMixinProps.Builder tags(List<? extends CfnTag> tags)
      Sets the value of CfnRestApiMixinProps.getTags()
      Parameters:
      tags - The key-value map of strings. The valid character set is [a-zA-Z+-=._:/]. The tag key can be up to 128 characters and must not start with aws: . The tag value can be up to 256 characters.
      Returns:
      this

    • build

      @Stability(Stable) public CfnRestApiMixinProps build()
      Builds the configured instance.
      Specified by:
      build in interface software.amazon.jsii.Builder<CfnRestApiMixinProps>
      Returns:
      a new instance of CfnRestApiMixinProps
      Throws:
      NullPointerException - if any required attribute was not provided