Menu
Amazon CloudFront
API Reference (API Version 2016-09-29)

UpdateStreamingDistribution

Update a streaming distribution.

Request Syntax

PUT /2016-09-29/streaming-distribution/Id/config HTTP/1.1
If-Match: IfMatch
<?xml version="1.0" encoding="UTF-8"?>
<UpdateStreamingDistributionRequest>
   <StreamingDistributionConfig>
      <Aliases>
         <Items>
            <CNAME>string</CNAME></Items>
         <Quantity>integer</Quantity>
      </Aliases>
      <CallerReference>string</CallerReference>
      <Comment>string</Comment>
      <Enabled>boolean</Enabled>
      <Logging>
         <Bucket>string</Bucket>
         <Enabled>boolean</Enabled>
         <Prefix>string</Prefix>
      </Logging>
      <PriceClass>string</PriceClass>
      <S3Origin>
         <DomainName>string</DomainName>
         <OriginAccessIdentity>string</OriginAccessIdentity>
      </S3Origin>
      <TrustedSigners>
         <Enabled>boolean</Enabled>
         <Items>
            <AwsAccountNumber>string</AwsAccountNumber></Items>
         <Quantity>integer</Quantity>
      </TrustedSigners>
   </StreamingDistributionConfig>
</UpdateStreamingDistributionRequest>

URI Request Parameters

The request requires the following URI parameters.

Id

The streaming distribution's id.

If-Match

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

Request Body

The request requires the following data in XML format.

UpdateStreamingDistributionRequest

Root level tag for the UpdateStreamingDistributionRequest parameters.

Required: Yes

StreamingDistributionConfig

The streaming distribution's configuration information.

Type: StreamingDistributionConfig object

Required: Yes

Response Syntax

HTTP/1.1 200
ETag: ETag
<?xml version="1.0" encoding="UTF-8"?>
<UpdateStreamingDistributionResult>
   <StreamingDistribution>
      <ActiveTrustedSigners>
         <Enabled>boolean</Enabled>
         <Items>
            <Signer>
               <AwsAccountNumber>string</AwsAccountNumber>
               <KeyPairIds>
                  <Items>
                     <KeyPairId>string</KeyPairId></Items>
                  <Quantity>integer</Quantity>
               </KeyPairIds>
            </Signer></Items>
         <Quantity>integer</Quantity>
      </ActiveTrustedSigners>
      <ARN>string</ARN>
      <DomainName>string</DomainName>
      <Id>string</Id>
      <LastModifiedTime>timestamp</LastModifiedTime>
      <Status>string</Status>
      <StreamingDistributionConfig>
         <Aliases>
            <Items>
               <CNAME>string</CNAME></Items>
            <Quantity>integer</Quantity>
         </Aliases>
         <CallerReference>string</CallerReference>
         <Comment>string</Comment>
         <Enabled>boolean</Enabled>
         <Logging>
            <Bucket>string</Bucket>
            <Enabled>boolean</Enabled>
            <Prefix>string</Prefix>
         </Logging>
         <PriceClass>string</PriceClass>
         <S3Origin>
            <DomainName>string</DomainName>
            <OriginAccessIdentity>string</OriginAccessIdentity>
         </S3Origin>
         <TrustedSigners>
            <Enabled>boolean</Enabled>
            <Items>
               <AwsAccountNumber>string</AwsAccountNumber></Items>
            <Quantity>integer</Quantity>
         </TrustedSigners>
      </StreamingDistributionConfig>
   </StreamingDistribution>
</UpdateStreamingDistributionResult>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The response returns the following HTTP headers.

ETag

The current version of the configuration. For example: E2QWRUHAPOMQZL.

The following data is returned in XML format by the service.

UpdateStreamingDistributionResult

Root level tag for the UpdateStreamingDistributionResult parameters.

Required: Yes

StreamingDistribution

The streaming distribution's information.

Type: StreamingDistribution object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

CNAMEAlreadyExists

HTTP Status Code: 409

IllegalUpdate

Origin and CallerReference cannot be updated.

HTTP Status Code: 400

InconsistentQuantities

The value of Quantity and the size of Items do not match.

HTTP Status Code: 400

InvalidArgument

The argument is invalid.

HTTP Status Code: 400

InvalidIfMatchVersion

The If-Match version is missing or not valid for the distribution.

HTTP Status Code: 400

InvalidOriginAccessIdentity

The origin access identity is not valid or doesn't exist.

HTTP Status Code: 400

MissingBody

This operation requires a body. Ensure that the body is present and the Content-Type header is set.

HTTP Status Code: 400

NoSuchStreamingDistribution

The specified streaming distribution does not exist.

HTTP Status Code: 404

PreconditionFailed

The precondition given in one or more of the request-header fields evaluated to false.

HTTP Status Code: 412

TooManyStreamingDistributionCNAMEs

HTTP Status Code: 400

TooManyTrustedSigners

Your request contains more trusted signers than are allowed per distribution.

HTTP Status Code: 400

TrustedSignerDoesNotExist

One or more of your trusted signers do not exist.

HTTP Status Code: 400