aws_sdk_cloudwatchlogs/client/
put_destination_policy.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`PutDestinationPolicy`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`destination_name(impl Into<String>)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::destination_name) / [`set_destination_name(Option<String>)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::set_destination_name):<br>required: **true**<br><p>A name for an existing destination.</p><br>
    ///   - [`access_policy(impl Into<String>)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::access_policy) / [`set_access_policy(Option<String>)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::set_access_policy):<br>required: **true**<br><p>An IAM policy document that authorizes cross-account users to deliver their log events to the associated destination. This can be up to 5120 bytes.</p><br>
    ///   - [`force_update(bool)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::force_update) / [`set_force_update(Option<bool>)`](crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::set_force_update):<br>required: **false**<br><p>Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual Amazon Web Services accounts. Before you update a destination policy this way, you must first update the subscription filters in the accounts that send logs to this destination. If you do not, the subscription filters might stop working. By specifying <code>true</code> for <code>forceUpdate</code>, you are affirming that you have already updated the subscription filters. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Cross-Account-Log_Subscription-Update.html"> Updating an existing cross-account subscription</a></p> <p>If you omit this parameter, the default of <code>false</code> is used.</p><br>
    /// - On success, responds with [`PutDestinationPolicyOutput`](crate::operation::put_destination_policy::PutDestinationPolicyOutput)
    /// - On failure, responds with [`SdkError<PutDestinationPolicyError>`](crate::operation::put_destination_policy::PutDestinationPolicyError)
    pub fn put_destination_policy(&self) -> crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder {
        crate::operation::put_destination_policy::builders::PutDestinationPolicyFluentBuilder::new(self.handle.clone())
    }
}