ApiGatewayV2 / Client / get_api

get_api

ApiGatewayV2.Client.get_api(**kwargs)

Gets an Api resource.

See also: AWS API Documentation

Request Syntax

response = client.get_api(
    ApiId='string'
)

Parameters:

ApiId (string) –

[REQUIRED]

The API identifier.

Return type:

dict

Returns:

Response Syntax

{
    'ApiEndpoint': 'string',
    'ApiGatewayManaged': True|False,
    'ApiId': 'string',
    'ApiKeySelectionExpression': 'string',
    'CorsConfiguration': {
        'AllowCredentials': True|False,
        'AllowHeaders': [
            'string',
        ],
        'AllowMethods': [
            'string',
        ],
        'AllowOrigins': [
            'string',
        ],
        'ExposeHeaders': [
            'string',
        ],
        'MaxAge': 123
    },
    'CreatedDate': datetime(2015, 1, 1),
    'Description': 'string',
    'DisableSchemaValidation': True|False,
    'DisableExecuteApiEndpoint': True|False,
    'ImportInfo': [
        'string',
    ],
    'Name': 'string',
    'ProtocolType': 'WEBSOCKET'|'HTTP',
    'RouteSelectionExpression': 'string',
    'Tags': {
        'string': 'string'
    },
    'Version': 'string',
    'Warnings': [
        'string',
    ]
}

Response Structure

• (dict) –

  Success

  • ApiEndpoint (string) –

    The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The stage name is typically appended to this URI to form a complete path to a deployed API stage.

  • ApiGatewayManaged (boolean) –

    Specifies whether an API is managed by API Gateway. You can’t update or delete a managed API by using API Gateway. A managed API can be deleted only through the tooling or service that created it.

  • ApiId (string) –

    The API ID.

  • ApiKeySelectionExpression (string) –

    An API key selection expression. Supported only for WebSocket APIs. See API Key Selection Expressions.

  • CorsConfiguration (dict) –

    A CORS configuration. Supported only for HTTP APIs.

    • AllowCredentials (boolean) –

      Specifies whether credentials are included in the CORS request. Supported only for HTTP APIs.

    • AllowHeaders (list) –

      Represents a collection of allowed headers. Supported only for HTTP APIs.

      • (string) –

    • AllowMethods (list) –

      Represents a collection of allowed HTTP methods. Supported only for HTTP APIs.

      • (string) –

        A string with a length between [1-64].

    • AllowOrigins (list) –

      Represents a collection of allowed origins. Supported only for HTTP APIs.

      • (string) –

    • ExposeHeaders (list) –

      Represents a collection of exposed headers. Supported only for HTTP APIs.

      • (string) –

    • MaxAge (integer) –

      The number of seconds that the browser should cache preflight request results. Supported only for HTTP APIs.

  • CreatedDate (datetime) –

    The timestamp when the API was created.

  • Description (string) –

    The description of the API.

  • DisableSchemaValidation (boolean) –

    Avoid validating models when creating a deployment. Supported only for WebSocket APIs.

  • DisableExecuteApiEndpoint (boolean) –

    Specifies whether clients can invoke your API by using the default execute-api endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.

  • ImportInfo (list) –

    The validation information during API import. This may include particular properties of your OpenAPI definition which are ignored during import. Supported only for HTTP APIs.

    • (string) –

  • Name (string) –

    The name of the API.

  • ProtocolType (string) –

    The API protocol.

  • RouteSelectionExpression (string) –

    The route selection expression for the API. For HTTP APIs, the routeSelectionExpression must be ${request.method} ${request.path}. If not provided, this will be the default for HTTP APIs. This property is required for WebSocket APIs.

  • Tags (dict) –

    A collection of tags associated with the API.

    • (string) –

      • (string) –

        A string with a length between [0-1600].

  • Version (string) –

    A version identifier for the API.

  • Warnings (list) –

    The warning messages reported when failonwarnings is turned on during API import.

    • (string) –

Exceptions

• ApiGatewayV2.Client.exceptions.NotFoundException

• ApiGatewayV2.Client.exceptions.TooManyRequestsException