URI HTTP methods Schemas Properties See also

Tags

A tag is a label that you can define and associate with AWS resources, including certain types of Amazon Macie resources. Tags can help you identify, categorize, and manage resources in different ways, such as by purpose, owner, environment, or other criteria. For example, you can use tags to: apply policies, allocate costs, distinguish between versions of resources, or identify resources that support certain compliance requirements or workflows.

You can associate tags with the following types of Macie resources:

Allow lists
Classification jobs
Custom data identifiers
Findings filters
Member accounts

A resource can have as many as 50 tags. Each tag consists of a tag key and an associated tag value, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor for a tag key. For more information, see Tagging resources in the Amazon Macie User Guide.

You can use the Tags resource to add, retrieve, update, or remove tags from an allow list, classification job, custom data identifier, findings filter, or member account.

URI

/tags/resourceArn

HTTP methods

DELETE

Operation ID: UntagResource

Removes one or more tags (keys and values) from an Amazon Macie resource.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource.

Query parameters
Name	Type	Required	Description
`tagKeys`	String	True	One or more tags (keys) to remove from the resource. In an HTTP request to remove multiple tags, append the `tagKeys` parameter and argument for each tag to remove, separated by an ampersand (&).

Responses
Status code	Response model	Description
`204`	`UntagResourceResponse`	The request succeeded and there isn't any content to include in the body of the response (No Content).

GET

Operation ID: ListTagsForResource

Retrieves the tags (keys and values) that are associated with an Amazon Macie resource.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource.

Responses
Status code	Response model	Description
`200`	`ListTagsForResourceResponse`	The request succeeded.

POST

Operation ID: TagResource

Adds or updates one or more tags (keys and values) that are associated with an Amazon Macie resource.

Path parameters
Name	Type	Required	Description
`resourceArn`	String	True	The Amazon Resource Name (ARN) of the resource.

Responses
Status code	Response model	Description
`204`	`TagResourceResponse`	The request succeeded and there isn't any content to include in the body of the response (No Content).

Schemas

Request bodies


{
  "tags": {
  }
}

Response bodies


{
  "tags": {
  }
}

{
}

{
}

Properties

ListTagsForResourceResponse

Provides information about the tags (keys and values) that are associated with an Amazon Macie resource.

Property	Type	Required	Description
`tags`	TagMap	False	A map of key-value pairs that specifies which tags (keys and values) are associated with the resource.

TagMap

A string-to-string map of key-value pairs that specifies the tags (keys and values) for an Amazon Macie resource.

Property	Type	Required	Description
`*`	string	False

TagResourceRequest

Specifies the tags (keys and values) to associate with an Amazon Macie resource.

Property Type Required Description

Property	Type	Required	Description
`tags`	TagMap	True	A map of key-value pairs that specifies the tags to associate with the resource. A resource can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

tags

TagMap

True

A map of key-value pairs that specifies the tags to associate with the resource.

A resource can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

TagResourceResponse

The request succeeded. The specified tags were added or updated for the resource.

UntagResourceResponse

The request succeeded. The specified tags were removed from the resource.