ApiGatewayV2 / Client / get_apis

get_apis

ApiGatewayV2.Client.get_apis(**kwargs)

Gets a collection of Api resources.

See also: AWS API Documentation

Request Syntax

response = client.get_apis(
    MaxResults='string',
    NextToken='string'
)

Parameters:

• MaxResults (string) – The maximum number of elements to be returned for this resource.

• NextToken (string) – The next page of elements from this collection. Not valid for the last element of the collection.

Return type:

dict

Returns:

Response Syntax

{
    'Items': [
        {
            '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',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  Success

  • Items (list) –

    The elements from this collection.

    • (dict) –

      Represents an API.

      • 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) –

  • NextToken (string) –

    The next page of elements from this collection. Not valid for the last element of the collection.

Exceptions

• ApiGatewayV2.Client.exceptions.NotFoundException

• ApiGatewayV2.Client.exceptions.TooManyRequestsException

• ApiGatewayV2.Client.exceptions.BadRequestException