Menu
Amazon CloudFront
API Reference (API Version 2016-09-07)

POST Untag Resource

Description

Removes one or more tags from a specified web or RTMP distribution. To remove tags from a distribution, you submit a POST request to the 2016-09-07/tagging resource.

Requests

Syntax

POST /2016-09-07/tagging?Operation=Untag&Resource=ARN HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS authentication string
Date: time stamp
Other required headers
<TagKeys>
   <Items>
      <Key>Tag key</Key>
      ...
   </Items>
</TagKeys>

Headers

The request must include the headers required in all CloudFront requests. For more information, see Common REST Headers.

Query Parameters

NameDescription

Resource

The Amazon Resource Name (ARN) for the distribution that you want to remove tags from, in the applicable format:

  • arn:aws:cloudfront::AWS account ID:distribution/distribution ID

  • arn:aws:cloudfront::AWS account ID:streaming-distribution/distribution ID

Type: String

Default: None

Elements

NameDescription

TagKeys

A complex type that contains information about the keys that you want to remove from a distribution.

Type: Complex

Default: None

Items

A list of Key elements that contain the key for each tag that you want to remove from the distribution.

Type: List

Default: None

Key

The key for a tag that you want to remove from the distribution.

Type: String

Default: None

Responses

Syntax

204 No Content

Special Errors

The action returns the following special errors. For information about the common errors that all actions return, see Errors.

ErrorDescriptionHTTP Status Code

InvalidTagging

The specified tagging for a CloudFront resource is invalid. For more information, see the error text.

400

NoSuchResource

The resource specified in the Resource parameter is invalid.

400

Examples

The following example request removes two tags from the CloudFront distribution that has the ARN arn:aws:cloudfront::123456789012:distribution/E123ABCEXAMPLE.

Sample Request

POST /2016-09-07/tagging?Operation=Untag&Resource=arn:aws:cloudfront::123456789012:distribution/E123ABCEXAMPLE HTTP/1.1
Host: cloudfront.amazonaws.com
Authorization: AWS authentication string
Date: time stamp
Other required headers
<TagKeys>
   <Items>
      <Key>CustId</Key>
      <Key>CustName</Key>
   </Items>
</TagKeys>

Sample Response

204 No Content