Struct aws_sdk_cloudwatchlogs::client::fluent_builders::PutDestination

pub struct PutDestination { /* private fields */ }

Fluent builder constructing a request to PutDestination.

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.

Implementations

impl PutDestination

pub async fn send(
    self
) -> Result<PutDestinationOutput, SdkError<PutDestinationError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn destination_name(self, input: impl Into<String>) -> Self

A name for the destination.

pub fn set_destination_name(self, input: Option<String>) -> Self

A name for the destination.

pub fn target_arn(self, input: impl Into<String>) -> Self

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

pub fn set_target_arn(self, input: Option<String>) -> Self

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

pub fn role_arn(self, input: impl Into<String>) -> Self

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

pub fn set_role_arn(self, input: Option<String>) -> Self

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

Trait Implementations

impl Clone for PutDestination

fn clone(&self) -> PutDestination

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PutDestination

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.