Menu
Amazon CloudFront
API Reference (API Version 2016-09-07)

GET Streaming Distribution

Description

To get the information about an RTMP distribution, you do a GET on the 2016-09-07/streaming-distribution/distribution ID resource.

Requests

Syntax

GET /2016-09-07/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/2016-09-07/">
   <Id>distribution ID</Id>
   <ARN>arn:aws:cloudfront::AWS account ID:streaming-distribution/distribution ID</ARN>
   <Status>Deployed | InProgress</Status>
   <LastModifiedTime>date and time that the distribution
      was last modified, in ISO 8601 format</LastModifiedTime>
   <DomainName>CloudFront domain name for the distribution</DomainName>
   <ActiveTrustedSigners>
      <Enabled>true | false</Enabled>
      <Quantity>number of trusted signers for this distribution</Quantity>
      <Items>
         <Signer>
            <AwsAccountNumber>self | AWS account number</AwsAccountNumber>
            <KeyPairIds>
               <Quantity>number of active key pairs for 
                  AwsAccountNumber</Quantity>
               <Items>
                  <KeyPairId>active key pair associated with 
                     AwsAccountNumber</KeyPairId>
               </Items>
            </KeyPairIds>
         </Signer>
      </Items>
   </ActiveTrustedSigners>
   <StreamingDistributionConfig>
      <CallerReference>unique description for this 
         distribution</CallerReference>
      <S3Origin>
         <DNSName>domain name of the S3 bucket</DNSName>
         <OriginAccessIdentity>origin-access-identity/cloudfront/ID-of-origin-access-identity</OriginAccessIdentity>
      </S3Origin>
      <Aliases>
         <Quantity>number of CNAME aliases</Quantity>
         <Items>
            <CNAME>CNAME alias</CNAME>
         </Items>
      </Aliases>
      <Comment>comment about the distribution</Comment>
      <Logging>
         <Enabled>true | false</Enabled>
         <Bucket>Amazon S3 bucket for logs</Bucket>
         <Prefix>prefix for log file names</Prefix>
      </Logging>
      <TrustedSigners>
         <Quantity>number of trusted signers</Quantity>
         <Items>
            <AwsAccountNumber>self | AWS account that can create 
               signed URLs</AwsAccountNumber>
         </Items>
      </TrustedSigners>
      <PriceClass>maximum price class for the distribution</PriceClass>
      <Enabled>true | false</Enabled>
   </StreamingDistributionConfig>
</StreamingDistribution>

Headers

NameDescription

ETag

The current version of the RTMP distribution's information, for example, E2QWRUHEXAMPLE. For information about using the ETag header value, see PUT Streaming Distribution Config.

Type: String

Elements

NameDescription

StreamingDistribution

The RTMP 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 that all actions return. For more information, see Errors.

ErrorDescriptionHTTP Status Code

NoSuchStreamingDistribution

The specified RTMP distribution does not exist.

404

Examples

The following example request gets the information about the EGTXBD79EXAMPLE RTMP distribution.

Sample Request

GET /2016-09-07/streaming-distribution/EDFDVBD6EXAMPLE HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS authentication string
Date: Thu, 17 May 2012 19:37:58 GMT
Other required headers

Sample Response

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

<StreamingDistribution xmlns="http://cloudfront.amazonaws.com/doc/2016-09-07/">
   <Id>EGTXBD79EXAMPLE</Id>
   <ARN>arn:aws:cloudfront::123456789012:streaming-distribution/EGTXBD79EXAMPLE</ARN>
   <Status>Deployed</Status>
   <LastModifiedTime>2012-05-19T19:37:58Z</LastModifiedTime>
   <DomainName>s5c39gqb8ow64r.cloudfront.net</DomainName>
   <ActiveTrustedSigners>
      <Quantity>3</Quantity>
      <Items>
         <Signer>
            <AwsAccountNumber>self</AwsAccountNumber>
            <KeyPairIds>
               <Quantity>1</Quantity>
               <Items>
                  <KeyPairId>APKA9ONS7QCOWEXAMPLE</KeyPairId>
               </Items>
            </KeyPairIds>
         </Signer>
         <Signer>
            <AwsAccountNumber>111122223333</AwsAccountNumber>
            <KeyPairIds>
               <Quantity>2</Quantity>
               <KeyPairId>APKAI72T5DYBXEXAMPLE</KeyPairId>
               <KeyPairId>APKAU72D8DYNXEXAMPLE</KeyPairId>
            </KeyPairIds>
         </Signer>
         <Signer>
            <AwsAccountNumber>444455556666</AwsAccountNumber>
            <KeyPairIds>
               <Quantity>0</Quantity>
            </KeyPairIds>
         </Signer>
      </Items>
   </ActiveTrustedSigners>
   <StreamingDistributionConfig>   
      <CallerReference>20120229090000</CallerReference>
      <S3Origin>
         <DNSName>mystreamingbucket.s3.amazonaws.com</DNSName>
         <OriginAccessIdentity>origin-access-identity/cloudfront/E74FTE3AEXAMPLE</OriginAccessIdentity>
      </S3Origin>
      <Aliases>
         <Quantity>1</Quantity>
         <Items>
            <CNAME>www.example.com</CNAME>
         </Items>
      </Aliases>
      <Comment>example comment</Comment>
      <Logging>
         <Enabled>true</Enabled>
         <Bucket>myawslogbucket.s3.amazonaws.com</Bucket>
         <Prefix>myprefix/</Prefix>
      </Logging>
      <TrustedSigners>
         <Quantity>3</Quantity>
         <Items>
            <AwsAccountNumber>self</AwsAccountNumber>
            <AwsAccountNumber>111122223333</AwsAccountNumber>
            <AwsAccountNumber>444455556666</AwsAccountNumber>
         </Items>
      </TrustedSigners>
      <PriceClass>PriceClass_All</PriceClass>
      <Enabled>true</Enabled>
   </StreamingDistributionConfig>
</StreamingDistribution>