Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menandai domain OpenSearch Layanan Amazon
Tag memungkinkan Anda menetapkan informasi arbitrer ke domain OpenSearch Layanan Amazon sehingga Anda dapat mengkategorikan dan memfilter informasi tersebut. Tag adalah pasangan kunci-nilai yang Anda tentukan dan kaitkan dengan domain OpenSearch Layanan. Anda dapat menggunakan tag ini untuk melacak biaya dengan mengelompokkan biaya untuk sumber daya yang ditandai serupa. AWS tidak menerapkan makna semantik apa pun pada tag Anda. Tanda ditafsirkan dengan ketat sebagai string karakter. Semua tanda memiliki elemen berikut:
Elemen tanda | Deskripsi | Diperlukan |
---|---|---|
Kunci tanda |
Kunci tanda adalah nama dari tanda. Kunci harus unik untuk domain OpenSearch Layanan yang dilampirkan. Untuk daftar batasan dasar pada kunci dan nilai tanda, lihat Pembatasan Tanda yang Ditetapkan Pengguna. |
Ya |
Nilai tanda |
Nilai tanda adalah nilai string dari tanda. Nilai tanda dapat berupa |
Tidak |
Setiap domain OpenSearch Layanan memiliki kumpulan tag, yang berisi semua tag yang ditetapkan ke domain OpenSearch Layanan tersebut. AWS tidak secara otomatis menetapkan tag apa pun ke domain OpenSearch Layanan. Sebuah kumpulan tanda dapat berisi antara 0 dan 50 tanda. Jika Anda menambahkan tanda ke domain dengan kunci yang sama dengan tanda yang ada, nilai yang baru akan menimpa nilai yang lama.
Contoh penandaan
Anda dapat menggunakan kunci, untuk menentukan kategori, dan nilai dapat berupa item dalam kategori tersebut. Misalnya, Anda dapat menentukan kunci tag project
dan nilai tagSalix
, yang menunjukkan bahwa domain OpenSearch Layanan ditetapkan ke proyek Salix. Anda juga dapat menggunakan tag untuk menunjuk domain OpenSearch Layanan sebagai digunakan untuk pengujian atau produksi dengan menggunakan kunci seperti environment=test
atau. environment=production
Coba gunakan sekumpulan kunci tag yang konsisten untuk memudahkan melacak metadata yang terkait dengan domain OpenSearch Layanan.
Anda juga dapat menggunakan tag untuk mengatur AWS tagihan Anda untuk mencerminkan struktur biaya Anda sendiri. Untuk melakukan ini, daftar untuk mendapatkan Akun AWS tagihan Anda dengan nilai kunci tag disertakan. Lalu, kelola informasi penagihan Anda sesuai dengan sumber daya dengan nilai kunci tanda yang sama untuk melihat biaya sumber daya gabungan. Misalnya, Anda dapat menandai beberapa domain OpenSearch Layanan dengan pasangan nilai kunci, lalu mengatur informasi penagihan Anda untuk melihat total biaya untuk setiap domain di beberapa layanan. Untuk informasi selengkapnya, lihat Penggunaan Tanda Alokasi Biaya dalam dokumentasi Manajemen Penagihan dan BiayaAWS .
catatan
Tanda disimpan di cache untuk tujuan otorisasi. Karena itu, penambahan dan pembaruan tag pada domain OpenSearch Layanan mungkin memerlukan waktu beberapa menit sebelum tersedia.
Cara menggunakan tanda (konsol)
Konsol adalah cara termudah untuk menandai domain.
Untuk membuat tag (konsol)
-
Masuk ke https://aws.amazon.com
, kemudian pilih Masuk ke Konsol. -
Di bawah Analytics, pilih OpenSearch Layanan Amazon.
-
Pilih domain yang ingin Anda tambahkan tag dan buka tab Tag.
-
Pilih Kelola dan Tambahkan tag baru.
-
Masukkan kunci tag dan nilai opsional.
-
Pilih Simpan.
Untuk menghapus tag, ikuti langkah yang sama dan pilih Hapus pada halaman Kelola tag.
Untuk informasi selengkapnya tentang menggunakan konsol untuk bekerja dengan tag, lihat Editor Tag di Panduan Memulai KonsolAWS Manajemen.
Cara menggunakan tanda (AWS CLI)
Anda dapat membuat tag sumber daya menggunakan --add-tags perintah AWS CLI with the.
Sintaks
add-tags --arn=<domain_arn> --tag-list
Key=<key>,Value=<value>
Parameter | Deskripsi |
---|---|
--arn |
Nama sumber daya Amazon untuk domain OpenSearch Layanan tempat tag dilampirkan. |
--tag-list |
Kumpulan pasangan nilai kunci yang dipisahkan spasi dalam format berikut: Key=<key>,Value=<value> |
Contoh
Contoh berikut membuat dua tanda untuk domain log:
aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge
Anda dapat menghapus tag dari domain OpenSearch Layanan menggunakan --remove-tags perintah.
Sintaks
remove-tags --arn=<domain_arn> --tag-keys
Key=<key>,Value=<value>
Parameter | Deskripsi |
---|---|
--arn |
Nama Sumber Daya Amazon (ARN) untuk domain OpenSearch Layanan tempat tag dilampirkan. |
--tag-keys |
Set pasangan nilai kunci yang dipisahkan spasi yang ingin Anda hapus dari domain Layanan. OpenSearch |
Contoh
Contoh berikut menghapus dua tanda dari domain log yang dibuat dalam contoh sebelumnya:
aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances
Anda dapat melihat tag yang ada untuk domain OpenSearch Layanan dengan --list-tags perintah:
Sintaks
list-tags --arn=<domain_arn>
Parameter | Deskripsi |
---|---|
--arn |
Nama Sumber Daya Amazon (ARN) untuk domain OpenSearch Layanan tempat tag dilampirkan. |
Contoh
Contoh berikut mencantumkan semua tanda sumber daya untuk domain log:
aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs
Bekerja dengan tag (AWS SDK)
AWS SDK (kecuali SDK Android dan iOS) mendukung semua tindakan yang ditentukan dalam Referensi API OpenSearch Layanan Amazon, termasuk, AddTags
ListTags
, dan RemoveTags
operasi. Untuk informasi selengkapnya tentang menginstal dan menggunakan AWS SDK, lihat Kit PengembanganAWS Perangkat Lunak
Python
Contoh ini menggunakan klien Python OpenSearchServiceDOMAIN_ARN
, TAG_KEY
, dan TAG_VALUE
.
import boto3 from botocore.config import Config # import configuration DOMAIN_ARN = '' # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain TAG_KEY = '' # The name of the tag key. i.e 'Smileyface' TAG_VALUE = '' # The value assigned to the tag. i.e 'Practicetag' # defines the configurations parameters such as region my_config = Config(region_name='us-east-1') client = boto3.client('opensearch', config=my_config) # defines the client variable def addTags(): """Adds tags to the domain""" response = client.add_tags(ARN=DOMAIN_ARN, TagList=[{'Key': TAG_KEY, 'Value': TAG_VALUE}]) print(response) def listTags(): """List tags that have been added to the domain""" response = client.list_tags(ARN=DOMAIN_ARN) print(response) def removeTags(): """Remove tags that have been added to the domain""" response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY]) print('Tag removed') return response