/AWS1/CL_CWL=>PUTDESTINATION()

About PutDestination

Creates or updates a destination. This operation is used only to create destinations for cross-account subscriptions.

A destination encapsulates a physical resource (such as an Amazon Kinesis stream). With a destination, you can subscribe to a real-time stream of log events for a different account, ingested using PutLogEvents.

Through an access policy, a destination controls what is written to it. By default, PutDestination does not set any access policy with the destination, which means a cross-account user cannot call PutSubscriptionFilter against this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination.

To perform a PutDestination operation, you must also have the iam:PassRole permission.

Method Signature

IMPORTING

Required arguments:

IV_DESTINATIONNAME TYPE /AWS1/CWLDESTINATIONNAME /AWS1/CWLDESTINATIONNAME

A name for the destination.

IV_TARGETARN TYPE /AWS1/CWLTARGETARN /AWS1/CWLTARGETARN

The ARN of an Amazon Kinesis stream to which to deliver matching log events.

IV_ROLEARN TYPE /AWS1/CWLROLEARN /AWS1/CWLROLEARN

The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis PutRecord operation on the destination stream.

Optional arguments:

IT_TAGS TYPE /AWS1/CL_CWLTAGS_W=>TT_TAGS TT_TAGS

An optional list of key-value pairs to associate with the resource.

For more information about tagging, see Tagging Amazon Web Services resources

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_CWLPUTDSTRESPONSE /AWS1/CL_CWLPUTDSTRESPONSE