AWS Elemental MediaConvert API Reference
API Reference
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

Tags arn

URI

/2017-08-29/tags/arn

HTTP Methods

GET

Operation ID: ListTagsForResource

Retrieve the tags for a MediaConvert resource.

Path Parameters

Name Type Required Description
arn String True

Responses

Status Code Response Model Description
200 ListTagsForResourceResponse

200 response

400 ExceptionBody

The service can't process your request because of a problem in the request. Please check your request form and syntax.

403 ExceptionBody

You don't have permissions for this action with the credentials you sent.

404 ExceptionBody

The resource you requested does not exist.

409 ExceptionBody

The service could not complete your request because there is a conflict with the current state of the resource.

429 ExceptionBody

Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests.

500 ExceptionBody

The service encountered an unexpected condition and cannot fulfill your request.

PUT

Operation ID: UntagResource

Remove tags from a MediaConvert queue, preset, or job template. For information about tagging, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html

Path Parameters

Name Type Required Description
arn String True

Responses

Status Code Response Model Description
200 UntagResourceResponse

200 response

400 ExceptionBody

The service can't process your request because of a problem in the request. Please check your request form and syntax.

403 ExceptionBody

You don't have permissions for this action with the credentials you sent.

404 ExceptionBody

The resource you requested does not exist.

409 ExceptionBody

The service could not complete your request because there is a conflict with the current state of the resource.

429 ExceptionBody

Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests.

500 ExceptionBody

The service encountered an unexpected condition and cannot fulfill your request.

OPTIONS

Supports CORS preflight requests.

Responses

Status Code Response Model Description
200 None

The request completed successfully.

Schemas

Request Bodies

Example GET

{ "arn": "string" }

Example PUT

{ "arn": "string", "tagKeys": [ "string" ] }

Response Bodies

Example ListTagsForResourceResponse

{ "resourceTags": { "arn": "string", "tags": { } } }

Example UntagResourceResponse

{ }

Example ExceptionBody

{ "message": "string" }

Properties

ExceptionBody

Property Type Required Description
message

string

False

ListTagsForResourceRequest

List the tags for your AWS Elemental MediaConvert resource by sending a request with the Amazon Resource Name (ARN) of the resource. To get the ARN, send a GET request with the resource name.

Property Type Required Description
arn

string

False

The Amazon Resource Name (ARN) of the resource that you want to list tags for. To get the ARN, send a GET request with the resource name.

ListTagsForResourceResponse

A successful request to list the tags for a resource returns a JSON map of tags.

Property Type Required Description
resourceTags

ResourceTags

False

The Amazon Resource Name (ARN) and tags for an AWS Elemental MediaConvert resource.

ResourceTags

The Amazon Resource Name (ARN) and tags for an AWS Elemental MediaConvert resource.

Property Type Required Description
arn

string

False

The Amazon Resource Name (ARN) of the resource.

tags

object

False

The tags for the resource.

UntagResourceRequest

To remove tags from a resource, send a request with the Amazon Resource Name (ARN) of the resource and the keys of the tags that you want to remove.

Property Type Required Description
arn

string

False

The Amazon Resource Name (ARN) of the resource that you want to remove tags from. To get the ARN, send a GET request with the resource name.

tagKeys

Array of type string

False

The keys of the tags that you want to remove from the resource.

UntagResourceResponse

A successful request to remove tags from a resource returns an OK message.

See Also

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

ListTagsForResource

UntagResource