cloudwatchlogs_put_destination: Creates or updates a destination

Description Usage Arguments Value Request syntax

View source: R/cloudwatchlogs_operations.R

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

Through an access policy, a destination controls what is written to it. By default, put_destination does not set any access policy with the destination, which means a cross-account user cannot call put_subscription_filter against this destination. To enable this, the destination owner must call put_destination_policy after put_destination.

To perform a put_destination operation, you must also have the iam:PassRole permission.

Usage

1
cloudwatchlogs_put_destination(destinationName, targetArn, roleArn)

Arguments

destinationName

[required] A name for the destination.

targetArn

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

roleArn

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

Value

A list with the following syntax:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
list(
  destination = list(
    destinationName = "string",
    targetArn = "string",
    roleArn = "string",
    accessPolicy = "string",
    arn = "string",
    creationTime = 123
  )
)

Request syntax

1
2
3
4
5
svc$put_destination(
  destinationName = "string",
  targetArn = "string",
  roleArn = "string"
)

paws.management documentation built on Aug. 23, 2021, 9:11 a.m.