URI HTTP methods Schemas Properties See also

Tags: list, tag, untag

URI

/tags/resourceArn

HTTP methods

GET

Operation ID: ListTagsForResource

Lists all tags associated with the resource.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource that you want to view tags for.

Responses
Status code	Response model	Description
`200`	`ListTagsForResourceResponse`	MediaConnect listed the tags associated with the resource.
`400`	`ResponseError`	The request that you submitted is not valid.
`404`	`ResponseError`	MediaConnect did not find the resource that you specified in the request.
`500`	`ResponseError`	MediaConnect can't fulfill your request because it encountered an unexpected condition.

POST

Operation ID: TagResource

Associates the specified tags to a resource. If the request does not mention an existing tag associated with the resource, that tag is not changed.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource that you want to view tags for.

Responses
Status code	Response model	Description
`204`	None	If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
`400`	`ResponseError`	The request that you submitted is not valid.
`404`	`ResponseError`	MediaConnect did not find the resource that you specified in the request.
`500`	`ResponseError`	MediaConnect can't fulfill your request because it encountered an unexpected condition.

DELETE

Operation ID: UntagResource

Deletes the specified tags from a resource.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource that you want to view tags for.

Query parameters
Name	Type	Required	Description
`tagKeys`	String	True	The keys of the tags to be removed.

Responses
Status code	Response model	Description
`204`	None	If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
`400`	`ResponseError`	The request that you submitted is not valid.
`404`	`ResponseError`	MediaConnect did not find the resource that you specified in the request.
`500`	`ResponseError`	MediaConnect can't fulfill your request because it encountered an unexpected condition.

Schemas

Request bodies


{
  "tags": {
  }
}

Response bodies


{
  "tags": {
  }
}


{
  "message": "string"
}

Properties

ListTagsForResourceResponse

MediaConnect listed the tags associated with the resource.

Property	Type	Required	Description
`tags`	object	True	A map from tag keys to values. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

ResponseError

An exception raised by MediaConnect when you submit a request that cannot be completed. For more information, see the error message and documentation for the operation.

Property	Type	Required	Description
`message`	string	True	The specific error message that MediaConnect returns to help you understand the reason that the request did not succeed.

TagResourceRequest

The tags to add to the resource. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

Property	Type	Required	Description
`tags`	object	True	A map from tag keys to values. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.