AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

Note:

For PCL this operation is only available in asynchronous form. Please refer to CreateStreamingDistributionAsync.

Namespace: Amazon.CloudFront
Assembly: AWSSDK.CloudFront.dll
Version: 3.x.y.z

Syntax

C#
public abstract CreateStreamingDistributionResponse CreateStreamingDistribution(
         CreateStreamingDistributionRequest request
)
Parameters
request
Type: Amazon.CloudFront.Model.CreateStreamingDistributionRequest

Container for the necessary parameters to execute the CreateStreamingDistribution service method.

Return Value
The response from the CreateStreamingDistribution service method, as returned by CloudFront.

Exceptions

ExceptionCondition
AccessDeniedException Access denied.
CNAMEAlreadyExistsException
InconsistentQuantitiesException The value of Quantity and the size of Items do not match.
InvalidArgumentException The argument is invalid.
InvalidOriginAccessIdentityException The origin access identity is not valid or doesn't exist.
InvalidOriginException The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.
MissingBodyException This operation requires a body. Ensure that the body is present and the Content-Type header is set.
StreamingDistributionAlreadyExistsException
TooManyStreamingDistributionCNAMEsException
TooManyStreamingDistributionsException Processing your request would cause you to exceed the maximum number of streaming distributions allowed.
TooManyTrustedSignersException Your request contains more trusted signers than are allowed per distribution.
TrustedSignerDoesNotExistException One or more of your trusted signers do not exist.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also