import_documentation_parts

import_documentation_parts(**kwargs)

Imports documentation parts

See also: AWS API Documentation

Request Syntax

response = client.import_documentation_parts(
    restApiId='string',
    mode='merge'|'overwrite',
    failOnWarnings=True|False,
    body=b'bytes'|file
)

Parameters

• restApiId (string) --

  [REQUIRED]

  The string identifier of the associated RestApi.

• mode (string) -- A query parameter to indicate whether to overwrite ( OVERWRITE ) any existing DocumentationParts definition or to merge ( MERGE ) the new definition into the existing one. The default value is MERGE .
• failOnWarnings (boolean) -- A query parameter to specify whether to rollback the documentation importation ( true ) or not ( false ) when a warning is encountered. The default value is false .
• body (bytes or seekable file-like object) --

  [REQUIRED]

  Raw byte array representing the to-be-imported documentation parts. To import from an OpenAPI file, this is a JSON object.

Return type

dict

Returns

Response Syntax

{
    'ids': [
        'string',
    ],
    'warnings': [
        'string',
    ]
}

Response Structure

• (dict) --

  A collection of the imported DocumentationPart identifiers.

  • ids (list) --

    A list of the returned documentation part identifiers.

    • (string) --

  • warnings (list) --

    A list of warning messages reported during import of documentation parts.

    • (string) --

Exceptions

• APIGateway.Client.exceptions.BadRequestException
• APIGateway.Client.exceptions.ConflictException
• APIGateway.Client.exceptions.LimitExceededException
• APIGateway.Client.exceptions.NotFoundException
• APIGateway.Client.exceptions.UnauthorizedException
• APIGateway.Client.exceptions.TooManyRequestsException