Tags - Amazon Macie

Tags

A tag is a label that you optionally 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.

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

  • 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 Amazon Macie resources in the Amazon Macie User Guide.

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

URI

/tags/resourceArn

HTTP methods

GET

Operation ID: ListTagsForResource

Retrieves the tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

Path parameters
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

Responses
Status codeResponse modelDescription
200ListTagsForResourceResponse

The request succeeded.

POST

Operation ID: TagResource

Adds or updates one or more tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

Path parameters
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

Responses
Status codeResponse modelDescription
204TagResourceResponse

The request succeeded and there isn't any content to include in the body of the response (No Content).

DELETE

Operation ID: UntagResource

Removes one or more tags (keys and values) from a classification job, custom data identifier, findings filter, or member account.

Path parameters
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

Query parameters
NameTypeRequiredDescription
tagKeysStringTrue

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, and separate them with an ampersand (&).

Responses
Status codeResponse modelDescription
204UntagResourceResponse

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 a classification job, custom data identifier, findings filter, or member account.

PropertyTypeRequiredDescription
tags

TagMap

False

A map of key-value pairs that identifies the tags (keys and values) that are associated with the resource.

TagMap

A string-to-string map of key-value pairs that specifies the tags (keys and values) for a classification job, custom data identifier, findings filter, or member account.

PropertyTypeRequiredDescription

*

string

False

TagResourceRequest

Specifies the tags (keys and values) to associate with a classification job, custom data identifier, findings filter, or member account.

PropertyTypeRequiredDescription
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 to the resource.

UntagResourceResponse

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

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