GET Distribution Config

Description

To get a distribution's configuration information, you do a GET on the 2009-12-01/distribution/<distribution ID>/config resource.

Requests

Syntax

GET /2009-12-01/distribution/<distribution ID>/config HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: [AWS authentication string]
Date: [time stamp]
[Other required headers]

Headers

The request must include the headers required in all CloudFront requests. For more information, see Common REST Headers.

Responses

Syntax

200 OK
ETag: [ETag value to use later when doing a PUT on the config]
x-amz-request-id: [Request ID]

<?xml version="1.0" encoding="UTF-8"?>
<DistributionConfig xmlns="http://cloudfront.amazonaws.com/doc/2009-12-01/">
   ...
   See the description of the DistributionConfig element
   for a list of child elements that can appear here
   ...
</DistributionConfig>

Headers

NameDescription

ETag

The current version of the configuration. For example: E2QWRUHAPOMQZL. For information about using the ETag header value, go to Updating a Distribution's Configuration and Deleting a Distribution in the Amazon CloudFront Developer Guide.

Type: String

Elements

NameDescription

DistributionConfig

The distribution's configuration information. For more information, see DistributionConfig Complex Type.

Type: DistributionConfig complex type

Special Errors

The following table lists the special errors returned in addition to the common errors all actions return (for more information, see Errors).

ErrorDescriptionHTTP Status Code

NoSuchDistribution

The specified distribution does not exist.

404

Examples

The following example request gets the configuration information for the EDFDVBD632BHDS5 distribution.

Sample Request

GET /2009-12-01/distribution/EDFDVBD632BHDS5/config HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS O39F6A430S6FJNPPGDR2:frJIUN8DYpKDtOLEXAMPLE=
Date: Thu, 19 Nov 2009 19:37:58 GMT
[Other required headers]

Sample Response

200 OK
ETag: E2QWRUHAPOMQZL
x-amz-request-id: request_id

<?xml version="1.0" encoding="UTF-8"?>
<DistributionConfig xmlns="http://cloudfront.amazonaws.com/doc/2009-12-01/">
   <Origin>mybucket.s3.amazonaws.com</Origin>
   <CallerReference>20091130090000</CallerReference>
   <CNAME>beagles.com</CNAME>
   <Comment>My comments</Comment>
   <Enabled>true</Enabled>
   <Logging>
      <Bucket>mylogs.s3.amazonaws.com</Bucket>
      <Prefix>myprefix/</Prefix>
   </Logging>
</DistributionConfig>

Related Actions