libZSservicesZSamazonka-apigatewayZSamazonka-apigateway
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.APIGateway.GetDocumentationParts

Description

  • - | Undocumented operation.

This operation returns paginated results.

Synopsis

Creating a Request

data GetDocumentationParts Source #

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

See: newGetDocumentationParts smart constructor.

Constructors

GetDocumentationParts' 

Fields

  • path :: Maybe Text

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

  • locationStatus :: Maybe LocationStatusType

    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.

  • nameQuery :: Maybe Text

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

  • limit :: Maybe Int

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

  • type' :: Maybe DocumentationPartType

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

  • position :: Maybe Text

    The current pagination position in the paged result set.

  • restApiId :: Text
    Required
    The string identifier of the associated RestApi.

Instances

Instances details
Eq GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Read GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Show GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Generic GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Associated Types

type Rep GetDocumentationParts :: Type -> Type #

NFData GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Methods

rnf :: GetDocumentationParts -> () #

Hashable GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

AWSPager GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

AWSRequest GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Associated Types

type AWSResponse GetDocumentationParts #

ToHeaders GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

ToPath GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

ToQuery GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

type Rep GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

type AWSResponse GetDocumentationParts Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

newGetDocumentationParts Source #

Create a value of GetDocumentationParts with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:path:GetDocumentationParts', getDocumentationParts_path - The path of API entities of the to-be-retrieved documentation parts.

$sel:locationStatus:GetDocumentationParts', getDocumentationParts_locationStatus - 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.

$sel:nameQuery:GetDocumentationParts', getDocumentationParts_nameQuery - The name of API entities of the to-be-retrieved documentation parts.

$sel:limit:GetDocumentationParts', getDocumentationParts_limit - The maximum number of returned results per page. The default value is 25 and the maximum value is 500.

$sel:type':GetDocumentationParts', getDocumentationParts_type - The type of API entities of the to-be-retrieved documentation parts.

$sel:position:GetDocumentationParts', getDocumentationParts_position - The current pagination position in the paged result set.

$sel:restApiId:GetDocumentationParts', getDocumentationParts_restApiId - [Required] The string identifier of the associated RestApi.

Request Lenses

getDocumentationParts_path :: Lens' GetDocumentationParts (Maybe Text) Source #

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

getDocumentationParts_locationStatus :: Lens' GetDocumentationParts (Maybe LocationStatusType) Source #

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.

getDocumentationParts_nameQuery :: Lens' GetDocumentationParts (Maybe Text) Source #

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

getDocumentationParts_limit :: Lens' GetDocumentationParts (Maybe Int) Source #

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

getDocumentationParts_type :: Lens' GetDocumentationParts (Maybe DocumentationPartType) Source #

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

getDocumentationParts_position :: Lens' GetDocumentationParts (Maybe Text) Source #

The current pagination position in the paged result set.

getDocumentationParts_restApiId :: Lens' GetDocumentationParts Text Source #

Required
The string identifier of the associated RestApi.

Destructuring the Response

data GetDocumentationPartsResponse Source #

The collection of documentation parts of an API.

Documenting an API, DocumentationPart

See: newGetDocumentationPartsResponse smart constructor.

Constructors

GetDocumentationPartsResponse' 

Fields

Instances

Instances details
Eq GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Read GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Show GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Generic GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

Associated Types

type Rep GetDocumentationPartsResponse :: Type -> Type #

NFData GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

type Rep GetDocumentationPartsResponse Source # 
Instance details

Defined in Amazonka.APIGateway.GetDocumentationParts

type Rep GetDocumentationPartsResponse = D1 ('MetaData "GetDocumentationPartsResponse" "Amazonka.APIGateway.GetDocumentationParts" "libZSservicesZSamazonka-apigatewayZSamazonka-apigateway" 'False) (C1 ('MetaCons "GetDocumentationPartsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "items") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [DocumentationPart])) :*: (S1 ('MetaSel ('Just "position") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newGetDocumentationPartsResponse Source #

Create a value of GetDocumentationPartsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:items:GetDocumentationPartsResponse', getDocumentationPartsResponse_items - The current page of elements from this collection.

$sel:position:GetDocumentationParts', getDocumentationPartsResponse_position - Undocumented member.

$sel:httpStatus:GetDocumentationPartsResponse', getDocumentationPartsResponse_httpStatus - The response's http status code.

Response Lenses