Class: Aws::APIGateway::Types::GetDocumentationPartsRequest

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 GetDocumentationPartsRequest data as a hash:

{
  rest_api_id: "String", # required
  type: "API", # accepts API, AUTHORIZER, MODEL, RESOURCE, METHOD, PATH_PARAMETER, QUERY_PARAMETER, REQUEST_HEADER, REQUEST_BODY, RESPONSE, RESPONSE_HEADER, RESPONSE_BODY
  name_query: "String",
  path: "String",
  position: "String",
  limit: 1,
  location_status: "DOCUMENTED", # accepts DOCUMENTED, UNDOCUMENTED
}

Gets the documentation parts of an API. The result may be filtered by the type, name, or path of API entities (targets).

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#limitInteger

The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

Returns:

  • (Integer)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#location_statusString

The status of the API documentation parts to retrieve. Valid values are ‘DOCUMENTED` for retrieving DocumentationPart resources with content and `UNDOCUMENTED` for DocumentationPart resources without content.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#name_queryString

The name of API entities of the to-be-retrieved documentation parts.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#pathString

The path of API entities of the to-be-retrieved documentation parts.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#positionString

The current pagination position in the paged result set.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#rest_api_idString

[Required] The string identifier of the associated RestApi.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end

#typeString

The type of API entities of the to-be-retrieved documentation parts.

Returns:

  • (String)


3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
# File 'lib/aws-sdk-apigateway/types.rb', line 3392

class GetDocumentationPartsRequest < Struct.new(
  :rest_api_id,
  :type,
  :name_query,
  :path,
  :position,
  :limit,
  :location_status)
  SENSITIVE = []
  include Aws::Structure
end