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...

CloudFrontOriginAccessIdentityConfig Complex Type

Description

The CloudFrontOriginAccessIdentityConfig complex type describes an origin access identity's configuration information. For information about why and how you use CloudFront origin access identities, go to Serving Private Content in the Amazon CloudFront Developer Guide.

This complex type is used as a request element in POST Origin Access Identity and PUT Origin Access Identity Config.

It is used as a response element in GET Origin Access Identity and GET Origin Access Identity Config.

Syntax

<CloudFrontOriginAccessIdentityConfig xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <CallerReference>ref</CallerReference>
   <Comment>The comment.</Comment>
</CloudFrontOriginAccessIdentityConfig>

Elements

The following table describes the child elements in the CloudFrontOriginAccessIdentityConfig datatype.

NameDescriptionRequired

CallerReference

A unique number that ensures the request can't be replayed.

If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig object), a new origin access identity is created.

If the CallerReference is a value you already sent in a previous request to create an identity, and the content of the CloudFrontOriginAccessIdentityConfig is identical to the original request (ignoring white space), the response includes the same information returned to the original request.

If the CallerReference is a value you already sent in a previous request to create an identity but the content of the CloudFrontOriginAccessIdentityConfig is different from the original request, CloudFront returns a CloudFrontOriginAccessIdentityAlreadyExists error.

Type: String

Constraints: Allowable characters are any Unicode code points that are legal in an XML 1.0 document. The UTF-8 encoding of the value must be less than 128 bytes.

Default: None

Yes

Comment

Any comments you want to include about the origin access identity.

Type: String

Constraints: Maximum 128 characters

Default: None

No

Example

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