GetStreamingDistributionConfig
Get the configuration information about a streaming distribution.
Request Syntax
GET /2020-05-31/streaming-distribution/Id/config 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"?>
<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>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.
- StreamingDistributionConfig
-
Root level tag for the StreamingDistributionConfig parameters.
Required: Yes
- Aliases
-
A complex type that contains information about CNAMEs (alternate domain names), if any, for this streaming distribution.
Type: Aliases object
- CallerReference
-
A unique value (for example, a date-time stamp) that ensures that the request can't be replayed.
If the value of
CallerReferenceis new (regardless of the content of theStreamingDistributionConfigobject), CloudFront creates a new distribution.If
CallerReferenceis a value that you already sent in a previous request to create a distribution, CloudFront returns aDistributionAlreadyExistserror.Type: String
- Comment
-
Any comments you want to include about the streaming distribution.
Type: String
- Enabled
-
Whether the streaming distribution is enabled to accept user requests for content.
Type: Boolean
- Logging
-
A complex type that controls whether access logs are written for the streaming distribution.
Type: StreamingLoggingConfig object
- PriceClass
-
A complex type that contains information about price class for this streaming distribution.
Type: String
Valid Values:
PriceClass_100 | PriceClass_200 | PriceClass_All - S3Origin
-
A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.
Type: S3Origin object
- TrustedSigners
-
A complex type that specifies any AWS accounts that you want to permit to create signed URLs for private content. If you want the distribution to use signed URLs, include this element; if you want the distribution to use public URLs, remove this element. For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
Type: TrustedSigners 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:
