AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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.
For .NET Core this operation is only available in asynchronous form. Please refer to PutDestinationAsync.
Namespace: Amazon.CloudWatchLogs
Assembly: AWSSDK.CloudWatchLogs.dll
Version: 3.x.y.z
public abstract PutDestinationResponse PutDestination( PutDestinationRequest request )
Container for the necessary parameters to execute the PutDestination service method.
| Exception | Condition |
|---|---|
| InvalidParameterException | A parameter is specified incorrectly. |
| OperationAbortedException | Multiple concurrent requests to update the same resource were in conflict. |
| ServiceUnavailableException | The service cannot complete the request. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5