Network.AWS.CloudWatchLogs.PutDestination

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 .

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

See: putDestination smart constructor.

Instances

Eq PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

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

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

Data PutDestination

Defined in Network.AWS.CloudWatchLogs.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

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

readsPrec :: Int -> ReadS PutDestination

readList :: ReadS [PutDestination]

readPrec :: ReadPrec PutDestination

readListPrec :: ReadPrec [PutDestination]

Show PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

showsPrec :: Int -> PutDestination -> ShowS

show :: PutDestination -> String

showList :: [PutDestination] -> ShowS

Generic PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Associated Types

type Rep PutDestination :: Type -> Type

Methods

from :: PutDestination -> Rep PutDestination x

to :: Rep PutDestination x -> PutDestination

Hashable PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

hashWithSalt :: Int -> PutDestination -> Int

hash :: PutDestination -> Int

ToJSON PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

toJSON :: PutDestination -> Value

toEncoding :: PutDestination -> Encoding

toJSONList :: [PutDestination] -> Value

toEncodingList :: [PutDestination] -> Encoding

AWSRequest PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Associated Types

type Rs PutDestination :: Type

Methods

request :: PutDestination -> Request PutDestination

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

ToHeaders PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

toHeaders :: PutDestination -> [Header]

ToPath PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

toPath :: PutDestination -> ByteString

ToQuery PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

toQuery :: PutDestination -> QueryString

NFData PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

rnf :: PutDestination -> ()

type Rep PutDestination

Defined in Network.AWS.CloudWatchLogs.PutDestination

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

type Rs PutDestination

Defined in Network.AWS.CloudWatchLogs.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 which to deliver matching log events.

pdRoleARN :: Lens' PutDestination Text

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

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

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

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

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

Data PutDestinationResponse

Defined in Network.AWS.CloudWatchLogs.PutDestination

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

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

readsPrec :: Int -> ReadS PutDestinationResponse

readList :: ReadS [PutDestinationResponse]

readPrec :: ReadPrec PutDestinationResponse

readListPrec :: ReadPrec [PutDestinationResponse]

Show PutDestinationResponse

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

showsPrec :: Int -> PutDestinationResponse -> ShowS

show :: PutDestinationResponse -> String

showList :: [PutDestinationResponse] -> ShowS

Generic PutDestinationResponse

Defined in Network.AWS.CloudWatchLogs.PutDestination

Associated Types

type Rep PutDestinationResponse :: Type -> Type

Methods

from :: PutDestinationResponse -> Rep PutDestinationResponse x

to :: Rep PutDestinationResponse x -> PutDestinationResponse

NFData PutDestinationResponse

Defined in Network.AWS.CloudWatchLogs.PutDestination

Methods

rnf :: PutDestinationResponse -> ()

type Rep PutDestinationResponse

Defined in Network.AWS.CloudWatchLogs.PutDestination

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

Response Lenses

pdrsDestination :: Lens' PutDestinationResponse (Maybe Destination)

The destination.

pdrsResponseStatus :: Lens' PutDestinationResponse Int

• - | The response status code.