GuardDuty / Client / describe_publishing_destination

describe_publishing_destination

GuardDuty.Client.describe_publishing_destination(**kwargs)

Returns information about the publishing destination specified by the provided destinationId.

See also: AWS API Documentation

Request Syntax

response = client.describe_publishing_destination(
    DetectorId='string',
    DestinationId='string'
)

Parameters:

• DetectorId (string) –

  [REQUIRED]

  The unique ID of the detector associated with the publishing destination to retrieve.

  To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

• DestinationId (string) –

  [REQUIRED]

  The ID of the publishing destination to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'DestinationId': 'string',
    'DestinationType': 'S3',
    'Status': 'PENDING_VERIFICATION'|'PUBLISHING'|'UNABLE_TO_PUBLISH_FIX_DESTINATION_PROPERTY'|'STOPPED',
    'PublishingFailureStartTimestamp': 123,
    'DestinationProperties': {
        'DestinationArn': 'string',
        'KmsKeyArn': 'string'
    }
}

Response Structure

• (dict) –

  • DestinationId (string) –

    The ID of the publishing destination.

  • DestinationType (string) –

    The type of publishing destination. Currently, only Amazon S3 buckets are supported.

  • Status (string) –

    The status of the publishing destination.

  • PublishingFailureStartTimestamp (integer) –

    The time, in epoch millisecond format, at which GuardDuty was first unable to publish findings to the destination.

  • DestinationProperties (dict) –

    A DestinationProperties object that includes the DestinationArn and KmsKeyArn of the publishing destination.

    • DestinationArn (string) –

      The ARN of the resource to publish to.

      To specify an S3 bucket folder use the following format: arn:aws:s3:::DOC-EXAMPLE-BUCKET/myFolder/

    • KmsKeyArn (string) –

      The ARN of the KMS key to use for encryption.

Exceptions

• GuardDuty.Client.exceptions.BadRequestException

• GuardDuty.Client.exceptions.InternalServerErrorException