Marquer les ressources de Macie

Lorsque vous créez une liste d'autorisations, un identifiant de données personnalisé ou une tâche de découverte de données sensibles, la console Amazon Macie propose des options permettant d'ajouter des balises à la ressource. Suivez les instructions de la console pour ajouter des balises à ces types de ressources lors de leur création. Pour ajouter des balises à une règle de filtrage ou de suppression ou à un compte membre d'une organisation, vous devez créer la ressource avant de pouvoir y ajouter des balises.

Pour ajouter une ou plusieurs balises à une ressource existante à l'aide de la console Amazon Macie, procédez comme suit.

Pour créer une ressource et y ajouter une ou plusieurs balises par programmation, utilisez l'Createopération appropriée au type de ressource que vous souhaitez créer :

Dans votre demande, utilisez le tags paramètre pour spécifier la clé de balise (key) et la valeur de balise facultative (value) pour chaque balise à ajouter à la ressource. Le tags paramètre spécifie une string-to-string carte des clés de balise et de leurs valeurs de balise associées.

Pour ajouter une ou plusieurs balises à une ressource existante, utilisez l'TagResourceAmazon Macie API ou, si vous utilisez la AWS CLI, exécutez la commande tag-resource. Dans votre demande, spécifiez le nom de ressource Amazon (ARN) de la ressource à laquelle vous souhaitez ajouter une balise. Utilisez le tags paramètre pour spécifier la clé de balise (key) et la valeur de balise facultative (value) pour chaque balise à ajouter à la ressource. Comme c'est le cas pour les Create opérations et les commandes, le tags paramètre spécifie une string-to-string carte des clés de balise et de leurs valeurs de balise associées.

Par exemple, la AWS CLI commande suivante ajoute une clé de Stack balise avec une valeur de Production balise à la tâche spécifiée. Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité.

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\"}

Où :

Dans l'exemple suivant, la commande ajoute plusieurs balises à la tâche :

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\",\"CostCenter\":\"12345\",\"Owner\":\"jane-doe\"}

Pour chaque balise d'une tags carte, les value arguments key et sont obligatoires. Toutefois, la valeur de l'valueargument peut être une chaîne vide. Si vous ne souhaitez pas associer une valeur de balise à une clé de balise, ne spécifiez pas de valeur pour l'valueargument. Par exemple, la AWS CLI commande suivante ajoute une clé de Owner balise sans valeur de balise associée :

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Owner\":\"\"}

Si une opération de balisage réussit, Macie renvoie une réponse 204 vide. HTTP Sinon, Macie renvoie une réponse HTTP 4 xx ou 500 indiquant pourquoi l'opération a échoué.

Suivez ces étapes pour consulter les balises d'une ressource à l'aide de la console Amazon Macie.

Pour récupérer et vérifier les balises d'une ressource existante par programmation, vous pouvez utiliser l'Describeopération Get ou l'opération appropriée pour le type de ressource dont vous souhaitez vérifier les balises. Par exemple, si vous utilisez l'GetCustomDataIdentifieropération ou si vous exécutez la get-custom-data-identifiercommande depuis AWS Command Line Interface (AWS CLI), la réponse inclut un tags objet. L'objet répertorie toutes les balises (clés de balise et valeurs de balise) actuellement attribuées à la ressource.

Vous pouvez également utiliser le ListTagsForResourcefonctionnement de l'Amazon MacieAPI. Dans votre demande, utilisez le resourceArn paramètre pour spécifier le nom de ressource Amazon (ARN) de la ressource. Si vous utilisez le AWS CLI, exécutez la list-tags-for-resourcecommande et utilisez le resource-arn paramètre pour spécifier ARN la ressource. Par exemple :

C:\> aws macie2 list-tags-for-resource --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample

Dans l'exemple précédent, arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample est le résultat ARN d'une tâche de découverte de données sensibles existante.

Si l'opération aboutit, Macie renvoie un tags objet répertoriant toutes les balises (clés de balise et valeurs de balise) actuellement attribuées à la ressource. Par exemple :

{
    "tags": {
        "Stack": "Production",
        "CostCenter": "12345",
        "Owner": ""
    }
}

Où StackCostCenter, et Owner sont les clés de balise attribuées à la ressource. Productionest la valeur de balise associée à la clé de Stack balise. 12345est la valeur de balise associée à la clé de CostCenter balise. Aucune valeur de Owner balise n'est associée à la clé de balise.

