Class: Aws::APIGateway::Types::DocumentationPartLocation

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-apigateway/types.rb

Overview

Note:

When making an API call, you may pass DocumentationPartLocation data as a hash:

{
  type: "API", # required, accepts API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, RESPONSE_BODY
  path: "String",
  method: "String",
  status_code: "DocumentationPartLocationStatusCode",
  name: "String",
}

Specifies the target API entity to which the documentation applies.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#methodString

The HTTP verb of a method. It is a valid field for the API entity types of `METHOD`, `PATH_PARAMETER`, `QUERY_PARAMETER`, `REQUEST_HEADER`, `REQUEST_BODY`, `RESPONSE`, `RESPONSE_HEADER`, and `RESPONSE_BODY`. The default value is `*` for any method. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other `location` attributes, the child entity's `method` attribute must match that of the parent entity exactly.

Returns:

  • (String)

2222
2223
2224
2225
2226
2227
2228
2229
2230
# File 'lib/aws-sdk-apigateway/types.rb', line 2222

class DocumentationPartLocation < Struct.new(
  :type,
  :path,
  :method,
  :status_code,
  :name)
  SENSITIVE = []
  include Aws::Structure
end

#nameString

The name of the targeted API entity. It is a valid and required field for the API entity types of `AUTHORIZER`, `MODEL`, `PATH_PARAMETER`, `QUERY_PARAMETER`, `REQUEST_HEADER`, `REQUEST_BODY` and `RESPONSE_HEADER`. It is an invalid field for any other entity type.

Returns:

  • (String)

2222
2223
2224
2225
2226
2227
2228
2229
2230
# File 'lib/aws-sdk-apigateway/types.rb', line 2222

class DocumentationPartLocation < Struct.new(
  :type,
  :path,
  :method,
  :status_code,
  :name)
  SENSITIVE = []
  include Aws::Structure
end

#pathString

The URL path of the target. It is a valid field for the API entity types of `RESOURCE`, `METHOD`, `PATH_PARAMETER`, `QUERY_PARAMETER`, `REQUEST_HEADER`, `REQUEST_BODY`, `RESPONSE`, `RESPONSE_HEADER`, and `RESPONSE_BODY`. The default value is `/` for the root resource. When an applicable child entity inherits the content of another entity of the same type with more general specifications of the other `location` attributes, the child entity's `path` attribute must match that of the parent entity as a prefix.

Returns:

  • (String)

2222
2223
2224
2225
2226
2227
2228
2229
2230
# File 'lib/aws-sdk-apigateway/types.rb', line 2222

class DocumentationPartLocation < Struct.new(
  :type,
  :path,
  :method,
  :status_code,
  :name)
  SENSITIVE = []
  include Aws::Structure
end

#status_codeString

The HTTP status code of a response. It is a valid field for the API entity types of `RESPONSE`, `RESPONSE_HEADER`, and `RESPONSE_BODY`. The default value is `*` for any status code. When an applicable child entity inherits the content of an entity of the same type with more general specifications of the other `location` attributes, the child entity's `statusCode` attribute must match that of the parent entity exactly.

Returns:

  • (String)

2222
2223
2224
2225
2226
2227
2228
2229
2230
# File 'lib/aws-sdk-apigateway/types.rb', line 2222

class DocumentationPartLocation < Struct.new(
  :type,
  :path,
  :method,
  :status_code,
  :name)
  SENSITIVE = []
  include Aws::Structure
end

#typeString

The type of API entity to which the documentation content applies. Valid values are `API`, `AUTHORIZER`, `MODEL`, `RESOURCE`, `METHOD`, `PATH_PARAMETER`, `QUERY_PARAMETER`, `REQUEST_HEADER`, `REQUEST_BODY`, `RESPONSE`, `RESPONSE_HEADER`, and `RESPONSE_BODY`. Content inheritance does not apply to any entity of the `API`, `AUTHORIZER`, `METHOD`, `MODEL`, `REQUEST_BODY`, or `RESOURCE` type.

Returns:

  • (String)

2222
2223
2224
2225
2226
2227
2228
2229
2230
# File 'lib/aws-sdk-apigateway/types.rb', line 2222

class DocumentationPartLocation < Struct.new(
  :type,
  :path,
  :method,
  :status_code,
  :name)
  SENSITIVE = []
  include Aws::Structure
end