Amazon CloudFront
API Reference (API Version 2010-11-01)
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 Origin Access Identity

Description

To get the information about a CloudFront origin access identity, you do a GET on the 2010-11-01/origin-access-identity/cloudfront/<identity ID> resource.

Requests

Syntax

GET /2010-11-01/origin-access-identity/cloudfront/<identity 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"?>
<CloudFrontOriginAccessIdentity xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id/>
   <S3CanonicalUserId>id</S3CanonicalUserId>
   <CloudFrontOriginAccessIdentityConfig>
      <CallerReference> ref </CallerReference>
      <Comment>The comment.</Comment>
   </CloudFrontOriginAccessIdentityConfig>
</CloudFrontOriginAccessIdentity>

Headers

NameDescription

ETag

The current version of the origin access identity's information. For example: E2QWRUHAPOMQZL.

Type: String

Elements

NameDescription

CloudFrontOriginAccessIdentity

The origin access identity's information. For more information, see CloudFrontOriginAccessIdentity Complex Type.

Type: CloudFrontOriginAccessIdentity 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

NoSuchCloudFrontOriginAccessIdentity

The specified origin access identity does not exist.

404

Examples

The following example request gets the information about the CloudFront origin access identity with ID E74FTE3AJFJ256A.

Sample Request

GET /2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A 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

<CloudFrontOriginAccessIdentity xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id>E74FTE3AJFJ256A</Id>
   <S3CanonicalUserId>
      cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9a69ba19f
   </S3CanonicalUserId>
   <CloudFrontOriginAccessIdentityConfig> 
      <CallerReference>20091130090000</CallerReference>
      <Comment>My comments</Comment>
   </CloudFrontOriginAccessIdentityConfig>
</CloudFrontOriginAccessIdentity>