Menandai domain OpenSearch Layanan Amazon - OpenSearch Layanan Amazon

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 null dan tidak harus unik dalam kumpulan tanda. Misalnya, Anda dapat memiliki pasangan nilai kunci dalam kumpulan tanda project/Trinity dan cost-center/Trinity. Untuk daftar batasan dasar pada kunci dan nilai tanda, lihat Pembatasan Tanda yang Ditetapkan Pengguna.

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)
  1. Masuk ke https://aws.amazon.com, kemudian pilih Masuk ke Konsol.

  2. Di bawah Analytics, pilih OpenSearch Layanan Amazon.

  3. Pilih domain yang ingin Anda tambahkan tag dan buka tab Tag.

  4. Pilih Kelola dan Tambahkan tag baru.

  5. Masukkan kunci tag dan nilai opsional.

  6. 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, AddTagsListTags, dan RemoveTags operasi. Untuk informasi selengkapnya tentang menginstal dan menggunakan AWS SDK, lihat Kit PengembanganAWS Perangkat Lunak.

Python

Contoh ini menggunakan klien Python OpenSearchServicetingkat rendah dari AWS SDK for Python (Boto) untuk menambahkan tag ke domain, mencantumkan tag yang dilampirkan ke domain, dan menghapus tag dari domain. Anda harus memberikan nilai untuk DOMAIN_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