aws_sdk_cloudwatchlogs/client/

put_delivery_destination.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`PutDeliveryDestination`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`name(impl Into<String>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::name) / [`set_name(Option<String>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::set_name):<br>required: **true**<br><p>A name for this delivery destination. This name must be unique for all delivery destinations in your account.</p><br>
    ///   - [`output_format(OutputFormat)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::output_format) / [`set_output_format(Option<OutputFormat>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::set_output_format):<br>required: **false**<br><p>The format for the logs that this delivery destination will receive.</p><br>
    ///   - [`delivery_destination_configuration(DeliveryDestinationConfiguration)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::delivery_destination_configuration) / [`set_delivery_destination_configuration(Option<DeliveryDestinationConfiguration>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::set_delivery_destination_configuration):<br>required: **false**<br><p>A structure that contains the ARN of the Amazon Web Services resource that will receive the logs.</p><note>  <p><code>deliveryDestinationConfiguration</code> is required for CloudWatch Logs, Amazon S3, Firehose log delivery destinations and not required for X-Ray trace delivery destinations. <code>deliveryDestinationType</code> is needed for X-Ray trace delivery destinations but not required for other logs delivery destinations.</p> </note><br>
    ///   - [`delivery_destination_type(DeliveryDestinationType)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::delivery_destination_type) / [`set_delivery_destination_type(Option<DeliveryDestinationType>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::set_delivery_destination_type):<br>required: **false**<br><p>The type of delivery destination. This parameter specifies the target service where log data will be delivered. Valid values include:</p> <ul>  <li>   <p><code>S3</code> - Amazon S3 for long-term storage and analytics</p></li>  <li>   <p><code>CWL</code> - CloudWatch Logs for centralized log management</p></li>  <li>   <p><code>FH</code> - Amazon Kinesis Data Firehose for real-time data streaming</p></li>  <li>   <p><code>XRAY</code> - Amazon Web Services X-Ray for distributed tracing and application monitoring</p></li> </ul> <p>The delivery destination type determines the format and configuration options available for log delivery.</p><br>
    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::set_tags):<br>required: **false**<br><p>An optional list of key-value pairs to associate with the resource.</p> <p>For more information about tagging, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a></p><br>
    /// - On success, responds with [`PutDeliveryDestinationOutput`](crate::operation::put_delivery_destination::PutDeliveryDestinationOutput) with field(s):
    ///   - [`delivery_destination(Option<DeliveryDestination>)`](crate::operation::put_delivery_destination::PutDeliveryDestinationOutput::delivery_destination): <p>A structure containing information about the delivery destination that you just created or updated.</p>
    /// - On failure, responds with [`SdkError<PutDeliveryDestinationError>`](crate::operation::put_delivery_destination::PutDeliveryDestinationError)
    pub fn put_delivery_destination(&self) -> crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder {
        crate::operation::put_delivery_destination::builders::PutDeliveryDestinationFluentBuilder::new(self.handle.clone())
    }
}