Copyright | (c) 2013-2017 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Creates or updates a destination. A destination encapsulates a physical resource (such as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events for a different account, ingested using PutLogEvents
. Currently, the only supported physical resource is a Kinesis stream belonging to the same account as the destination.
Through an access policy, a destination controls what is written to its Kinesis stream. 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
.
- putDestination :: Text -> Text -> Text -> PutDestination
- data PutDestination
- pdDestinationName :: Lens' PutDestination Text
- pdTargetARN :: Lens' PutDestination Text
- pdRoleARN :: Lens' PutDestination Text
- putDestinationResponse :: Int -> PutDestinationResponse
- data PutDestinationResponse
- pdrsDestination :: Lens' PutDestinationResponse (Maybe Destination)
- pdrsResponseStatus :: Lens' PutDestinationResponse Int
Creating a Request
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:
pdDestinationName
- A name for the destination.pdTargetARN
- The ARN of an Amazon Kinesis stream to which to deliver matching log events.pdRoleARN
- The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis PutRecord operation on the destination stream.
data PutDestination Source #
See: putDestination
smart constructor.
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 which to deliver matching log events.
pdRoleARN :: Lens' PutDestination Text Source #
The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis PutRecord operation on the destination 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:
pdrsDestination
- The destination.pdrsResponseStatus
- -- | The response status code.
data PutDestinationResponse Source #
See: putDestinationResponse
smart constructor.
Response Lenses
pdrsDestination :: Lens' PutDestinationResponse (Maybe Destination) Source #
The destination.
pdrsResponseStatus :: Lens' PutDestinationResponse Int Source #
- - | The response status code.