Macie-Ressourcen taggen

Wenn Sie eine Zulassungsliste, eine benutzerdefinierte Daten-ID oder einen Discovery-Job für sensible Daten erstellen, bietet die Amazon Macie Macie-Konsole Optionen zum Hinzufügen von Tags zur Ressource. Folgen Sie bei der Erstellung der Ressourcen den Anweisungen auf der Konsole, um diesen Ressourcentypen Tags hinzuzufügen. Um einer Filter- oder Unterdrückungsregel oder einem Mitgliedskonto in einer Organisation Tags hinzuzufügen, müssen Sie die Ressource erstellen, bevor Sie ihr Tags hinzufügen können.

Gehen Sie wie folgt vor, um einer vorhandenen Ressource mithilfe der Amazon Macie Macie-Konsole ein oder mehrere Tags hinzuzufügen.

Um eine Ressource zu erstellen und ihr programmgesteuert ein oder mehrere Tags hinzuzufügen, verwenden Sie den entsprechenden Create Vorgang für den Ressourcentyp, den Sie erstellen möchten:

Verwenden Sie in Ihrer Anfrage den tags Parameter, um den Tag-Schlüssel (key) und den optionalen Tag-Wert (value) für jedes Tag anzugeben, das der Ressource hinzugefügt werden soll. Der tags Parameter gibt eine string-to-string Zuordnung von Tag-Schlüsseln und den zugehörigen Tag-Werten an.

Um einer vorhandenen Ressource ein oder mehrere Tags hinzuzufügen, verwenden Sie den TagResourceVorgang von Amazon Macie API oder, falls Sie den verwenden AWS CLI, führen Sie den Befehl tag-resource aus. Geben Sie in Ihrer Anfrage den Amazon-Ressourcennamen (ARN) der Ressource an, der Sie ein Tag hinzufügen möchten. Verwenden Sie den tags Parameter, um den Tag-Schlüssel (key) und den optionalen Tag-Wert (value) für jedes Tag anzugeben, das der Ressource hinzugefügt werden soll. Wie bei Create Operationen und Befehlen gibt der tags Parameter eine string-to-string Zuordnung von Tag-Schlüsseln und den zugehörigen Tag-Werten an.

Beispielsweise fügt der folgende AWS CLI Befehl dem angegebenen Job einen Stack Tag-Schlüssel mit einem Production Tag-Wert hinzu. Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.

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

Wobei gilt:

Im folgenden Beispiel fügt der Befehl dem Job mehrere Tags hinzu:

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\"}

Für jedes Tag in einer tags Map sind key sowohl die value Argumente als auch erforderlich. Der Wert für das value Argument kann jedoch eine leere Zeichenfolge sein. Wenn Sie einem Tag-Schlüssel keinen Tag-Wert zuordnen möchten, geben Sie keinen Wert für das value Argument an. Mit dem folgenden AWS CLI Befehl wird beispielsweise ein Owner Tag-Schlüssel ohne zugehörigen Tag-Wert hinzugefügt:

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

Wenn ein Tagging-Vorgang erfolgreich ist, gibt Macie eine leere HTTP 204-Antwort zurück. Andernfalls gibt Macie eine Antwort mit HTTP 4 xx oder 500 zurück, die angibt, warum der Vorgang fehlgeschlagen ist.

Gehen Sie wie folgt vor, um die Tags einer Ressource mithilfe der Amazon Macie Macie-Konsole zu überprüfen.

Um die Tags für eine vorhandene Ressource programmgesteuert abzurufen und zu überprüfen, können Sie den entsprechenden Describe Vorgang Get oder für den Ressourcentyp verwenden, für den Sie die Tags überprüfen möchten. Wenn Sie beispielsweise den GetCustomDataIdentifierVorgang verwenden oder den get-custom-data-identifierBefehl über AWS Command Line Interface (AWS CLI) ausführen, enthält die Antwort ein tags Objekt. Das Objekt listet alle Tags (sowohl Tag-Schlüssel als auch Tag-Werte) auf, die der Ressource derzeit zugewiesen sind.

Sie können auch den ListTagsForResourceBetrieb des Amazon Macie API nutzen. Verwenden Sie in Ihrer Anfrage den resourceArn Parameter, um den Amazon-Ressourcennamen (ARN) der Ressource anzugeben. Wenn Sie den verwenden AWS CLI, führen Sie den list-tags-for-resourceBefehl aus und verwenden Sie den resource-arn Parameter, um den ARN der Ressource anzugeben. Beispielsweise:

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

Im vorherigen Beispiel arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ist der ARN eines bestehenden Discovery-Jobs für sensible Daten.

Wenn der Vorgang erfolgreich ist, gibt Macie ein tags Objekt zurück, das alle Tags (sowohl Tagschlüssel als auch Tag-Werte) auflistet, die der Ressource derzeit zugewiesen sind. Beispielsweise:

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

Wobei StackCostCenter, und die Tag-Schlüssel Owner sind, die der Ressource zugewiesen sind. Productionist der Tag-Wert, der dem Stack Tag-Schlüssel zugeordnet ist. 12345ist der Tag-Wert, der dem CostCenter Tag-Schlüssel zugeordnet ist. Dem Owner Tag-Schlüssel ist kein Tag-Wert zugeordnet.

