Amazon Security Lake リソースのタグを編集する

Security Lake コンソールを使用してリソースのタグを編集するには、以下のステップに従います。

リソースのタグをプログラムで編集すると、既存のタグが新しい値に上書きされます。したがって、タグを編集する最適な方法は、タグキー、タグ値、またはその両方を編集するかどうかによって異なります。タグキーを編集するには、現在のタグを削除して[新しいタグを追加]します。

タグキーに関連付けられているタグ値のみを編集または削除するには、Security Lake の TagResourceオペレーションを使用して既存の値を上書きしますAPI。 AWS Command Line Interface (AWS CLI) を使用している場合は、tag-resource コマンドを実行します。リクエストで、タグ値を編集または削除するリソースの Amazon リソースネーム (ARN) を指定します。

タグ値を編集するには、tagsパラメータを使用して、タグ値を変更したいタグキーを指定します。キーの新しいタグ値も指定します。例えば、次の AWS CLI コマンドは、指定されたサブスクライバーに割り当てられたタグキーOn-PremisesのEnvironmentタグ値を Cloud から に変更します。この例は Linux、macOS、または Unix 用にフォーマットされており、読みやすさを向上させるためにバックスラッシュ (\) の行継続文字を使用しています。

$ 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

コードの説明は以下のとおりです。

タグキーからタグ値を削除するには、tagsパラメーターのキーのvalue引数の値を指定しないでください。例:

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

オペレーションが成功すると、Security Lake は空の 200 HTTP レスポンスを返します。それ以外の場合、Security Lake は、オペレーションが失敗した理由を示す HTTP 4xx または 500 レスポンスを返します。

Security Lake コンソールを使用してリソースのタグを確認するには、次の手順に従います。

Tags セクションには、現在リソースに割り当てられているすべてのタグが一覧表示されます。

既存のリソースのタグをプログラムで取得して確認するには、Security Lake の ListTagsForResourceオペレーションを使用しますAPI。リクエストで、 resourceArnパラメータを使用してリソースの Amazon リソースネーム (ARN) を指定します。

AWS Command Line Interface （AWS CLI) を使用している場合は、 list-tags-for-resource コマンドを実行し、 resource-arnパラメータを使用してリソースARNの を指定します。例:

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

前の例では、arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab は既存のサブスクライバーARNの です。

オペレーションが正常に実行された場合は Security Lake はtags配列を返します。配列内の各オブジェクトは、現在リソースに割り当てられているタグ (タグキーとタグ値の両方) を指定します。例:

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

ここでEnvironment、CostCenter、Ownerは、リソースに割り当てられるタグキーです。 Cloudは、Environmentタグキーに関連付けられているタグ値です。 12345は、CostCenterタグキーに関連付けられているタグ値です。Ownerタグキーには、関連するタグ値はありません。