Network.AWS.CloudWatchLogs.PutDestination

Creates or updates a destination. A destination encapsulates a physical resource (such as a Kinesis stream) and enables you to subscribe to a real-time stream of log events of a different account, ingested using PutLogEvents . 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 cannot call PutSubscriptionFilter against this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination .

Creating a Request

putDestination

Arguments

:: Text

pdDestinationName

-> Text

pdTargetARN

-> Text

pdRoleARN

-> PutDestination

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 deliver matching log events to.
• pdRoleARN - The ARN of an IAM role that grants CloudWatch Logs permissions to call Amazon Kinesis PutRecord on the destination stream.

data PutDestination

See: putDestination smart constructor.

Instances

Eq PutDestination

Methods

(==) :: PutDestination -> PutDestination -> Bool

(/=) :: PutDestination -> PutDestination -> Bool

Data PutDestination

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PutDestination -> c PutDestination

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PutDestination

toConstr :: PutDestination -> Constr

dataTypeOf :: PutDestination -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c PutDestination)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PutDestination)

gmapT :: (forall b. Data b => b -> b) -> PutDestination -> PutDestination

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PutDestination -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PutDestination -> r

gmapQ :: (forall d. Data d => d -> u) -> PutDestination -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PutDestination -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PutDestination -> m PutDestination

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PutDestination -> m PutDestination

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PutDestination -> m PutDestination

Read PutDestination

Methods

readsPrec :: Int -> ReadS PutDestination

readList :: ReadS [PutDestination]

readPrec :: ReadPrec PutDestination

readListPrec :: ReadPrec [PutDestination]

Show PutDestination

Methods

showsPrec :: Int -> PutDestination -> ShowS

show :: PutDestination -> String

showList :: [PutDestination] -> ShowS

Generic PutDestination

Associated Types

type Rep PutDestination :: * -> *

Methods

from :: PutDestination -> Rep PutDestination x

to :: Rep PutDestination x -> PutDestination

Hashable PutDestination

Methods

hashWithSalt :: Int -> PutDestination -> Int

hash :: PutDestination -> Int

ToJSON PutDestination

Methods

toJSON :: PutDestination -> Value

toEncoding :: PutDestination -> Encoding

toJSONList :: [PutDestination] -> Value

toEncodingList :: [PutDestination] -> Encoding

NFData PutDestination

Methods

rnf :: PutDestination -> ()

AWSRequest PutDestination

Associated Types

type Rs PutDestination :: *

Methods

request :: PutDestination -> Request PutDestination

response :: MonadResource m => Logger -> Service -> Proxy * PutDestination -> ClientResponse -> m (Response PutDestination)

ToPath PutDestination

Methods

toPath :: PutDestination -> ByteString

ToHeaders PutDestination

Methods

toHeaders :: PutDestination -> [Header]

ToQuery PutDestination

Methods

toQuery :: PutDestination -> QueryString

type Rep PutDestination

type Rep PutDestination = D1 (MetaData "PutDestination" "Network.AWS.CloudWatchLogs.PutDestination" "amazonka-cloudwatch-logs-1.4.5-JoaCELOvIeKI9iDLq1iWip" False) (C1 (MetaCons "PutDestination'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_pdDestinationName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) ((:*:) (S1 (MetaSel (Just Symbol "_pdTargetARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_pdRoleARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs PutDestination

type Rs PutDestination = PutDestinationResponse

Request Lenses

pdDestinationName :: Lens' PutDestination Text

A name for the destination.

pdTargetARN :: Lens' PutDestination Text

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

pdRoleARN :: Lens' PutDestination Text

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

Destructuring the Response

putDestinationResponse

Arguments

:: Int

pdrsResponseStatus

-> PutDestinationResponse

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

See: putDestinationResponse smart constructor.

Instances

Eq PutDestinationResponse

Methods

(==) :: PutDestinationResponse -> PutDestinationResponse -> Bool

(/=) :: PutDestinationResponse -> PutDestinationResponse -> Bool

Data PutDestinationResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> PutDestinationResponse -> c PutDestinationResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c PutDestinationResponse

toConstr :: PutDestinationResponse -> Constr

dataTypeOf :: PutDestinationResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c PutDestinationResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c PutDestinationResponse)

gmapT :: (forall b. Data b => b -> b) -> PutDestinationResponse -> PutDestinationResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> PutDestinationResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> PutDestinationResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> PutDestinationResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> PutDestinationResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> PutDestinationResponse -> m PutDestinationResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> PutDestinationResponse -> m PutDestinationResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> PutDestinationResponse -> m PutDestinationResponse

Read PutDestinationResponse

Methods

readsPrec :: Int -> ReadS PutDestinationResponse

readList :: ReadS [PutDestinationResponse]

readPrec :: ReadPrec PutDestinationResponse

readListPrec :: ReadPrec [PutDestinationResponse]

Show PutDestinationResponse

Methods

showsPrec :: Int -> PutDestinationResponse -> ShowS

show :: PutDestinationResponse -> String

showList :: [PutDestinationResponse] -> ShowS

Generic PutDestinationResponse

Associated Types

type Rep PutDestinationResponse :: * -> *

Methods

from :: PutDestinationResponse -> Rep PutDestinationResponse x

to :: Rep PutDestinationResponse x -> PutDestinationResponse

NFData PutDestinationResponse

Methods

rnf :: PutDestinationResponse -> ()

type Rep PutDestinationResponse

type Rep PutDestinationResponse = D1 (MetaData "PutDestinationResponse" "Network.AWS.CloudWatchLogs.PutDestination" "amazonka-cloudwatch-logs-1.4.5-JoaCELOvIeKI9iDLq1iWip" False) (C1 (MetaCons "PutDestinationResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_pdrsDestination") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Destination))) (S1 (MetaSel (Just Symbol "_pdrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int))))

Response Lenses

pdrsDestination :: Lens' PutDestinationResponse (Maybe Destination)

The destination.

pdrsResponseStatus :: Lens' PutDestinationResponse Int

• - | The response status code.