AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the UpdateDistribution operation. Updates the configuration for a web distribution. Perform the following steps.
For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console in the Amazon CloudFront Developer Guide.
To update a web distribution using the CloudFront API
Submit a GetDistributionConfig request to get the current configuration and
Etag header for the distribution.
If you update the distribution again, you need to get a new
Update the XML document that was returned in the response to your
request to include the desired changes. You can't change the value of
If you try to change this value, CloudFront returns an
error. Note that you must strip out the ETag parameter that is returned.
The new configuration replaces the existing configuration; the values that you specify
UpdateDistribution request are not merged into the existing configuration.
When you add, delete, or replace values in an element that allows multiple values
CNAME), you must specify all of the values that you want
to appear in the updated distribution. In addition, you must update the corresponding
UpdateDistribution request to update the configuration for
In the request body, include the XML document that you updated in Step 2. The request
body must include an XML document with a
Set the value of the HTTP
If-Match header to the value of the
header that CloudFront returned when you submitted the
request in Step 1.
Review the response to the
UpdateDistribution request to confirm that
the configuration was successfully updated.
Optional: Submit a GetDistribution request to confirm that your changes have
propagated. When propagation is complete, the value of
Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes
to the format of the XML document that you include in the request body when you create
or update a distribution. With previous versions of the API, we discovered that it
was too easy to accidentally delete one or more values for an element that accepts
multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05
release are intended to prevent these accidental deletions and to notify you when
there's a mismatch between the number of values you say you're specifying in the
element and the number of values you're actually specifying.
public class UpdateDistributionRequest : AmazonCloudFrontRequest IAmazonWebServiceRequest
The UpdateDistributionRequest type exposes the following members
Empty constructor used to set properties independently even when a simple constructor is available
|UpdateDistributionRequest(string, string, DistributionConfig)||
Instantiates UpdateDistributionRequest with the parameterized properties
Gets and sets the property DistributionConfig.
The distribution's configuration information.
Gets and sets the property Id.
The distribution's id.
Gets and sets the property IfMatch.
The value of the
Supported in: 1.3
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms