翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon OpenSearch Ingestion パイプラインのタグ付け
<a name="tag-pipeline"></a>

タグを使用すると、Amazon OpenSearch Ingestion パイプラインに任意の情報を割り当て、その情報を分類しフィルタリングすることができます。*タグ*は、ユーザーが割り当てるか、 AWS リソース AWS に割り当てるメタデータラベルです。各タグは、*キー*と*値*から構成されます。ユーザーが割り当てるタグでは、ユーザーがキーと値を定義します。たとえば、1 つのリソースのキーを `stage` と定義し、値を `test` と定義します。

タグは、以下のことに役立ちます。
+  AWS リソースを特定して整理します。多くの AWS サービスはタグ付けをサポートしているため、異なるサービスのリソースに同じタグを割り当てて、リソースが関連していることを示すことができます。例えば、Amazon OpenSearch Service ドメインに割り当てる OpenSearch Ingestion パイプラインに、同じタグを割り当てることができます。
+  AWS コストを追跡します。 AWS Billing and Cost Management ダッシュボードでこれらのタグをアクティブ化します。 はタグ AWS を使用してコストを分類し、毎月のコスト配分レポートを配信します。詳細については、[「AWS Billing ユーザーガイド」](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)の[「コスト配分タグの使用」](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/)(Use Cost Allocation Tags) を参照してください。
+ 属性ベースのアクセス制御を使用して、パイプラインへのアクセスを制限します。詳細については、IAM ユーザーガイドの[タグキーに基づいたアクセス制御](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys)を参照してください。

OpenSearch Ingestion では、主要なリソースはパイプラインです。OpenSearch Service コンソール、 AWS CLI、OpenSearch Ingestion APIs、または AWS SDKs を使用して、パイプラインからタグを追加、管理、削除できます。

**Topics**
+ [必要なアクセス許可](#pipeline-tag-permissions)
+ [タグの操作 (コンソール)](#tag-pipeline-console)
+ [タグの操作 (AWS CLI)](#tag-pipeline-cli)

## 必要なアクセス許可
<a name="pipeline-tag-permissions"></a>

OpenSearch Ingestion は、パイプラインのタグ付けに次の AWS Identity and Access Management Access Analyzer (IAM) アクセス許可を使用します。
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

各アクセス許可の詳細については、「*サービス認証リファレンス*」の「[Actions, resources, and condition keys for OpenSearch Ingestion](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html)」を参照してください。

## タグの操作 (コンソール)
<a name="tag-pipeline-console"></a>

コンソールは、パイプラインにタグ付けする際の最も簡単な方法です。

****タグを作成するには****

1. [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines) で Amazon OpenSearch Service コンソールにサインインします。Pipelines ページが表示されます。

1. タグを追加するパイプラインを選択し、**[タグ]** タブに移動します。

1. [**管理**] を選択して、[**新しいタグを追加**] を選択します。

1. タグキーとオプションの値を入力します。

1. **[保存]** を選択します。

タグを削除するには、同じ手順に従って、[**タグを管理**] ページで [**削除**] を選択します。

タグを操作するコンソールを使用する方法の詳細については、*AWS マネジメントコンソール入門ガイド*の「[タグエディター](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html)」を参照してください。

## タグの操作 (AWS CLI)
<a name="tag-pipeline-cli"></a>

を使用してパイプラインにタグを付けるには AWS CLI、 `TagResource`リクエストを送信します。

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

`UntagResource` コマンドを使用してパイプラインからタグを削除します。

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

`ListTagsForResource` コマンドを使用してパイプラインの既存のタグを表示します。

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