Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tandai sumber daya Amazon Kinesis Data Streams Anda
*Anda dapat menetapkan metadata Anda sendiri ke streaming dan konsumen penggemar yang disempurnakan yang Anda buat di Amazon Kinesis Data Streams dalam bentuk tag.* Tanda adalah pasangan nilai-kunci yang Anda tetapkan untuk sebuah aliran. Menggunakan tag adalah cara sederhana namun ampuh untuk mengelola AWS sumber daya dan mengatur data, termasuk data penagihan.
**Topics**
+ [Tinjau dasar-dasar tag](#tagging-basics)
+ [Lacak biaya menggunakan penandaan](#tagging-billing)
+ [Memahami batasan tag](#tagging-restrictions)
+ [Tag stream menggunakan konsol Kinesis Data Streams](#tagging-console)
+ [Tag stream menggunakan AWS CLI](#tagging-cli)
+ [Tag stream menggunakan Kinesis Data Streams APIs](#tagging-api)
+ [Tag konsumen menggunakan AWS CLI](#tagging-consumers-cli)
+ [Tag konsumen menggunakan Kinesis Data Streams APIs](#tagging-consumers-api)
## Tinjau dasar-dasar tag
Sumber daya Kinesis Data Streams yang dapat Anda beri tag termasuk aliran data dan konsumen penggemar yang disempurnakan. Anda menggunakan AWS CLI konsol Kinesis Data Streams, atau Kinesis Data Streams API untuk menyelesaikan tugas-tugas berikut:
+ Buat sumber daya dengan tag
+ Tambahkan tag ke sumber daya
+ Buat daftar tag untuk sumber daya Anda
+ Hapus tag dari sumber daya
**catatan**
Anda tidak dapat menerapkan tag ke konsumen penggemar yang disempurnakan menggunakan konsol Kinesis Data Streams. Untuk menerapkan tag ke konsumen, gunakan AWS CLI atau Kinesis Data Streams API.
Anda dapat menggunakan tag untuk mengkategorikan sumber daya Anda. Misalnya, Anda dapat mengkategorikan sumber daya berdasarkan tujuan, pemilik, atau lingkungan. Karena Anda menentukan kunci dan nilai untuk setiap tanda, Anda dapat membuat serangkaian kategori khusus untuk memenuhi kebutuhan spesifik Anda. Misalnya, Anda dapat menentukan satu set tag yang membantu Anda melacak sumber daya oleh pemilik dan aplikasi terkait. Berikut adalah beberapa contoh tanda:
+ Proyek: Nama proyek
+ Pemilik: Nama
+ Tujuan: Pengujian beban
+ Aplikasi: Nama aplikasi
+ Lingkungan: Produksi
**penting**
Untuk menambahkan tag saat membuat aliran, Anda harus menyertakan `kinesis:AddTagsToStream` izin `kinesis:CreateStream` dan untuk aliran tersebut. Anda **tidak dapat menggunakan** `kinesis:TagResource` izin untuk menandai aliran saat membuatnya.
Untuk menambahkan tag selama pendaftaran konsumen, Anda harus menyertakan `kinesis:TagResource` dan `kinesis:RegisterStreamConsumer` izin.
## Lacak biaya menggunakan penandaan
Anda dapat menggunakan tag untuk mengkategorikan dan melacak biaya Anda AWS . Saat Anda menerapkan tag ke sumber daya Kinesis Data Streams AWS , laporan alokasi biaya mencakup penggunaan dan biaya yang dikumpulkan berdasarkan tag. Anda dapat menerapkan tag yang mewakili kategori bisnis, seperti pusat biaya, nama aplikasi, atau pemilik, untuk mengatur biaya Anda di beberapa layanan. Untuk informasi selengkapnya, lihat [Menggunakan Tanda Alokasi Biaya untuk Laporan Penagihan Khusus](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dalam *Panduan Pengguna AWS Billing *.
## Memahami batasan tag
Batasan berikut ini berlaku untuk tag:
**Batasan dasar**
+ Jumlah maksimum tag untuk setiap sumber daya adalah 50.
+ Kunci dan nilai tag peka terhadap huruf besar dan kecil.
+ Anda tidak dapat mengubah atau mengedit tag untuk sumber daya yang dihapus.
**Batasan kunci tanda**
+ Setiap kunci tanda harus unik. Jika Anda menambahkan tanda dengan kunci yang sudah digunakan, tanda baru akan menimpa pasangan nilai-kunci yang sudah ada.
+ Anda tidak dapat memulai kunci tag `aws:` karena awalan ini dicadangkan untuk digunakan oleh AWS. AWS membuat tag yang dimulai dengan awalan ini atas nama Anda, tetapi Anda tidak dapat mengedit atau menghapusnya.
+ Kunci tanda harus memiliki panjang antara 1 dan 128 karakter Unicode.
+ Kunci tanda harus terdiri dari karakter berikut: huruf Unicode, digit, spasi, dan karakter khusus berikut: `_ . / = + - @`.
**Batasan nilai tanda**
+ Panjang nilai tanda harus antara 0 dan 255 karakter Unicode.
+ Nilai tanda dapat kosong. Jika tidak, nilai tanda harus terdiri dari karakter berikut: huruf Unicode, digit, spasi, dan salah satu karakter khusus berikut: `_ . / = + - @`.
## Tag stream menggunakan konsol Kinesis Data Streams
Anda dapat menambahkan, memperbarui, mencantumkan, dan menghapus tag di aliran menggunakan konsol Kinesis Data Streams.
**Untuk melihat tag untuk aliran**
1. [Masuk ke Konsol Manajemen AWS dan buka konsol Kinesis di /kinesis. https://console.aws.amazon.com](https://console.aws.amazon.com/kinesis)
1. Di panel navigasi kiri, pilih **Aliran data**.
1. Pada halaman **Data stream**, pilih stream yang ingin Anda tag.
1. Pada halaman Detail Stream, pilih **Konfigurasi**.
1. Di bagian **Tag**, lihat tag yang diterapkan ke aliran.
**Untuk membuat aliran data dengan tag**
1. Buka konsol Kinesis Data Streams.
1. Di panel navigasi kiri, pilih **Aliran data**.
1. Pilih **Create data stream** (Buat aliran data).
1. Pada halaman **Buat aliran data**, masukkan nama untuk aliran data Anda.
1. Untuk **kapasitas aliran Data**, pilih mode **On-Demand** atau **Provisioned** capacity.
Untuk informasi selengkapnya tentang mode kapasitas, lihat[Pilih mode yang tepat untuk streaming](how-do-i-size-a-stream.md).
1. Di bagian **Tag**, lakukan hal berikut:
1. Pilih **Tambahkan tag baru**.
1. Untuk **Kunci**, masukkan tag dan secara opsional tentukan nilai di bidang **Nilai**.
Jika Anda melihat kesalahan, kunci tag atau nilai yang Anda tentukan tidak memenuhi batasan tag. Untuk informasi selengkapnya, lihat [Memahami batasan tag](#tagging-restrictions).
1. Pilih **Create data stream** (Buat aliran data).
**Untuk menambah atau memperbarui tag pada aliran**
1. Buka konsol Kinesis Data Streams.
1. Di panel navigasi kiri, pilih **Aliran data**.
1. Pada halaman **Aliran data**, pilih aliran yang ingin Anda tambahkan atau perbarui tag.
1. Pada halaman Detail Stream, pilih **Konfigurasi**.
1. Di bagian **Tanda**, pilih **Kelola tanda**.
1. Di bawah **Tag**, lakukan salah satu hal berikut:
+ Untuk menambahkan tag baru, pilih **Tambahkan tag baru**, lalu masukkan data **Kunci** dan **Nilai** tag. Ulangi langkah ini seperlunya.
Jumlah maksimum tag yang dapat Anda tambahkan untuk setiap aliran adalah 50.
+ Untuk memperbarui tag yang ada, masukkan nilai tag baru di bidang **Nilai** **Kunci** tag tersebut.
Jika Anda melihat kesalahan, kunci tag atau nilai yang Anda tentukan tidak memenuhi batasan tag. Untuk informasi selengkapnya, lihat [Memahami batasan tag](#tagging-restrictions).
1. Pilih **Simpan perubahan**.
**Untuk menghapus tag dari aliran**
1. Buka konsol Kinesis Data Streams.
1. Di panel navigasi kiri, pilih **Aliran data**.
1. Pada halaman **Aliran data**, pilih aliran dari mana Anda ingin menghapus tag.
1. Pada halaman Detail Stream, pilih **Konfigurasi**.
1. Di bagian **Tanda**, pilih **Kelola tanda**.
1. Temukan tag **Key** dan **Value** pair yang ingin Anda hapus. Kemudian, pilih **Hapus**.
1. Pilih **Simpan perubahan**.
## Tag stream menggunakan AWS CLI
Anda dapat menambahkan, membuat daftar, dan menghapus tag pada aliran Anda menggunakan. AWS CLI Sebagai contoh, lihat dokumentasi berikut.
[buat-aliran](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)
Membuat aliran dengan tag.
[add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)
Menambahkan atau memperbarui tag untuk aliran yang ditentukan.
[list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)
Daftar tag untuk aliran yang ditentukan.
[remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)
Menghapus tag dari aliran yang ditentukan.
## Tag stream menggunakan Kinesis Data Streams APIs
Anda dapat menambahkan, membuat daftar, dan menghapus tag pada aliran Anda menggunakan Kinesis Data Streams. APIs Untuk contoh, lihat dokumentasi berikut:
[CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)
Membuat aliran dengan tag.
[AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)
Menambahkan atau memperbarui tag untuk aliran yang ditentukan.
[ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)
Daftar tag untuk aliran yang ditentukan.
[RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)
Menghapus tag dari aliran yang ditentukan.
## Tag konsumen menggunakan AWS CLI
Anda dapat menambahkan, membuat daftar, dan menghapus tag pada konsumen Anda menggunakan AWS CLI. Untuk contoh, lihat dokumentasi berikut:
[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)
Mendaftarkan konsumen untuk aliran data Kinesis dengan tag.
[tag-sumber daya](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)
Menambahkan atau memperbarui tag untuk sumber Kinesis tertentu.
[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)
Daftar tag untuk sumber daya Kinesis yang ditentukan.
[untag-sumber daya](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)
Menghapus tag dari sumber Kinesis yang ditentukan.
## Tag konsumen menggunakan Kinesis Data Streams APIs
Anda dapat menambahkan, membuat daftar, dan menghapus tag pada konsumen Anda menggunakan Kinesis APIs Data Streams. Untuk contoh, lihat dokumentasi berikut:
[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)
Mendaftarkan konsumen untuk aliran data Kinesis dengan tag.
[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)
Menambahkan atau memperbarui tag untuk sumber Kinesis tertentu.
[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)
Daftar tag untuk sumber daya Kinesis yang ditentukan.
[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)
Menghapus tag dari sumber Kinesis yang ditentukan.