Um eine Liste aller Macie-Ressourcen mit Tags und aller Tags, die jeder dieser Ressourcen zugewiesen sind, abzurufen, verwenden Sie den GetResourcesVorgang AWS Resource Groups API Tagging. Setzen Sie in Ihrer Anfrage den Wert für den ResourceTypeFilters Parameter auf. macie2 Führen Sie dazu mit dem den AWS CLI Befehl get-resources aus und setzen Sie den Wert für den resource-type-filters Parameter aufmacie2. Beispielsweise:

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

Wenn der Vorgang erfolgreich ist, gibt Resource Groups ein ResourceTagMappingList Array zurück, das ARNs alle Macie-Ressourcen mit Tags sowie die Tag-Schlüssel und -Werte enthält, die jeder dieser Ressourcen zugewiesen sind.

Gehen Sie wie folgt vor, um die Tags einer Ressource mithilfe der Amazon Macie Macie-Konsole zu bearbeiten.

Wenn Sie ein Tag für eine Ressource programmgesteuert bearbeiten, überschreiben Sie das vorhandene Tag mit neuen Werten. Daher hängt die beste Methode zum Bearbeiten eines Tags davon ab, ob Sie einen Tag-Schlüssel, einen Tag-Wert oder beides bearbeiten möchten. Um einen Tag-Schlüssel zu bearbeiten, entfernen Sie das aktuelle Tag und fügen Sie ein neues Tag hinzu.

Um nur den Tag-Wert zu bearbeiten oder zu entfernen, der einem Tag-Schlüssel zugeordnet ist, überschreiben Sie den vorhandenen Wert mithilfe der TagResourceOperation von Amazon Macie API oder, wenn Sie die AWS Command Line Interface (AWS CLI) verwenden, führen Sie den Befehl tag-resource aus. Geben Sie in Ihrer Anfrage den Amazon-Ressourcennamen (ARN) der Ressource an, deren Tag-Wert Sie bearbeiten oder entfernen möchten.

Um einen Tag-Wert für einen Tag-Schlüssel zu bearbeiten, verwenden Sie den tags Parameter, um den Tag-Schlüssel anzugeben, dessen Tag-Wert Sie ändern möchten, und geben Sie den neuen Tag-Wert für den Schlüssel an. Mit dem folgenden Befehl wird beispielsweise der Tag-Wert Staging für den Tag-Schlüssel, der Stack dem angegebenen Discovery-Job für sensible Daten zugewiesen ist, von auf geändert. Production Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.

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

Wobei gilt:

Um einen Tag-Wert aus einem Tag-Schlüssel zu entfernen, geben Sie im tags Parameter keinen Wert für das value Argument an. Beispielsweise:

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

Wenn der Vorgang erfolgreich ist, gibt Macie eine leere HTTP 204-Antwort zurück. Andernfalls gibt Macie eine Antwort mit HTTP 4 xx oder 500 zurück, die angibt, warum der Vorgang fehlgeschlagen ist.

Gehen Sie wie folgt vor, um mithilfe der Amazon Macie Macie-Konsole ein oder mehrere Tags aus einer Ressource zu entfernen.

Um ein oder mehrere Tags programmgesteuert aus einer Ressource zu entfernen, verwenden Sie den UntagResourceBetrieb von Amazon Macie. API Verwenden Sie in Ihrer Anfrage den resourceArn Parameter, um den Amazon-Ressourcennamen (ARN) der Ressource anzugeben, von der ein Tag entfernt werden soll. Verwenden Sie den tagKeys Parameter, um den Tag-Schlüssel des Tags anzugeben, das entfernt werden soll. Um nur einen bestimmten Tag-Wert (keinen Tag-Schlüssel) aus einer Ressource zu entfernen, bearbeiten Sie das Tag, anstatt das Tag zu entfernen.

Wenn Sie AWS Command Line Interface (AWS CLI) verwenden, führen Sie den Befehl untag-resource aus und geben Sie mit dem resource-arn Parameter die Ressource an, ARN aus der ein Tag entfernt werden soll. Verwenden Sie den tag-keys Parameter, um den Tag-Schlüssel des Tags anzugeben, das entfernt werden soll. Mit dem folgenden Befehl wird beispielsweise das Stack Tag (sowohl der Tag-Schlüssel als auch der Tag-Wert) aus dem angegebenen Discovery-Job für sensible Daten entfernt:

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

Where resource-arn gibt den ARN Job an, aus dem ein Tag entfernt werden soll, und Stack gibt den Tag-Schlüssel des Tags an, aus dem ein Tag entfernt werden soll.

Um mehrere Tags aus einer Ressource zu entfernen, fügen Sie jeden zusätzlichen Tag-Schlüssel als Argument für den tag-keys Parameter hinzu. Beispielsweise:

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

Wo resource-arn gibt ARN der Job an, aus dem Tags entfernt werden sollen, und Stack und Owner sind die Tag-Schlüssel der Tags, die entfernt werden sollen.

Wenn der Vorgang erfolgreich ist, gibt Macie eine leere HTTP 204-Antwort zurück. Andernfalls gibt Macie eine Antwort mit HTTP 4 xx oder 500 zurück, die angibt, warum der Vorgang fehlgeschlagen ist.