amazonka-cloudwatch-logs-1.4.0: Amazon CloudWatch Logs SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.CloudWatchLogs.PutDestination

Contents

Description

Creates or updates a Destination. A destination encapsulates a physical resource (such as a Kinesis stream) and allows you to subscribe to a real-time stream of log events of a different account, ingested through PutLogEvents requests. Currently, the only supported physical resource is a Amazon Kinesis stream belonging to the same account as the destination.

A destination controls what is written to its Amazon Kinesis stream through an access policy. By default, PutDestination does not set any access policy with the destination, which means a cross-account user will not be able to call PutSubscriptionFilter against this destination. To enable that, the destination owner must call PutDestinationPolicy after PutDestination.

Synopsis

Creating a Request

putDestination Source

Creates a value of PutDestination with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

pdDestinationName :: Lens' PutDestination Text Source

A name for the destination.

pdTargetARN :: Lens' PutDestination Text Source

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

pdRoleARN :: Lens' PutDestination Text Source

The ARN of an IAM role that grants CloudWatch Logs permissions to do Amazon Kinesis PutRecord requests on the desitnation stream.

Destructuring the Response

putDestinationResponse Source

Creates a value of PutDestinationResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses