Class: Aws::APIGateway::Types::PutRestApiRequest

Inherits:

Struct

• Object
• Struct
• Aws::APIGateway::Types::PutRestApiRequest

Defined in:

gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb

Overview

A PUT request to update an existing API, with external API definitions specified as the request body.

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #body ⇒ String

  The PUT request body containing external API definitions.

• #fail_on_warnings ⇒ Boolean

  A query parameter to indicate whether to rollback the API update (true) or not (false) when a warning is encountered.

• #mode ⇒ String

  The mode query parameter to specify the update mode.

• #parameters ⇒ Hash<String,String>

  Custom header parameters as part of the request.

• #rest_api_id ⇒ String

  The string identifier of the associated RestApi.

Instance Attribute Details

#body ⇒ String

The PUT request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are supported. The maximum size of the API definition file is 6MB.

Returns:

• (String)

# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 4617

class PutRestApiRequest < Struct.new(
  :rest_api_id,
  :mode,
  :fail_on_warnings,
  :parameters,
  :body)
  SENSITIVE = []
  include Aws::Structure
end

#fail_on_warnings ⇒ Boolean

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:

• (Boolean)

# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 4617

class PutRestApiRequest < Struct.new(
  :rest_api_id,
  :mode,
  :fail_on_warnings,
  :parameters,
  :body)
  SENSITIVE = []
  include Aws::Structure
end

#mode ⇒ String

The mode query parameter to specify the update mode. Valid values are "merge" and "overwrite". By default, the update mode is "merge".

Returns:

• (String)

# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 4617

class PutRestApiRequest < Struct.new(
  :rest_api_id,
  :mode,
  :fail_on_warnings,
  :parameters,
  :body)
  SENSITIVE = []
  include Aws::Structure
end

#parameters ⇒ Hash<String,String>

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:

• (Hash<String,String>)

# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 4617

class PutRestApiRequest < Struct.new(
  :rest_api_id,
  :mode,
  :fail_on_warnings,
  :parameters,
  :body)
  SENSITIVE = []
  include Aws::Structure
end

#rest_api_id ⇒ String

The string identifier of the associated RestApi.

Returns:

• (String)

# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 4617

class PutRestApiRequest < Struct.new(
  :rest_api_id,
  :mode,
  :fail_on_warnings,
  :parameters,
  :body)
  SENSITIVE = []
  include Aws::Structure
end