CloudFront / Client / delete_streaming_distribution
delete_streaming_distribution#
- CloudFront.Client.delete_streaming_distribution(**kwargs)#
Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.
To delete an RTMP distribution using the CloudFront API:
Disable the RTMP distribution.
Submit a
GET Streaming Distribution Config
request to get the current configuration and theEtag
header for the distribution.Update the XML document that was returned in the response to your
GET Streaming Distribution Config
request to change the value ofEnabled
tofalse
.Submit a
PUT Streaming Distribution Config
request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTPIf-Match
header to the value of theETag
header that CloudFront returned when you submitted theGET Streaming Distribution Config
request in Step 2.Review the response to the
PUT Streaming Distribution Config
request to confirm that the distribution was successfully disabled.Submit a
GET Streaming Distribution Config
request to confirm that your changes have propagated. When propagation is complete, the value ofStatus
isDeployed
.Submit a
DELETE Streaming Distribution
request. Set the value of the HTTPIf-Match
header to the value of theETag
header that CloudFront returned when you submitted theGET Streaming Distribution Config
request in Step 2.Review the response to your
DELETE Streaming Distribution
request to confirm that the distribution was successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.
See also: AWS API Documentation
Request Syntax
response = client.delete_streaming_distribution( Id='string', IfMatch='string' )
- Parameters:
Id (string) –
[REQUIRED]
The distribution ID.
IfMatch (string) – The value of the
ETag
header that you received when you disabled the streaming distribution. For example:E2QWRUHAPOMQZL
.
- Returns:
None
Exceptions
CloudFront.Client.exceptions.AccessDenied
CloudFront.Client.exceptions.StreamingDistributionNotDisabled
CloudFront.Client.exceptions.InvalidIfMatchVersion
CloudFront.Client.exceptions.NoSuchStreamingDistribution
CloudFront.Client.exceptions.PreconditionFailed