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

GetStreamingDistribution

Gets information about a specified RTMP distribution, including the distribution configuration.

Request Syntax

GET /2016-09-29/streaming-distribution/Id HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

Id

The streaming distribution's ID.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200
ETag: ETag
<?xml version="1.0" encoding="UTF-8"?>
<GetStreamingDistributionResult>
   <StreamingDistribution>
      <ActiveTrustedSigners>
         <Enabled>boolean</Enabled>
         <Items>
            <Signer>
               <AwsAccountNumber>string</AwsAccountNumber>
               <KeyPairIds>
                  <Items>
                     <KeyPairId>string</KeyPairId></Items>
                  <Quantity>integer</Quantity>
               </KeyPairIds>
            </Signer></Items>
         <Quantity>integer</Quantity>
      </ActiveTrustedSigners>
      <ARN>string</ARN>
      <DomainName>string</DomainName>
      <Id>string</Id>
      <LastModifiedTime>timestamp</LastModifiedTime>
      <Status>string</Status>
      <StreamingDistributionConfig>
         <Aliases>
            <Items>
               <CNAME>string</CNAME></Items>
            <Quantity>integer</Quantity>
         </Aliases>
         <CallerReference>string</CallerReference>
         <Comment>string</Comment>
         <Enabled>boolean</Enabled>
         <Logging>
            <Bucket>string</Bucket>
            <Enabled>boolean</Enabled>
            <Prefix>string</Prefix>
         </Logging>
         <PriceClass>string</PriceClass>
         <S3Origin>
            <DomainName>string</DomainName>
            <OriginAccessIdentity>string</OriginAccessIdentity>
         </S3Origin>
         <TrustedSigners>
            <Enabled>boolean</Enabled>
            <Items>
               <AwsAccountNumber>string</AwsAccountNumber></Items>
            <Quantity>integer</Quantity>
         </TrustedSigners>
      </StreamingDistributionConfig>
   </StreamingDistribution>
</GetStreamingDistributionResult>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The response returns the following HTTP headers.

ETag

The current version of the streaming distribution's information. For example: E2QWRUHAPOMQZL.

The following data is returned in XML format by the service.

GetStreamingDistributionResult

Root level tag for the GetStreamingDistributionResult parameters.

Required: Yes

StreamingDistribution

The streaming distribution's information.

Type: StreamingDistribution object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

NoSuchStreamingDistribution

The specified streaming distribution does not exist.

HTTP Status Code: 404