Pour récupérer une liste de toutes les ressources Macie dotées de balises et de toutes les balises attribuées à chacune de ces ressources, utilisez l'GetResourcesopération de AWS Resource Groups balisageAPI. Dans votre demande, définissez la valeur du ResourceTypeFilters paramètre surmacie2. Pour ce faire AWS CLI, exécutez la commande get-resources et définissez la valeur du resource-type-filters paramètre sur. macie2 Par exemple :

C:\> aws resourcegroupstaggingapi get-resources --resource-type-filters "macie2"

Si l'opération aboutit, Resource Groups renvoie un ResourceTagMappingList tableau contenant toutes les ressources Macie dotées ARNs de balises, ainsi que les clés de balise et les valeurs attribuées à chacune de ces ressources.

Suivez ces étapes pour modifier les balises d'une ressource à l'aide de la console Amazon Macie.

Lorsque vous modifiez une balise pour une ressource par programmation, vous remplacez la balise existante par de nouvelles valeurs. Par conséquent, la meilleure façon de modifier une balise dépend de la modification d'une clé de balise, d'une valeur de balise ou des deux. Pour modifier une clé de balise, supprimez la balise actuelle et ajoutez-en une nouvelle.

Pour modifier ou supprimer uniquement la valeur de balise associée à une clé de balise, remplacez la valeur existante en utilisant l'TagResourceAmazon API Macie ou, si vous utilisez le AWS CLI(), en exécutant AWS Command Line Interface la commande tag-resource. Dans votre demande, spécifiez le nom de ressource Amazon (ARN) de la ressource dont vous souhaitez modifier ou supprimer la valeur de balise.

Pour modifier la valeur d'une balise pour une clé de balise, utilisez le tags paramètre pour spécifier la clé de balise dont vous souhaitez modifier la valeur de balise, et spécifiez la nouvelle valeur de balise pour la clé. Par exemple, la commande suivante modifie la valeur de balise de Production à Staging pour la clé de Stack balise affectée à la tâche de découverte de données sensibles spécifiée. Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité.

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Staging\"}

Où :

Pour supprimer une valeur de balise d'une clé de balise, ne spécifiez pas de valeur pour l'valueargument dans le tags paramètre. Par exemple :

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"\"}

Si l'opération réussit, Macie renvoie une réponse HTTP 204 vide. Sinon, Macie renvoie une réponse HTTP 4 xx ou 500 indiquant pourquoi l'opération a échoué.

Suivez ces étapes pour supprimer une ou plusieurs balises d'une ressource à l'aide de la console Amazon Macie.

Pour supprimer une ou plusieurs balises d'une ressource par programmation, utilisez le UntagResourcefonctionnement d'Amazon Macie. API Dans votre demande, utilisez le resourceArn paramètre pour spécifier le nom de ressource Amazon (ARN) de la ressource dont vous souhaitez supprimer une balise. Utilisez le tagKeys paramètre pour spécifier la clé de balise de la balise à supprimer. Pour supprimer uniquement une valeur de balise spécifique (et non une clé de balise) d'une ressource, modifiez la balise au lieu de la supprimer.

Si vous utilisez le AWS Command Line Interface (AWS CLI), exécutez la commande untag-resource et utilisez le resource-arn paramètre pour spécifier la ressource ARN dont vous souhaitez supprimer une balise. Utilisez le tag-keys paramètre pour spécifier la clé de balise de la balise à supprimer. Par exemple, la commande suivante supprime la Stack balise (à la fois la clé et la valeur de la balise) de la tâche de découverte de données sensibles spécifiée :

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack

Where resource-arn indique ARN la tâche dont il faut supprimer une étiquette et Stack indique la clé de balise de la balise à supprimer.

Pour supprimer plusieurs balises d'une ressource, ajoutez chaque clé de balise supplémentaire en tant qu'argument pour le tag-keys paramètre. Par exemple :

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack Owner

Où resource-arn spécifie ARN la tâche dont vous souhaitez supprimer les balises, Stack et Owner sont les clés de balise des balises à supprimer.

Si l'opération réussit, Macie renvoie une réponse HTTP 204 vide. Sinon, Macie renvoie une réponse HTTP 4 xx ou 500 indiquant pourquoi l'opération a échoué.