Markieren von Amazon Security Lake-Ressourcen

Wenn Sie Security Lake für einen aktivieren AWS-Region oder einen Abonnenten erstellen, bietet die Security-Lake-Konsole Optionen zum Hinzufügen von Tags zur Ressource – die Data-Lake-Konfiguration für die Region oder den Abonnenten. Folgen Sie den Anweisungen in der Konsole, um der Ressource beim Erstellen der Ressource Tags hinzuzufügen.

Gehen Sie folgendermaßen vor, um einer vorhandenen Ressource mithilfe der Security-Lake-Konsole ein oder mehrere Tags hinzuzufügen.

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

Verwenden Sie in Ihrer Anforderung 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 ein Array von -Objekten an. Jedes Objekt gibt einen Tag-Schlüssel und den zugehörigen Tag-Wert an.

Um einer vorhandenen Ressource ein oder mehrere Tags hinzuzufügen, verwenden Sie die -TagResourceOperation der Security-Lake-API oder AWS CLIführen Sie bei Verwendung der 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 hinzuzufügende Tag anzugeben. Wie bei Create Operationen und Befehlen gibt der tags Parameter ein Array von Objekten, ein Objekt für jeden Tag-Schlüssel und den zugehörigen Tag-Wert an.

Der folgende AWS CLI Befehl fügt beispielsweise dem angegebenen Subscriber einen Environment Tag-Schlüssel mit einem Cloud Tag-Wert hinzu. Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\) zur Verbesserung der Lesbarkeit.

$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Environment,value=Cloud

Wobei gilt:

Im folgenden Beispiel fügt der Befehl dem Abonnenten mehrere Tags hinzu.

$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Environment,value=Cloud key=CostCenter,value=12345 key=Owner,value=jane-doe

Für jedes Objekt in einem key value tagsArray sind sowohl die 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. Der folgende Befehl fügt beispielsweise einen -OwnerTag-Schlüssel ohne zugeordneten Tag-Wert hinzu:

$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Owner,value=

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

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

Der Abschnitt Tags listet alle Tags auf, die derzeit der Ressource zugewiesen sind.

Um die Tags für eine vorhandene Ressource programmgesteuert abzurufen und zu überprüfen, verwenden Sie die -ListTagsForResourceOperation der Security-Lake-API. Verwenden Sie in Ihrer Anforderung den resourceArn Parameter , um den Amazon-Ressourcennamen (ARN) der Ressource anzugeben.

Wenn Sie die AWS Command Line Interface (AWS CLI) verwenden, führen Sie den list-tags-for-resource Befehl aus und geben Sie mit dem resource-arn Parameter den ARN der Ressource an. Beispielsweise:

$ aws securitylake list-tags-for-resource --resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab

Im vorherigen Beispiel ist arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab der ARN eines vorhandenen Subscribers.

Wenn der Vorgang erfolgreich ist, gibt Security Lake ein tagsArray zurück. Jedes Objekt im Array gibt ein Tag an (sowohl den Tag-Schlüssel als auch den Tag-Wert), das derzeit der Ressource zugewiesen ist. Beispielsweise:

{
    "tags": [
        {
            "key": "Environment",
            "value": "Cloud"
        },
        {
            "key": "CostCenter",
            "value": "12345"
        },
        {
            "key": "Owner",
            "value": ""
        }
    ]
}

Wobei Environment, CostCenterund die Tag-Schlüssel Owner sind, die der Ressource zugewiesen sind. Cloud ist der Tag-Wert, der dem Environment Tag-Schlüssel zugeordnet ist. 12345 ist der Tag-Wert, der dem CostCenter Tag-Schlüssel zugeordnet ist. Dem Owner Tag-Schlüssel ist kein Tag-Wert zugeordnet.

Gehen Sie wie folgt vor, um die Tags einer Ressource mithilfe der Security-Lake-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 der Security-Lake-API. 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 zu bearbeiten, verwenden Sie den tags Parameter , um den Tag-Schlüssel anzugeben, dessen Tag-Wert Sie ändern möchten. Geben Sie auch den neuen Tag-Wert für den Schlüssel an. Mit dem folgenden AWS CLI Befehl wird beispielsweise der Tag-Wert Cloud On-Premises für den Environment Tag-Schlüssel, der dem angegebenen Subscriber zugewiesen ist, von in geändert. Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\) zur Verbesserung der Lesbarkeit.

$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Environment,value=On-Premises

Wobei gilt:

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

$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Owner,value=

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

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

Um ein oder mehrere Tags programmgesteuert aus einer Ressource zu entfernen, verwenden Sie die -UntagResourceOperation der Security-Lake-API. Verwenden Sie in Ihrer Anforderung den resourceArn Parameter , um den Amazon-Ressourcennamen (ARN) der Ressource anzugeben, aus der ein Tag entfernt werden soll. Verwenden Sie den tagKeys Parameter , um den Tag-Schlüssel des zu entfernenden Tags anzugeben. Um mehrere Tags zu entfernen, fügen Sie den tagKeys Parameter und das Argument für jedes zu entfernende Tag an, getrennt durch ein -Zeichen (&), z. B. tagKeys=key1&tagKeys=key2. Um nur einen bestimmten Tag-Wert (kein Tag-Schlüssel) aus einer Ressource zu entfernen, bearbeiten Sie das Tag, anstatt das Tag zu entfernen.

Wenn Sie die AWS Command Line Interface (AWS CLI) verwenden, führen Sie den Befehl untag-resource aus, um ein oder mehrere Tags aus einer Ressource zu entfernen. Geben Sie für den resource-arn Parameter den ARN der Ressource an, aus der ein Tag entfernt werden soll. Verwenden Sie den tag-keys Parameter , um den Tag-Schlüssel des zu entfernenden Tags anzugeben. Mit dem folgenden Befehl wird beispielsweise das Environment Tag (sowohl der Tag-Schlüssel als auch der Tag-Wert) aus dem angegebenen Subscriber entfernt:

$ aws securitylake untag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tag-keys Environment

Gibt den ARN des Abonnenten resource-arn an, aus dem ein Tag entfernt werden soll, und Environment ist der Tag-Schlüssel des zu entfernenden Tags.

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

$ aws securitylake untag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tag-keys Environment Owner

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