class Aws::CloudWatchLogs::Types::PutSubscriptionFilterRequest

@note When making an API call, you may pass PutSubscriptionFilterRequest

data as a hash:

    {
      log_group_name: "LogGroupName", # required
      filter_name: "FilterName", # required
      filter_pattern: "FilterPattern", # required
      destination_arn: "DestinationArn", # required
      role_arn: "RoleArn",
      distribution: "Random", # accepts Random, ByLogStream
    }

@!attribute [rw] log_group_name

The name of the log group.
@return [String]

@!attribute [rw] filter_name

A name for the subscription filter. If you are updating an existing
filter, you must specify the correct name in `filterName`. To find
the name of the filter currently associated with a log group, use
[DescribeSubscriptionFilters][1].

[1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html
@return [String]

@!attribute [rw] filter_pattern

A filter pattern for subscribing to a filtered stream of log events.
@return [String]

@!attribute [rw] destination_arn

The ARN of the destination to deliver matching log events to.
Currently, the supported destinations are:

* An Amazon Kinesis stream belonging to the same account as the
  subscription filter, for same-account delivery.

* A logical destination (specified using an ARN) belonging to a
  different account, for cross-account delivery.

  If you are setting up a cross-account subscription, the
  destination must have an IAM policy associated with it that allows
  the sender to send logs to the destination. For more information,
  see [PutDestinationPolicy][1].

* An Amazon Kinesis Firehose delivery stream belonging to the same
  account as the subscription filter, for same-account delivery.

* A Lambda function belonging to the same account as the
  subscription filter, for same-account delivery.

[1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html
@return [String]

@!attribute [rw] role_arn

The ARN of an IAM role that grants CloudWatch Logs permissions to
deliver ingested log events to the destination stream. You don't
need to provide the ARN when you are working with a logical
destination for cross-account delivery.
@return [String]

@!attribute [rw] distribution

The method used to distribute log data to the destination. By
default, log data is grouped by log stream, but the grouping can be
set to random for a more even distribution. This property is only
applicable when the destination is an Amazon Kinesis stream.
@return [String]

@see docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutSubscriptionFilterRequest AWS API Documentation

Constants

SENSITIVE