Menandai sumber daya Amazon Security Lake

Saat Anda mengaktifkan Security Lake untuk Wilayah AWS atau membuat pelanggan, konsol Security Lake menyediakan opsi untuk menambahkan tag ke sumber daya—konfigurasi data lake untuk Wilayah atau pelanggan. Ikuti petunjuk di konsol untuk menambahkan tag ke sumber daya saat Anda membuat sumber daya.

Untuk menambahkan satu atau beberapa tag ke sumber daya yang ada menggunakan konsol Security Lake, ikuti langkah-langkah berikut.

Untuk membuat sumber daya dan menambahkan satu atau beberapa tag ke dalamnya secara terprogram, gunakan Create operasi yang sesuai untuk jenis sumber daya yang ingin Anda buat:

Dalam permintaan Anda, gunakan tags parameter untuk menentukan kunci tag (key) dan nilai tag opsional (value) untuk setiap tag untuk ditambahkan ke sumber daya. tagsParameter menentukan array objek. Setiap objek menentukan kunci tag dan nilai tag terkait.

Untuk menambahkan satu atau beberapa tag ke sumber daya yang ada, gunakan TagResourcepengoperasian Security Lake API atau, jika Anda menggunakan AWS CLI, jalankan perintah tag-resource. Dalam permintaan Anda, tentukan Nama Sumber Daya Amazon (ARN) dari sumber daya yang ingin Anda tambahkan tag. Gunakan tags parameter untuk menentukan kunci tag (key) dan nilai tag opsional (value) untuk setiap tag yang akan ditambahkan. Seperti halnya untuk Create operasi dan perintah, tags parameter menentukan array objek, satu objek untuk setiap kunci tag dan nilai tag yang terkait.

Misalnya, AWS CLI perintah berikut menambahkan kunci Environment tag dengan nilai Cloud tag ke pelanggan yang ditentukan. Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\) untuk meningkatkan keterbacaan.

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

Di mana:

Dalam contoh berikut, perintah menambahkan beberapa tag ke pelanggan.

$ 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

Untuk setiap objek dalam tags array, kedua value argumen key dan argumen diperlukan. Namun, nilai untuk value argumen dapat berupa string kosong. Jika Anda tidak ingin mengaitkan nilai tag dengan kunci tag, jangan tentukan nilai untuk value argumen tersebut. Misalnya, perintah berikut menambahkan kunci Owner tag tanpa nilai tag terkait:

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

Jika operasi penandaan berhasil, Security Lake mengembalikan respons HTTP 200 kosong. Jika tidak, Security Lake mengembalikan respons HTTP 4 xx atau 500 yang menunjukkan mengapa operasi gagal.

Ikuti langkah-langkah ini untuk meninjau tag sumber daya dengan menggunakan konsol Security Lake.

Bagian Tag mencantumkan semua tag yang saat ini ditetapkan ke sumber daya.

Untuk mengambil dan meninjau tag untuk sumber daya yang ada secara terprogram, gunakan ListTagsForResourcepengoperasian Security Lake API. Dalam permintaan Anda, gunakan resourceArn parameter untuk menentukan Nama Sumber Daya Amazon (ARN) sumber daya.

Jika Anda menggunakan AWS Command Line Interface (AWS CLI), jalankan list-tags-for-resourceperintah dan gunakan resource-arn parameter untuk menentukan ARN sumber daya. Sebagai contoh:

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

Dalam contoh sebelumnya, arn:aws:securitylake:us-east- 1:123456789012: subscriber/1234abcd-12ab-34cd-56ef-1234567890ab adalah ARN dari pelanggan yang sudah ada.

Jika operasi berhasil, Security Lake mengembalikan tags array. Setiap objek dalam array menentukan tag (baik kunci tag dan nilai tag) yang saat ini ditetapkan ke sumber daya. Sebagai contoh:

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

