Struct aws_sdk_cloudfront::client::fluent_builders::UpdateDistribution

pub struct UpdateDistribution { /* private fields */ }

Fluent builder constructing a request to UpdateDistribution.

Updates the configuration for a CloudFront distribution.

The update process includes getting the current distribution configuration, updating it to make your changes, and then submitting an UpdateDistribution request to make the updates.

To update a web distribution using the CloudFront API

1. Use GetDistributionConfig to get the current configuration, including the version identifier (ETag).

2. Update the distribution configuration that was returned in the response. Note the following important requirements and restrictions:

   • You must rename the ETag field to IfMatch, leaving the value unchanged. (Set the value of IfMatch to the value of ETag, then remove the ETag field.)

   • You can't change the value of CallerReference.

3. Submit an UpdateDistribution request, providing the distribution configuration. The new configuration replaces the existing configuration. The values that you specify in an UpdateDistribution request are not merged into your existing configuration. Make sure to include all fields: the ones that you modified and also the ones that you didn't.

Implementations

impl UpdateDistribution

pub async fn customize(
    self
) -> Result<CustomizableOperation<UpdateDistribution, AwsResponseRetryClassifier>, SdkError<UpdateDistributionError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<UpdateDistributionOutput, SdkError<UpdateDistributionError>>

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 distribution_config(self, input: DistributionConfig) -> Self

The distribution's configuration information.

pub fn set_distribution_config(self, input: Option<DistributionConfig>) -> Self

The distribution's configuration information.

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

The distribution's id.

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

The distribution's id.

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

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

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

The value of the ETag header that you received when retrieving the distribution's configuration. For example: E2QWRUHAPOMQZL.

Trait Implementations

impl Clone for UpdateDistribution

fn clone(&self) -> UpdateDistribution

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateDistribution

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

Formats the value using the given formatter.