CloudWatchLogs / Client / get_delivery

get_delivery

CloudWatchLogs.Client.get_delivery(**kwargs)

Returns complete information about one logical delivery. A delivery is a connection between a delivery source and a delivery destination.

A delivery source represents an Amazon Web Services resource that sends logs to an logs delivery destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose. Only some Amazon Web Services services support being configured as a delivery source. These services are listed in Enable logging from Amazon Web Services services.

You need to specify the delivery id in this operation. You can find the IDs of the deliveries in your account with the DescribeDeliveries operation.

See also: AWS API Documentation

Request Syntax

response = client.get_delivery(
    id='string'
)

Parameters:

id (string) –

[REQUIRED]

The ID of the delivery that you want to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'delivery': {
        'id': 'string',
        'arn': 'string',
        'deliverySourceName': 'string',
        'deliveryDestinationArn': 'string',
        'deliveryDestinationType': 'S3'|'CWL'|'FH',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

• (dict) –

  • delivery (dict) –

    A structure that contains information about the delivery.

    • id (string) –

      The unique ID that identifies this delivery in your account.

    • arn (string) –

      The Amazon Resource Name (ARN) that uniquely identifies this delivery.

    • deliverySourceName (string) –

      The name of the delivery source that is associated with this delivery.

    • deliveryDestinationArn (string) –

      The ARN of the delivery destination that is associated with this delivery.

    • deliveryDestinationType (string) –

      Displays whether the delivery destination associated with this delivery is CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.

    • tags (dict) –

      The tags that have been assigned to this delivery.

      • (string) –

        • (string) –

Exceptions

• CloudWatchLogs.Client.exceptions.ResourceNotFoundException

• CloudWatchLogs.Client.exceptions.ServiceUnavailableException

• CloudWatchLogs.Client.exceptions.ValidationException

• CloudWatchLogs.Client.exceptions.ServiceQuotaExceededException

• CloudWatchLogs.Client.exceptions.ThrottlingException