Operasi penggunaan 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 beberapa tag pada sumber daya yang telah ditentukanARN.
UntagResource	untag-resource	Hapus satu atau lebih tag dari sumber daya yang telah ditentukanARN.
ListTagsForResource	list‑tags‑for‑resource	Buat daftar satu atau lebih tag untuk sumber daya yang telah ditentukanARN.

Tambahkan tag saat Anda membuat sumber daya

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

Kelola tag menggunakan API tindakan

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

Contoh - TagResource

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 - UntagResource

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 - ListTagsForResource

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.

Tambahkan tag ke sumber daya: tag-resource

tag-resourcePerintah menambahkan satu atau lebih tag ke sumber daya tertentu.

Sintaks

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: C reate-data-catalog.

Daftar tag untuk sumber daya: list-tags-for-resource

list-tags-for-resourcePerintah mencantumkan tag untuk sumber daya yang ditentukan.

Sintaks

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 sampel berikut dalam JSON format.

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

Hapus tag dari sumber daya: untag-resource

untag-resourcePerintah menghapus kunci tag yang ditentukan dan nilai terkaitnya dari sumber daya yang ditentukan.

Sintaks

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