Tags - Amazon Macie

Tags

A tag is an optional 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.

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 Amazon Macie 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
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the resource.

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, separated by 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).

GET

Operation ID: ListTagsForResource

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

Path parameters
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the resource.

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 an Amazon Macie resource.

Path parameters
NameTypeRequiredDescription
resourceArnStringTrue

The Amazon Resource Name (ARN) of the resource.

Responses
Status codeResponse modelDescription
204TagResourceResponse

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.

PropertyTypeRequiredDescription
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.

PropertyTypeRequiredDescription

*

string

False

TagResourceRequest

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

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 or updated for 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:

UntagResource

ListTagsForResource

TagResource