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

# Gunakan operasi API dan AWS CLI tag
<a name="tags-operations"></a>

Gunakan operasi tag berikut untuk menambah, menghapus, atau mencantumkan tag pada sumber daya.


****  

| API | CLI | Deskripsi tindakan | 
| --- | --- | --- | 
| TagResource | tag-resource | Tambahkan atau timpa satu atau lebih tag pada sumber daya yang memiliki ARN yang ditentukan. | 
| UntagResource | untag-resource | Hapus satu atau lebih tag dari sumber daya yang memiliki ARN yang ditentukan. | 
| ListTagsForResource | list‑tags‑for‑resource | Buat daftar satu atau lebih tag untuk sumber daya yang memiliki ARN yang ditentukan. | 

**Tambahkan tag saat Anda membuat sumber daya**  
Untuk menambahkan tag saat Anda membuat grup kerja atau katalog data, gunakan `tags` parameter dengan operasi `CreateWorkGroup` atau `CreateDataCatalog` API atau dengan `create-data-catalog` perintah AWS CLI `create-work-group` atau.

## Kelola tag menggunakan tindakan API
<a name="tags-operations-examples-java"></a>

Contoh berikut menunjukkan cara menggunakan tindakan API tag untuk mengelola tag pada grup kerja dan katalog data. Contohnya adalah dalam bahasa pemrograman Java.

### Contoh - TagResource
<a name="tags-operations-examples-java-tag-resource"></a>

Contoh berikut menambahkan dua tag ke workgroup`workgroupA`:

```
List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTags(tags);

client.tagResource(request);
```

Contoh berikut menambahkan dua tag ke katalog data`datacatalogA`:

```
List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("tagKey1").withValue("tagValue1"));
tags.add(new Tag().withKey("tagKey2").withValue("tagValue2"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTags(tags);

client.tagResource(request);
```

**catatan**  
Jangan menambahkan kunci tag duplikat ke sumber daya yang sama. Jika Anda melakukannya, Athena mengeluarkan pesan kesalahan. Jika Anda menandai sumber daya menggunakan kunci tag yang ada dalam `TagResource` tindakan terpisah, nilai tag baru akan menimpa nilai lama.

### Contoh - UntagResource
<a name="tags-operations-examples-java-untag-resource"></a>

Contoh berikut menghapus `tagKey2` dari workgroup`workgroupA`:

```
List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA")
    .withTagKeys(tagKeys);

client.untagResource(request);
```

Contoh berikut menghapus `tagKey2` dari katalog data`datacatalogA`:

```
List<String> tagKeys = new ArrayList<>();
tagKeys.add("tagKey2");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA")
    .withTagKeys(tagKeys);

client.untagResource(request);
```

### Contoh - ListTagsForResource
<a name="tags-operations-examples-java-list-tags-for-resource"></a>

Contoh berikut mencantumkan tag untuk workgroup`workgroupA`:

```
ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();
```

Contoh berikut mencantumkan tag untuk katalog data`datacatalogA`:

```
ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();
```

## Mengelola tag menggunakan AWS CLI
<a name="tags-operations-examples-cli"></a>

Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat dan mengelola tag pada katalog data.

### Tambahkan tag ke sumber daya: tag-resource
<a name="tags-operations-examples-cli-tag-resource"></a>

`tag-resource`Perintah menambahkan satu atau lebih tag ke sumber daya tertentu.

**Sintaksis**  
`aws athena tag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tags Key=string,Value=string Key=string,Value=string`

`--resource-arn`Parameter menentukan sumber daya yang tag ditambahkan. `--tags`Parameter menentukan daftar pasangan kunci-nilai yang dipisahkan spasi untuk ditambahkan sebagai tag ke sumber daya. 

**Example**  
Contoh berikut menambahkan tag ke katalog `mydatacatalog` data.  

```
aws athena tag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tags Key=Color,Value=Orange Key=Time,Value=Now
```
Untuk menunjukkan hasilnya, gunakan `list-tags-for-resource` perintah.   
Untuk informasi tentang menambahkan tag saat menggunakan `create-data-catalog` perintah, lihat[Mendaftarkan katalog: Create-data-catalog](datastores-hive-cli.md#datastores-hive-cli-registering-a-catalog).

### Daftar tag untuk sumber daya: list-tags-for-resource
<a name="tags-operations-examples-cli-list-tags-for-resource"></a>

`list-tags-for-resource`Perintah mencantumkan tag untuk sumber daya yang ditentukan.

**Sintaksis**  
`aws athena list-tags-for-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name`

`--resource-arn`Parameter menentukan sumber daya yang tag terdaftar. 

Contoh berikut mencantumkan tag untuk katalog `mydatacatalog` data.

```
aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog
```

Hasil contoh berikut adalah dalam format JSON.

```
{
    "Tags": [
        {
            "Key": "Time",
            "Value": "Now"
        },
        {
            "Key": "Color",
            "Value": "Orange"
        }
    ]
}
```

### Hapus tag dari sumber daya: untag-resource
<a name="tags-operations-examples-cli-untag-resource"></a>

`untag-resource`Perintah menghapus kunci tag yang ditentukan dan nilai terkaitnya dari sumber daya yang ditentukan.

**Sintaksis**  
`aws athena untag-resource --resource-arn arn:aws:athena:region:account_id:datacatalog/catalog_name --tag-keys key_name [key_name ...]` 

`--resource-arn`Parameter menentukan sumber daya dari mana tag dihapus. `--tag-keys`Parameter mengambil daftar nama kunci yang dipisahkan spasi. Untuk setiap nama kunci yang ditentukan, `untag-resource` perintah menghapus kunci dan nilainya.

Contoh berikut menghapus `Time` kunci `Color` dan dan nilainya dari sumber daya `mydatacatalog` katalog.

```
aws athena untag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tag-keys Color Time
```