Did this page help you? Yes No Tell us about it...

GET Streaming Distribution

Description

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

Requests

Syntax

GET /2010-11-01/streaming-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"?>
<StreamingDistribution xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id>id</Id>
   <Status>status</Status>
   <LastModifiedTime>time</LastModifiedTime>
   <DomainName>domain name</DomainName>
   <StreamingDistributionConfig>
      <S3Origin>
         <DNSName>name</DNSName>
         <OriginAccessIdentity>OAI</OriginAccessIdentity>
      <S3Origin>origin</S3Origin> 
      <CallerReference>ref</CallerReference>
      <CNAME>canonical name</CNAME>
      <Comment>The comment.</Comment>
      <Enabled>true|false</Enabled>
      <Logging>
         <Bucket>mylogs.s3.amazonaws.com</Bucket>
         <Prefix>myprefix/</Prefix>
      </Logging>
   </StreamingDistributionConfig>
</StreamingDistribution>

Headers

Name Description

Name	Description
`ETag`	The current version of the streaming 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

ETag

The current version of the streaming 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

Name Description

Name	Description
`StreamingDistribution`	The streaming distribution's information. For more information, see StreamingDistribution Complex Type. Type: `StreamingDistribution` complex type

StreamingDistribution

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

Type: StreamingDistribution 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).

Error	Description	HTTP Status Code
`NoSuchStreamingDistribution`	The specified streaming distribution does not exist.	404

Examples

The following example request gets the information about the EGTXBD79H29TRA8 streaming distribution.

Sample Request

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

<StreamingDistribution xmlns="http://cloudfront.amazonaws.com/doc/2010-11-01/">
   <Id>EGTXBD79H29TRA8</Id>
   <Status>Deployed</Status>
   <LastModifiedTime>2009-11-19T19:37:58Z</LastModifiedTime>
   <DomainName>s5c39gqb8ow64r.cloudfront.net</DomainName>
   <StreamingDistributionConfig> 
      <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>
   </StreamingDistributionConfig>
</StreamingDistribution>

Related Actions

Document Conventions
Terms of Use

Did this page help you? Yes No Tell us about it...