Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menandai saluran pipa Amazon OpenSearch Ingestion
<a name="tag-pipeline"></a>

Tag memungkinkan Anda menetapkan informasi arbitrer ke pipeline Amazon OpenSearch Ingestion sehingga Anda dapat mengkategorikan dan memfilter informasi tersebut. *Tag* adalah label metadata yang Anda tetapkan atau yang ditetapkan ke sumber AWS daya. AWS Setiap tanda terdiri dari *kunci* dan *nilai*. Untuk tanda yang Anda tetapkan, Anda menentukan kunci dan nilai. Misalnya, Anda dapat menentukan kunci sebagai `stage` dan nilai untuk satu sumber daya sebagai `test`.

Tanda membantu Anda melakukan hal berikut:
+ Identifikasi dan atur AWS sumber daya Anda. Banyak AWS layanan mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya dari layanan yang berbeda untuk menunjukkan bahwa sumber daya terkait. Misalnya, Anda dapat menetapkan tag yang sama ke pipeline OpenSearch Ingestion yang Anda tetapkan ke domain Layanan Amazon. OpenSearch 
+ Lacak AWS biaya Anda. Anda mengaktifkan tag ini di AWS Manajemen Penagihan dan Biaya dasbor. AWS menggunakan tag untuk mengkategorikan biaya Anda dan mengirimkan laporan alokasi biaya bulanan kepada Anda. Untuk informasi selengkapnya, lihat [Menggunakan Tag Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dalam [Panduan Pengguna AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Batasi akses ke saluran pipa menggunakan kontrol akses berbasis atribut. Untuk informasi selengkapnya, lihat [Mengontrol akses berdasarkan kunci tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) di Panduan Pengguna IAM.

Dalam OpenSearch Ingestion, sumber daya utama adalah pipa. Anda dapat menggunakan konsol OpenSearch Layanan, AWS CLI, OpenSearch Ingestion, atau AWS SDKs untuk menambah APIs, mengelola, dan menghapus tag dari pipeline.

**Topics**
+ [Izin diperlukan](#pipeline-tag-permissions)
+ [Cara menggunakan tanda (konsol)](#tag-pipeline-console)
+ [Cara menggunakan tanda (AWS CLI)](#tag-pipeline-cli)

## Izin diperlukan
<a name="pipeline-tag-permissions"></a>

OpenSearch Ingestion menggunakan izin AWS Identity and Access Management Access Analyzer (IAM) berikut untuk menandai pipeline:
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

Untuk informasi selengkapnya tentang setiap izin, lihat [Tindakan, sumber daya, dan kunci kondisi untuk OpenSearch Tertelan](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html) di Referensi *Otorisasi Layanan*.

## Cara menggunakan tanda (konsol)
<a name="tag-pipeline-console"></a>

Konsol adalah cara paling sederhana untuk menandai pipa.

****Untuk membuat tag****

1. Masuk ke konsol Amazon OpenSearch Service di [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Anda akan berada di halaman Pipelines.

1. Pilih pipeline yang ingin Anda tambahkan tag dan buka tab **Tag**.

1. Pilih **Kelola** dan **Tambahkan tag baru**.

1. Masukkan kunci tag dan nilai opsional.

1. 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](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) di *Panduan Memulai Konsol AWS Manajemen*.

## Cara menggunakan tanda (AWS CLI)
<a name="tag-pipeline-cli"></a>

Untuk menandai pipeline menggunakan AWS CLI, kirim `TagResource` permintaan: 

```
aws osis tag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline 
  --tags Key=service,Value=osis Key=source,Value=otel
```

Hapus tag dari pipa menggunakan `UntagResource` perintah:

```
aws osis untag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
  --tag-keys service
```

Lihat tag yang ada untuk pipeline dengan `ListTagsForResource` perintah:

```
aws osis list-tags-for-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
```