Di mana EnvironmentCostCenter,, dan Owner merupakan kunci tag yang ditetapkan ke sumber daya. Cloudadalah nilai tag yang terkait dengan kunci Environment tag. 12345adalah nilai tag yang terkait dengan kunci CostCenter tag. Kunci Owner tag tidak memiliki nilai tag terkait.

Ikuti langkah-langkah ini untuk mengedit tag sumber daya dengan menggunakan konsol Security Lake.

Saat Anda mengedit tag untuk sumber daya secara terprogram, Anda menimpa tag yang ada dengan nilai baru. Oleh karena itu, cara terbaik untuk mengedit tag tergantung pada apakah Anda ingin mengedit kunci tag, nilai tag, atau keduanya. Untuk mengedit kunci tag, hapus tag saat ini dan tambahkan tag baru.

Untuk mengedit atau menghapus hanya nilai tag yang terkait dengan kunci tag, timpa nilai yang ada dengan menggunakan TagResourcepengoperasian Security Lake API. Jika Anda menggunakan AWS Command Line Interface (AWS CLI), jalankan perintah tag-resource. Dalam permintaan Anda, tentukan Nama Sumber Daya Amazon (ARN) sumber daya yang nilai tagnya ingin Anda edit atau hapus.

Untuk mengedit nilai tag, gunakan tags parameter untuk menentukan kunci tag yang nilai tag yang ingin Anda ubah. Juga tentukan nilai tag baru untuk kunci tersebut. Misalnya, AWS CLI perintah berikut mengubah nilai tag dari Cloud menjadi On-Premises kunci Environment tag yang ditetapkan ke pelanggan yang ditentukan. Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\) untuk meningkatkan keterbacaan.

$ 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

Di mana:

Untuk menghapus nilai tag dari kunci tag, jangan tentukan nilai untuk value argumen kunci dalam tags parameter. Sebagai contoh:

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

Jika operasi berhasil, Security Lake mengembalikan respons HTTP 200 kosong. Jika tidak, Security Lake mengembalikan respons HTTP 4 xx atau 500 yang menunjukkan mengapa operasi gagal.

Ikuti langkah-langkah ini untuk menghapus satu atau beberapa tag dari sumber daya menggunakan konsol Security Lake.

Untuk menghapus satu atau beberapa tag dari sumber daya secara terprogram, gunakan UntagResourcepengoperasian Security Lake API. Dalam permintaan Anda, gunakan resourceArn parameter untuk menentukan Amazon Resource Name (ARN) sumber daya untuk menghapus tag dari. Gunakan tagKeys parameter untuk menentukan kunci tag tag yang akan dihapus. Untuk menghapus beberapa tag, tambahkan tagKeys parameter dan argumen untuk setiap tag yang akan dihapus, dipisahkan oleh ampersand (&) —misalnya,. tagKeys=key1&tagKeys=key2 Untuk menghapus hanya nilai tag tertentu (bukan kunci tag) dari sumber daya, edit tag alih-alih menghapus tag.

Jika Anda menggunakan AWS Command Line Interface (AWS CLI), jalankan perintah untag-resource untuk menghapus satu atau beberapa tag dari sumber daya. Untuk resource-arn parameter, tentukan ARN sumber daya untuk menghapus tag dari. Gunakan tag-keys parameter untuk menentukan kunci tag tag yang akan dihapus. Misalnya, perintah berikut menghapus Environment tag (baik kunci tag dan nilai tag) dari pelanggan yang ditentukan:

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

Di mana resource-arn menentukan ARN pelanggan untuk menghapus tag dari, Environment dan merupakan kunci tag tag untuk dihapus.

Untuk menghapus beberapa tag dari sumber daya, tambahkan setiap kunci tag tambahan sebagai argumen untuk tag-keys parameter. Sebagai contoh:

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

Jika operasi berhasil, Security Lake mengembalikan respons HTTP 200 kosong. Jika tidak, Security Lake mengembalikan respons HTTP 4 xx atau 500 yang menunjukkan mengapa operasi gagal.