Amazon CloudFront
API Reference (API Version 2010-11-01)
AWS Documentation » Amazon CloudFront » API Reference » Actions on Distributions » GET Distribution
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

GET Distribution

Description

To get the information about a distribution, you do a GET on the 2010-11-01/distribution/<distribution ID> resource.

Requests

Syntax

GET /2010-11-01/distribution/<distribution ID> 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 or DELETE]
x-amz-request-id: [Request ID]

<?xml version="1.0" encoding="UTF-8"?>
<Distribution xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id>EDFDVBD632BHDS5</Id>
   <Status>Deployed</Status>
   <LastModifiedTime>2009-11-19T19:37:58Z</LastModifiedTime>
   <InProgressInvalidationBatches>1</InProgressInvalidationBatches>
   <DomainName>d604721fxaaqy9.cloudfront.net</DomaineName>
   <ActiveTrustedSigners>
         <Signer>
            <Self/>
            <KeyPairId>APKAI72T5DYBXEXAMPLE</KeyPairId>
         </Signer>
         <Signer>
            <AwsAccountNumber>111122223333</AwsAccountNumber>
            <KeyPairId>APKA9ONS7QCOWEXAMPLE</KeyPairId>
         </Signer>
   </ActiveTrustedSigners>
   <DistributionConfig>
      <S3Origin>1
         <DNSName>mybucket.s3.amazonaws.com</DNSName>
         <OriginAccessIdentity>
         origin-access-identity/cloudfront/E127EXAMPLE51Z
         </OriginAccessIdentity>
      </S3Origin>   
      <CustomOrigin>2
         <DNSName>www.example.com</DNSName>
         <HTTPPort>80</HTTPPort>
         <OriginProtocolPolicy>http-only</OriginProtocolPolicy>
      </CustomOrigin>
      <CallerReference>your unique caller reference</CallerReference>
      <CNAME>mysite.example.com</CNAME>
      <Comment>My comments</Comment>
      <Enabled>true</Enabled>
      <DefaultRootObject>index.html</DefaultRootObject>
      <Logging>
         <Bucket>mylogs.s3.amazonaws.com</Bucket>
         <Prefix>myprefix/</Prefix>
      </Logging>
      <TrustedSigners>
         <Self/>
         <AwsAccountNumber>111122223333</AwsAccountNumber>
         <AwsAccountNumber>444455556666</AwsAccountNumber>
      </TrustedSigners>
   </DistributionConfig>
</Distribution>

1

The S3Origin element is returned only if you use an Amazon S3 origin for your distribution.

2

The CustomOrigin element is returned only if you use a custom origin for your distribution. For more information about the CustomOrigin element and the S3Origin element, see DistributionConfig Complex Type.

Headers

NameDescription

ETag

The current version of the distribution's information. 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

Distribution

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

Type: Distribution 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 information about the EDFDVBD632BHDS5 distribution.

Sample Request

GET /2010-11-01/distribution/EDFDVBD632BHDS5 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

<Distribution xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id>EDFDVBD632BHDS5</Id>
   <Status>Deployed</Status>
   <LastModifiedTime>2009-11-19T19:37:58Z</LastModifiedTime>
   <DomainName>d604721fxaaqy9.cloudfront.net</DomainName>
   <DistributionConfig> 
      <S3Origin>
         <DNSName>mybucket.s3.amazonaws.com</DNSName>
      </S3Origin>   
      <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>
</Distribution>

Related Actions

Document Conventions
Terms of Use		Did this page help you?  Yes  No   Tell us about it...