

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengedit tag untuk sumber daya Amazon Security Lake
<a name="tags-update"></a>

Untuk mengedit tag (kunci tag atau nilai tag) untuk sumber daya Amazon Security Lake, Anda dapat menggunakan konsol Security Lake atau Security Lake API.

**penting**  
Mengedit tag untuk sumber daya dapat memengaruhi akses ke sumber daya. Sebelum Anda mengedit kunci tag atau nilai untuk sumber daya, tinjau kebijakan AWS Identity and Access Management (IAM) apa pun yang mungkin menggunakan tag untuk mengontrol akses ke sumber daya.

------
#### [ Console ]

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

**Untuk mengedit tag untuk sumber daya**

1. Buka konsol Security Lake di [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).

1. Bergantung pada jenis sumber daya yang tagnya ingin Anda edit, lakukan salah satu hal berikut:
   + Untuk konfigurasi data lake, pilih **Wilayah** di panel navigasi. Kemudian, di tabel **Regions**, pilih Region.
   + Untuk pelanggan, pilih **Pelanggan** di panel navigasi. Kemudian, di tabel **Pelanggan saya**, pilih pelanggan.

     Jika pelanggan tidak muncul di tabel, gunakan Wilayah AWS pemilih di sudut kanan atas halaman untuk memilih Wilayah tempat Anda membuat pelanggan. Tabel mencantumkan pelanggan yang ada hanya untuk Wilayah saat ini.

1. Pilih **Edit**.

1. Perluas bagian**Tag**. Bagian **Tag** mencantumkan semua tag yang saat ini ditetapkan ke sumber daya.

1. Lakukan salah satu langkah berikut ini:
   + Untuk menambahkan nilai tag ke kunci tag yang ada, masukkan nilai di kotak **Nilai** di sebelah kunci tag.
   + Untuk mengubah kunci tag yang ada, pilih **Hapus** di sebelah tag. Kemudian pilih **Tambahkan tag baru**. Di kotak **Kunci** yang muncul, masukkan kunci tag baru. Secara opsional masukkan nilai tag terkait di kotak **Nilai**.
   + Untuk mengubah nilai tag yang ada, pilih **X** di kotak **Nilai** yang berisi nilai. Kemudian masukkan nilai tag baru di **Nilai** kotak.
   + Untuk menghapus nilai tag yang ada, pilih **X** di kotak **Nilai** yang berisi nilai.
   + Untuk menghapus tag yang ada (kunci tag dan nilai tag), pilih **Hapus** di sebelah tag.

   Sumber daya dapat memiliki sebanyak 50 tag. Kunci tag dapat berisi sebanyak 128 karakter. Nilai tag dapat berisi sebanyak 256 karakter. Karakter dapat berupa huruf, angka, spasi, atau simbol berikut: \$1.:/= \$1 - @

1. Setelah Anda selesai mengedit tag, pilih **Simpan**.

------
#### [ API ]

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](tags-remove.md) dan [tambahkan tag baru](tags-add.md).

Untuk mengedit atau menghapus hanya nilai tag yang terkait dengan kunci tag, timpa nilai yang ada dengan menggunakan [TagResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_TagResource.html)pengoperasian Security Lake API. Jika Anda menggunakan AWS Command Line Interface (AWS CLI), jalankan perintah [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/tag-resource.html). 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 (\$1) 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:
+ `resource-arn`menentukan ARN pelanggan.
+ `Environment`adalah kunci tag yang terkait dengan nilai tag yang akan diubah.
+ `On-Premises`adalah nilai tag baru untuk kunci tag yang ditentukan (`Environment`).

Untuk menghapus nilai tag dari kunci tag, jangan tentukan nilai untuk `value` argumen kunci dalam `tags` parameter. 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.

------

## Meninjau tag untuk sumber daya Amazon Security Lake
<a name="tags-retrieve"></a>

Anda dapat meninjau tag (kunci tag dan nilai tag) untuk sumber daya Amazon Security Lake menggunakan konsol Security Lake atau Security Lake API.

------
#### [ Console ]

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

**Untuk meninjau tag untuk sumber daya**

1. Buka konsol Security Lake di [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).

1. Bergantung pada jenis sumber daya yang tagnya ingin Anda tinjau, lakukan salah satu hal berikut:
   + Untuk konfigurasi data lake, pilih **Wilayah** di panel navigasi. Di tabel **Regions**, pilih Region, lalu pilih **Edit**. Kemudian perluas bagian **Tag**.
   + Untuk pelanggan, pilih **Pelanggan** di panel navigasi. Kemudian, di tabel **Pelanggan saya**, pilih nama pelanggan.

     Jika pelanggan tidak muncul di tabel, gunakan Wilayah AWS pemilih di sudut kanan atas halaman untuk memilih Wilayah tempat Anda membuat pelanggan. Tabel mencantumkan pelanggan yang ada hanya untuk Wilayah saat ini.

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

------
#### [ API ]

Untuk mengambil dan meninjau tag untuk sumber daya yang ada secara terprogram, gunakan [ListTagsForResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListTagsForResource.html)pengoperasian 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-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/list-tags-for-resource.html)perintah dan gunakan `resource-arn` parameter untuk menentukan ARN sumber daya. 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 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. Contoh:

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

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

------