本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 标记 Amazon OpenSearch Ingestion 管道
<a name="tag-pipeline"></a>

标签允许您将任意信息分配给 Amazon OpenSearch Ingestion 管道，这样您就可以对这些信息进行分类和筛选。*标签*是您分配或分配给 AWS 资源的元数据标签。 AWS 每个标签均包含一个*键* 和一个*值*。对于您分配的标签，需要定义键和值。例如，您可以将键定义为 `stage`，将一个资源的值定义为 `test`。

标签可帮助您：
+ 识别和整理您的 AWS 资源。许多 AWS 服务都支持标记，因此您可以为来自不同服务的资源分配相同的标签，以表明这些资源是相关的。例如，您可以为分配给 Amazon S OpenSearch ervice OpenSearch 域的采集管道分配相同的标签。
+ 追踪您的 AWS 成本。您可以在 AWS 账单与成本管理 控制面板上激活这些标签。 AWS 使用标签对您的成本进行分类，并向您提供每月成本分配报告。有关更多信息，请参阅《AWS Billing 用户指南》[https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/)中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 使用基于属性的访问控制限制管道访问。有关更多信息，请参阅 IAM 用户指南中的[根据标签密钥控制访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys)。

在 OpenSearch Ingestion 中，主要资源是管道。您可以使用 OpenSearch 服务控制台、 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`

有关每项权限的更多信息，请参阅《*服务授权*参考[ OpenSearch 》中的 “摄取操作、资源和条件密钥](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](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines) /home 登录亚马逊 OpenSearch 服务控制台。您将进入 “管道” 页面。

1. 选择您要将标签添加到的管道，然后转到**标签**选项卡。

1. 选择 **Manage（管理）**和 **Add new tag（添加新标签）**。

1. 输入一个标签键和可选的值。

1. 选择**保存**。

要删除标签，请按照相同步骤操作并在 **Manage tags（管理标签）**页面中选择 **Remove（删除）**。

有关使用控制台处理标签的更多信息，请参阅《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
```