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

GET Streaming Distribution Config

Description

To get an RTMP distribution's configuration information, you do a GET on the 2016-09-07/streaming-distribution/<distribution ID>/config resource.

Requests

Syntax

GET /2016-09-07/streaming-distribution/distribution ID/config 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 on the config
x-amz-request-id: Request ID

<?xml version="1.0" encoding="UTF-8"?>
<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>

Headers

NameDescription

ETag

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

Type: String

Elements

NameDescription

StreamingDistributionConfig

The RTMP distribution's configuration information. For more information, see StreamingDistributionConfig Complex Type.

Type: StreamingDistributionConfig 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 configuration information for the EGTXBD79EXAMPLE RTMP distribution.

Sample Request

GET /2016-09-07/streaming-distribution/EGTXBD79EXAMPLE/config 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

<?xml version="1.0" encoding="UTF-8"?>
<StreamingDistributionConfig xmlns="http://cloudfront.amazonaws.com/doc/2016-09-07/">
   <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>