Révision et modification des balises pour les ressources Macie

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 il s'agit 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 le TagResourcefonctionnement d'Amazon API Macie. Si vous utilisez le AWS Command Line Interface (AWS CLI), vous pouvez le faire en exécutant 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é.