Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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.
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: Create-data-catalog.
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 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.
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
