Gets information about a specified RTMP distribution, including the distribution configuration.
Request Syntax
GET /2020-05-31/streaming-distribution/Id HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- Id
-
The streaming distribution's ID.
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<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>Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- StreamingDistribution
-
Root level tag for the StreamingDistribution parameters.
Required: Yes
- ActiveTrustedSigners
-
A complex type that lists the AWS accounts, if any, that you included in the
TrustedSignerscomplex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.The
Signercomplex type lists the AWS account number of the trusted signer orselfif the signer is the AWS account that created the distribution. TheSignerelement also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If noKeyPairIdelement appears for aSigner, that signer can't create signed URLs.For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
Type: ActiveTrustedSigners object
- ARN
-
The ARN (Amazon Resource Name) for the distribution. For example:
arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where123456789012is your AWS account ID.Type: String
- DomainName
-
The domain name that corresponds to the streaming distribution, for example,
s5c39gqb8ow64r.cloudfront.net.Type: String
- Id
-
The identifier for the RTMP distribution. For example:
EGTXBD79EXAMPLE.Type: String
- LastModifiedTime
-
The date and time that the distribution was last modified.
Type: Timestamp
- Status
-
The current status of the RTMP distribution. When the status is
Deployed, the distribution's information is propagated to all CloudFront edge locations.Type: String
- StreamingDistributionConfig
-
The current configuration information for the RTMP distribution.
Type: StreamingDistributionConfig 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
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
