URI HTTP methods Schemas Properties See also

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.

Path parameters
Name	Type	Required	Description
`arn`	String	True

Responses
Status code	Response model	Description
`200`	None	The request completed successfully.

Schemas

Request bodies


{
  "arn": "string"
}


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

Response bodies


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

{
}


{
  "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.