AWS Elemental MediaTailor
API Reference

Tags ResourceArn

Manages tags for MediaTailor playback configurations. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. MediaTailor offers tagging support for playback configuration resources. For more information, see Tagging AWS Elemental MediaTailor Resources.

URI

/tags/ResourceArn

HTTP Methods

GET

Operation ID: ListTagsForResource

Returns a list of the tags assigned to the specified playback configuration resource.

Example request

GET /tags/arn:aws:mediatailor:us-east-1:111111111111:playbackConfiguration/testConfig

Example response

Success: 200 { "tags": { "testKey": "testValue", "newTestKey": "newTestValue" }

Path Parameters

Name Type Required Description
ResourceArn String True

The Amazon Resource Name (ARN) for the playback configuration. You can get this from the response to any playback configuration request.

Responses

Status Code Response Model Description
200 TagsModel

Success.

400 BadRequestException

Invalid request parameters.

POST

Operation ID: TagResource

Adds tags to the specified playback configuration resource. You can specify one or more tags to add.

Example request

POST /tags/arn:aws:mediatailor:us-east-1:111111111111:playbackConfiguration/testConfig { "tags": { "newTestKey": "newTestValue" } }

Example response

Success: 204 {}

Path Parameters

Name Type Required Description
ResourceArn String True

The Amazon Resource Name (ARN) for the playback configuration. You can get this from the response to any playback configuration request.

Responses

Status Code Response Model Description
204 None

The request was successful and there is no content in the response.

400 None

Invalid request parameters.

DELETE

Operation ID: UntagResource

Removes tags from the specified playback configuration resource. You can specify one or more tags to remove.

Example request

DELETE /tags/arn:aws:mediatailor:us-east-1:111111111111:playbackConfiguration/testConfig?tagKeys="newTestKey"

Example response

Success: 204 {}

Path Parameters

Name Type Required Description
ResourceArn String True

The Amazon Resource Name (ARN) for the playback configuration. You can get this from the response to any playback configuration request.

Query Parameters

Name Type Required Description
tagKeys String True

A comma-separated list of the tag keys to remove from the playback configuration.

Responses

Status Code Response Model Description
204 None

The request was successful and there is no content in the response.

400 None

Invalid request parameters.

Schemas

Request Bodies

Example POST

{ "tags": { } }

Response Bodies

Example TagsModel

{ "tags": { } }

Example BadRequestException

{ "Message": "string" }

Properties

BadRequestException

Property Type Required Description
Message

string

False

TagsModel

A set of tags assigned to a resource.

Property Type Required Description
tags

object

True

A comma-separated list of tag key:value pairs. For example:

{ "Key1": "Value1", "Key2": "Value2" }

See Also

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

ListTagsForResource

TagResource

UntagResource