Package software.amazon.awscdk.services.apigateway

Class Model.Builder

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

  • Method Details

    • create

      @Stability(Stable) public static Model.Builder create(software.constructs.Construct scope, String id)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      Returns:
      a new instance of Model.Builder.

    • schema

      @Stability(Stable) public Model.Builder schema(JsonSchema schema)
      The schema to use to transform data to one or more output formats.

      Specify null ({}) if you don't want to specify a schema.

      Parameters:
      schema - The schema to use to transform data to one or more output formats. This parameter is required.
      Returns:
      this

    • contentType

      @Stability(Stable) public Model.Builder contentType(String contentType)
      The content type for the model.

      You can also force a content type in the request or response model mapping.

      Default: 'application/json'

      Parameters:
      contentType - The content type for the model. This parameter is required.
      Returns:
      this

    • description

      @Stability(Stable) public Model.Builder description(String description)
      A description that identifies this model.

      Default: None

      Parameters:
      description - A description that identifies this model. This parameter is required.
      Returns:
      this

    • modelName

      @Stability(Stable) public Model.Builder modelName(String modelName)
      A name for the model.

      Important If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

      Default: If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the model name. For more information, see Name Type.

      Parameters:
      modelName - A name for the model. This parameter is required.
      Returns:
      this

    • restApi

      @Stability(Stable) public Model.Builder restApi(IRestApi restApi)
      The rest API that this model is part of.

      The reason we need the RestApi object itself and not just the ID is because the model is being tracked by the top-level RestApi object for the purpose of calculating it's hash to determine the ID of the deployment. This allows us to automatically update the deployment when the model of the REST API changes.

      Parameters:
      restApi - The rest API that this model is part of. This parameter is required.
      Returns:
      this

    • build

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