Copyright	(c) 2013-2021 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

Amazonka.CloudWatchLogs.PutDestination

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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) and enables you to 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.

Creating a Request

data PutDestination Source #

See: newPutDestination smart constructor.

Constructors

PutDestination'
Fields destinationName :: Text A name for the destination. targetArn :: Text The ARN of an Amazon Kinesis stream to which to deliver matching log events. roleArn :: Text The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis `PutRecord` operation on the destination stream.

Instances

Instances details

Eq PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods (==) :: PutDestination -> PutDestination -> Bool # (/=) :: PutDestination -> PutDestination -> Bool #
Read PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods readsPrec :: Int -> ReadS PutDestination # readList :: ReadS [PutDestination] # readPrec :: ReadPrec PutDestination # readListPrec :: ReadPrec [PutDestination] #
Show PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods showsPrec :: Int -> PutDestination -> ShowS # show :: PutDestination -> String # showList :: [PutDestination] -> ShowS #
Generic PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Associated Types type Rep PutDestination :: Type -> Type # Methods from :: PutDestination -> Rep PutDestination x # to :: Rep PutDestination x -> PutDestination #
NFData PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods rnf :: PutDestination -> () #
Hashable PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods hashWithSalt :: Int -> PutDestination -> Int # hash :: PutDestination -> Int #
ToJSON PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods toJSON :: PutDestination -> Value # toEncoding :: PutDestination -> Encoding # toJSONList :: [PutDestination] -> Value # toEncodingList :: [PutDestination] -> Encoding #
AWSRequest PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Associated Types type AWSResponse PutDestination # Methods request :: PutDestination -> Request PutDestination # response :: MonadResource m => Logger -> Service -> Proxy PutDestination -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse PutDestination))) #
ToHeaders PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods toHeaders :: PutDestination -> [Header] #
ToPath PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods toPath :: PutDestination -> ByteString #
ToQuery PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods toQuery :: PutDestination -> QueryString #
type Rep PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination type Rep PutDestination = D1 ('MetaData "PutDestination" "Amazonka.CloudWatchLogs.PutDestination" "libZSservicesZSamazonka-cloudwatch-logsZSamazonka-cloudwatch-logs" 'False) (C1 ('MetaCons "PutDestination'" 'PrefixI 'True) (S1 ('MetaSel ('Just "destinationName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: (S1 ('MetaSel ('Just "targetArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: S1 ('MetaSel ('Just "roleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))
type AWSResponse PutDestination Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination type AWSResponse PutDestination = PutDestinationResponse

newPutDestination Source #

Arguments

:: Text	`$sel:destinationName:PutDestination'`
-> Text	`$sel:targetArn:PutDestination'`
-> Text	`$sel:roleArn:PutDestination'`
-> PutDestination

Create a value of PutDestination with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:destinationName:PutDestination', putDestination_destinationName - A name for the destination.

$sel:targetArn:PutDestination', putDestination_targetArn - The ARN of an Amazon Kinesis stream to which to deliver matching log events.

$sel:roleArn:PutDestination', putDestination_roleArn - The ARN of an IAM role that grants CloudWatch Logs permissions to call the Amazon Kinesis PutRecord operation on the destination stream.

Request Lenses

putDestination_destinationName :: Lens' PutDestination Text Source #

A name for the destination.

putDestination_targetArn :: Lens' PutDestination Text Source #

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

putDestination_roleArn :: 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

data PutDestinationResponse Source #

See: newPutDestinationResponse smart constructor.

Constructors

PutDestinationResponse'
Fields destination :: Maybe Destination The destination. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods (==) :: PutDestinationResponse -> PutDestinationResponse -> Bool # (/=) :: PutDestinationResponse -> PutDestinationResponse -> Bool #
Read PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods readsPrec :: Int -> ReadS PutDestinationResponse # readList :: ReadS [PutDestinationResponse] # readPrec :: ReadPrec PutDestinationResponse # readListPrec :: ReadPrec [PutDestinationResponse] #
Show PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods showsPrec :: Int -> PutDestinationResponse -> ShowS # show :: PutDestinationResponse -> String # showList :: [PutDestinationResponse] -> ShowS #
Generic PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Associated Types type Rep PutDestinationResponse :: Type -> Type # Methods from :: PutDestinationResponse -> Rep PutDestinationResponse x # to :: Rep PutDestinationResponse x -> PutDestinationResponse #
NFData PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination Methods rnf :: PutDestinationResponse -> () #
type Rep PutDestinationResponse Source #
Instance details Defined in Amazonka.CloudWatchLogs.PutDestination type Rep PutDestinationResponse = D1 ('MetaData "PutDestinationResponse" "Amazonka.CloudWatchLogs.PutDestination" "libZSservicesZSamazonka-cloudwatch-logsZSamazonka-cloudwatch-logs" 'False) (C1 ('MetaCons "PutDestinationResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "destination") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Destination)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newPutDestinationResponse Source #

Arguments

:: Int	`$sel:httpStatus:PutDestinationResponse'`
-> PutDestinationResponse

Create a value of PutDestinationResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:destination:PutDestinationResponse', putDestinationResponse_destination - The destination.

$sel:httpStatus:PutDestinationResponse', putDestinationResponse_httpStatus - The response's http status code.

Response Lenses

putDestinationResponse_destination :: Lens' PutDestinationResponse (Maybe Destination) Source #

The destination.

putDestinationResponse_httpStatus :: Lens' PutDestinationResponse Int Source #

The response's http status code.