Gunakan operasi API dan AWS CLI tag - Amazon Athena
Kelola tag menggunakan tindakan APIMengelola tag menggunakan AWS CLI

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

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

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

Contoh berikut menambahkan dua tag ke workgroupworkgroupA:

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 datadatacatalogA:

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 berikut menghapus tagKey2 dari workgroupworkgroupA:

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 datadatacatalogA:

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 berikut mencantumkan tag untuk workgroupworkgroupA:

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 datadatacatalogA:

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

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

tag-resourcePerintah 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-arnParameter menentukan sumber daya yang tag ditambahkan. --tagsParameter menentukan daftar pasangan kunci-nilai yang dipisahkan spasi untuk ditambahkan sebagai tag ke sumber daya.

contoh

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, lihatMendaftarkan katalog: Create-data-catalog.

list-tags-for-resourcePerintah 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-arnParameter 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"
        }
    ]
}

untag-resourcePerintah 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-arnParameter menentukan sumber daya dari mana tag dihapus. --tag-keysParameter 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