Struct aws_sdk_cloudwatchlogs::operation::put_destination::builders::PutDestinationFluentBuilder

pub struct PutDestinationFluentBuilder { /* 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). With a destination, you can 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 PutDestinationFluentBuilder

pub fn as_input(&self) -> &PutDestinationInputBuilder

Access the PutDestination as a reference.

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

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 customize( self, ) -> CustomizableOperation<PutDestinationOutput, PutDestinationError, Self>

Consumes this builder, creating a customizable operation that can be modified before being sent.

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 get_destination_name(&self) -> &Option<String>

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 get_target_arn(&self) -> &Option<String>

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.

pub fn get_role_arn(&self) -> &Option<String>

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

pub fn tags(self, k: impl Into<String>, v: impl Into<String>) -> Self

Adds a key-value pair to tags.

To override the contents of this collection use set_tags.

An optional list of key-value pairs to associate with the resource.

For more information about tagging, see Tagging Amazon Web Services resources

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

An optional list of key-value pairs to associate with the resource.

For more information about tagging, see Tagging Amazon Web Services resources

pub fn get_tags(&self) -> &Option<HashMap<String, String>>

An optional list of key-value pairs to associate with the resource.

For more information about tagging, see Tagging Amazon Web Services resources

Trait Implementations

impl Clone for PutDestinationFluentBuilder

fn clone(&self) -> PutDestinationFluentBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PutDestinationFluentBuilder

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

Formats the value using the given formatter.