Amazon CloudFront
API Reference (API Version 2019-03-26)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

ListTagsForResource

List tags for a CloudFront resource.

Request Syntax

GET /2019-03-26/tagging?Resource=Resource HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

Resource

An ARN of a CloudFront resource.

Pattern: arn:aws(-cn)?:cloudfront::[0-9]+:.*

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <Tags> <Items> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </Items> </Tags>

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.

Tags

Root level tag for the Tags parameters.

Required: Yes

Items

A complex type that contains Tag elements.

Type: Array of Tag objects

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDenied

Access denied.

HTTP Status Code: 403

InvalidArgument

The argument is invalid.

HTTP Status Code: 400

InvalidTagging

Tagging specified in the response body is not valid.

HTTP Status Code: 400

NoSuchResource

A resource that was specified is not valid.

HTTP Status Code: 404

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: