ApiGatewayManagementApi

Table of Contents

• ApiGatewayManagementApi
  • Client
  • Paginators

Client

class ApiGatewayManagementApi.Client

A low-level client representing AmazonApiGatewayManagementApi

The Amazon API Gateway Management API allows you to directly manage runtime aspects of your deployed APIs. To use it, you must explicitly set the SDK's endpoint to point to the endpoint of your deployed API. The endpoint will be of the form https://{api-id}.execute-api.{region}.amazonaws.com/{stage}, or will be the endpoint corresponding to your API's custom domain and base path, if applicable.

import boto3

client = boto3.client('apigatewaymanagementapi')

These are the available methods:

• can_paginate()
• delete_connection()
• get_connection()
• get_paginator()
• get_waiter()
• post_to_connection()

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters

operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").

Returns

True if the operation can be paginated, False otherwise.

delete_connection(**kwargs)

Delete the connection with the provided id.

See also: AWS API Documentation

Request Syntax

response = client.delete_connection(
    ConnectionId='string'
)

Parameters

ConnectionId (string) -- [REQUIRED]

Returns

None

Exceptions

• ApiGatewayManagementApi.Client.exceptions.GoneException
• ApiGatewayManagementApi.Client.exceptions.LimitExceededException
• ApiGatewayManagementApi.Client.exceptions.ForbiddenException

get_connection(**kwargs)

Get information about the connection with the provided id.

See also: AWS API Documentation

Request Syntax

response = client.get_connection(
    ConnectionId='string'
)

Parameters

ConnectionId (string) -- [REQUIRED]

Return type

dict

Returns

Response Syntax

{
    'ConnectedAt': datetime(2015, 1, 1),
    'Identity': {
        'SourceIp': 'string',
        'UserAgent': 'string'
    },
    'LastActiveAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) --
  • ConnectedAt (datetime) --

    The time in ISO 8601 format for when the connection was established.

  • Identity (dict) --
    • SourceIp (string) --

      The source IP address of the TCP connection making the request to API Gateway.

    • UserAgent (string) --

      The User Agent of the API caller.

  • LastActiveAt (datetime) --

    The time in ISO 8601 format for when the connection was last active.

Exceptions

• ApiGatewayManagementApi.Client.exceptions.GoneException
• ApiGatewayManagementApi.Client.exceptions.LimitExceededException
• ApiGatewayManagementApi.Client.exceptions.ForbiddenException

get_paginator(operation_name)

Create a paginator for an operation.

Parameters

operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").

Raises OperationNotPageableError

Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.

Return type

L{botocore.paginate.Paginator}

Returns

A paginator object.

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters

waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.

Returns

The specified waiter object.

Return type

botocore.waiter.Waiter

post_to_connection(**kwargs)

Sends the provided data to the specified connection.

See also: AWS API Documentation

Request Syntax

response = client.post_to_connection(
    Data=b'bytes'|file,
    ConnectionId='string'
)

Parameters

• Data (bytes or seekable file-like object) --

  [REQUIRED]

  The data to be sent to the client specified by its connection id.

• ConnectionId (string) --

  [REQUIRED]

  The identifier of the connection that a specific client is using.

Returns

None

Exceptions

• ApiGatewayManagementApi.Client.exceptions.GoneException
• ApiGatewayManagementApi.Client.exceptions.LimitExceededException
• ApiGatewayManagementApi.Client.exceptions.PayloadTooLargeException
• ApiGatewayManagementApi.Client.exceptions.ForbiddenException

Paginators

The available paginators are: