describe_api_destination

describe_api_destination(**kwargs)

Retrieves details about an API destination.

See also: AWS API Documentation

Request Syntax

response = client.describe_api_destination(
    Name='string'
)
Parameters
Name (string) --

[REQUIRED]

The name of the API destination to retrieve.

Return type
dict
Returns
Response Syntax
{
    'ApiDestinationArn': 'string',
    'Name': 'string',
    'Description': 'string',
    'ApiDestinationState': 'ACTIVE'|'INACTIVE',
    'ConnectionArn': 'string',
    'InvocationEndpoint': 'string',
    'HttpMethod': 'POST'|'GET'|'HEAD'|'OPTIONS'|'PUT'|'PATCH'|'DELETE',
    'InvocationRateLimitPerSecond': 123,
    'CreationTime': datetime(2015, 1, 1),
    'LastModifiedTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --
    • ApiDestinationArn (string) --

      The ARN of the API destination retrieved.

    • Name (string) --

      The name of the API destination retrieved.

    • Description (string) --

      The description for the API destination retrieved.

    • ApiDestinationState (string) --

      The state of the API destination retrieved.

    • ConnectionArn (string) --

      The ARN of the connection specified for the API destination retrieved.

    • InvocationEndpoint (string) --

      The URL to use to connect to the HTTP endpoint.

    • HttpMethod (string) --

      The method to use to connect to the HTTP endpoint.

    • InvocationRateLimitPerSecond (integer) --

      The maximum number of invocations per second to specified for the API destination. Note that if you set the invocation rate maximum to a value lower the rate necessary to send all events received on to the destination HTTP endpoint, some events may not be delivered within the 24-hour retry window. If you plan to set the rate lower than the rate necessary to deliver all events, consider using a dead-letter queue to catch events that are not delivered within 24 hours.

    • CreationTime (datetime) --

      A time stamp for the time that the API destination was created.

    • LastModifiedTime (datetime) --

      A time stamp for the time that the API destination was last modified.

Exceptions

  • EventBridge.Client.exceptions.ResourceNotFoundException
  • EventBridge.Client.exceptions.InternalException