Network.AWS.CloudFront.CreateStreamingDistribution

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 .

Important: 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.

Creating a Request

createStreamingDistribution

Arguments

:: StreamingDistributionConfig

csdStreamingDistributionConfig

-> CreateStreamingDistribution

Creates a value of CreateStreamingDistribution with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• csdStreamingDistributionConfig - The streaming distribution's configuration information.

data CreateStreamingDistribution

The request to create a new streaming distribution.

See: createStreamingDistribution smart constructor.

Instances

Eq CreateStreamingDistribution

Methods

(==) :: CreateStreamingDistribution -> CreateStreamingDistribution -> Bool

(/=) :: CreateStreamingDistribution -> CreateStreamingDistribution -> Bool

Data CreateStreamingDistribution

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateStreamingDistribution -> c CreateStreamingDistribution

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateStreamingDistribution

toConstr :: CreateStreamingDistribution -> Constr

dataTypeOf :: CreateStreamingDistribution -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateStreamingDistribution)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateStreamingDistribution)

gmapT :: (forall b. Data b => b -> b) -> CreateStreamingDistribution -> CreateStreamingDistribution

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateStreamingDistribution -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateStreamingDistribution -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateStreamingDistribution -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateStreamingDistribution -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateStreamingDistribution -> m CreateStreamingDistribution

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateStreamingDistribution -> m CreateStreamingDistribution

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateStreamingDistribution -> m CreateStreamingDistribution

Read CreateStreamingDistribution

Methods

readsPrec :: Int -> ReadS CreateStreamingDistribution

readList :: ReadS [CreateStreamingDistribution]

readPrec :: ReadPrec CreateStreamingDistribution

readListPrec :: ReadPrec [CreateStreamingDistribution]

Show CreateStreamingDistribution

Methods

showsPrec :: Int -> CreateStreamingDistribution -> ShowS

show :: CreateStreamingDistribution -> String

showList :: [CreateStreamingDistribution] -> ShowS

Generic CreateStreamingDistribution

Associated Types

type Rep CreateStreamingDistribution :: * -> *

Methods

from :: CreateStreamingDistribution -> Rep CreateStreamingDistribution x

to :: Rep CreateStreamingDistribution x -> CreateStreamingDistribution

Hashable CreateStreamingDistribution

Methods

hashWithSalt :: Int -> CreateStreamingDistribution -> Int

hash :: CreateStreamingDistribution -> Int

NFData CreateStreamingDistribution

Methods

rnf :: CreateStreamingDistribution -> ()

AWSRequest CreateStreamingDistribution

Associated Types

type Rs CreateStreamingDistribution :: *

Methods

request :: CreateStreamingDistribution -> Request CreateStreamingDistribution

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * CreateStreamingDistribution -> ClientResponse -> m (Response CreateStreamingDistribution)

ToElement CreateStreamingDistribution

Methods

toElement :: CreateStreamingDistribution -> Element

ToHeaders CreateStreamingDistribution

Methods

toHeaders :: CreateStreamingDistribution -> [Header]

ToPath CreateStreamingDistribution

Methods

toPath :: CreateStreamingDistribution -> ByteString

ToQuery CreateStreamingDistribution

Methods

toQuery :: CreateStreamingDistribution -> QueryString

type Rep CreateStreamingDistribution

type Rep CreateStreamingDistribution = D1 * (MetaData "CreateStreamingDistribution" "Network.AWS.CloudFront.CreateStreamingDistribution" "amazonka-cloudfront-1.6.0-GTmJBWQTc5OFcqzFNdHHM3" True) (C1 * (MetaCons "CreateStreamingDistribution'" PrefixI True) (S1 * (MetaSel (Just Symbol "_csdStreamingDistributionConfig") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * StreamingDistributionConfig)))

type Rs CreateStreamingDistribution

type Rs CreateStreamingDistribution = CreateStreamingDistributionResponse

Request Lenses

csdStreamingDistributionConfig :: Lens' CreateStreamingDistribution StreamingDistributionConfig

The streaming distribution's configuration information.

Destructuring the Response

createStreamingDistributionResponse

Arguments

:: Int

csdrsResponseStatus

-> CreateStreamingDistributionResponse

Creates a value of CreateStreamingDistributionResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• csdrsETag - The current version of the streaming distribution created.
• csdrsLocation - The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8 .
• csdrsStreamingDistribution - The streaming distribution's information.
• csdrsResponseStatus - -- | The response status code.

data CreateStreamingDistributionResponse

The returned result of the corresponding request.

See: createStreamingDistributionResponse smart constructor.

Instances

Eq CreateStreamingDistributionResponse

Methods

(==) :: CreateStreamingDistributionResponse -> CreateStreamingDistributionResponse -> Bool

(/=) :: CreateStreamingDistributionResponse -> CreateStreamingDistributionResponse -> Bool

Data CreateStreamingDistributionResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateStreamingDistributionResponse -> c CreateStreamingDistributionResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateStreamingDistributionResponse

toConstr :: CreateStreamingDistributionResponse -> Constr

dataTypeOf :: CreateStreamingDistributionResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateStreamingDistributionResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateStreamingDistributionResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateStreamingDistributionResponse -> CreateStreamingDistributionResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateStreamingDistributionResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateStreamingDistributionResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateStreamingDistributionResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateStreamingDistributionResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateStreamingDistributionResponse -> m CreateStreamingDistributionResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateStreamingDistributionResponse -> m CreateStreamingDistributionResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateStreamingDistributionResponse -> m CreateStreamingDistributionResponse

Read CreateStreamingDistributionResponse

Methods

readsPrec :: Int -> ReadS CreateStreamingDistributionResponse

readList :: ReadS [CreateStreamingDistributionResponse]

readPrec :: ReadPrec CreateStreamingDistributionResponse

readListPrec :: ReadPrec [CreateStreamingDistributionResponse]

Show CreateStreamingDistributionResponse

Methods

showsPrec :: Int -> CreateStreamingDistributionResponse -> ShowS

show :: CreateStreamingDistributionResponse -> String

showList :: [CreateStreamingDistributionResponse] -> ShowS

Generic CreateStreamingDistributionResponse

Associated Types

type Rep CreateStreamingDistributionResponse :: * -> *

Methods

from :: CreateStreamingDistributionResponse -> Rep CreateStreamingDistributionResponse x

to :: Rep CreateStreamingDistributionResponse x -> CreateStreamingDistributionResponse

NFData CreateStreamingDistributionResponse

Methods

rnf :: CreateStreamingDistributionResponse -> ()

type Rep CreateStreamingDistributionResponse

type Rep CreateStreamingDistributionResponse = D1 * (MetaData "CreateStreamingDistributionResponse" "Network.AWS.CloudFront.CreateStreamingDistribution" "amazonka-cloudfront-1.6.0-GTmJBWQTc5OFcqzFNdHHM3" False) (C1 * (MetaCons "CreateStreamingDistributionResponse'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_csdrsETag") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_csdrsLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_csdrsStreamingDistribution") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe StreamingDistribution))) (S1 * (MetaSel (Just Symbol "_csdrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int)))))

Response Lenses

csdrsETag :: Lens' CreateStreamingDistributionResponse (Maybe Text)

The current version of the streaming distribution created.

csdrsLocation :: Lens' CreateStreamingDistributionResponse (Maybe Text)

The fully qualified URI of the new streaming distribution resource just created. For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8 .

csdrsStreamingDistribution :: Lens' CreateStreamingDistributionResponse (Maybe StreamingDistribution)

The streaming distribution's information.

csdrsResponseStatus :: Lens' CreateStreamingDistributionResponse Int

• - | The response status code.