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

# 标记 Amazon Bedrock 资源
<a name="tagging"></a>

为了帮助您管理 Amazon Bedrock 资源，您可以将元数据以标签形式分配给每个资源。标签是您分配给 AWS 资源的标签。每个标签均包含一个键和一个值。

标签使您能够以不同的方式对 AWS 资源进行分类，例如按用途、所有者或应用程序。有关标记的最佳做法和限制，请参阅为资源[添加 AWS 标签](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。

标签可帮助您执行以下操作：
+ 识别和整理您的 AWS 资源。许多 AWS 资源都支持标记，因此您可以为不同服务中的资源分配相同的标签，以表明资源相同。
+ 分配成本。您可以在 AWS 账单与成本管理 控制面板上激活标签。 AWS 使用标签对您的成本进行分类，并向您提供每月成本分配报告。有关更多信息，请参阅*AWS 账单与成本管理 用户指南*中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 控制对 资源的访问。您可以在 Amazon Bedrock 中使用标签来创建策略以控制对 Amazon Bedrock 资源的访问。这些策略可以附加到 IAM 角色或用户，以启用基于标签的访问控制。

**Topics**
+ [使用控制台](#tagging-console)
+ [使用 API](#tagging-api)

## 使用控制台
<a name="tagging-console"></a>

在创建或编辑支持的资源时，您可以随时添加、修改和删除标签。

## 使用 API
<a name="tagging-api"></a>

要执行标记操作，您需要想对其执行标记操作的资源的 Amazon 资源名称 (ARN)。有两组标记操作，具体取决于您要为其添加或管理标签的资源。

下表汇总了不同的使用案例以及为这些案例使用的标记操作：


****  

| 使用案例 | 使用 [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API 操作创建的资源 | 使用 [Amazon Bedrock 代理](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) API 操作创建的资源 | 使用 Amazon Bedrock 数据自动化功能 API 创建的资源 | 
| --- | --- | --- | --- | 
| 标记资源 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/bedrock/latest/userguide/tagging.html)  | 
| 取消标记资源 | 使用 [Amazon Bedrock 控制平面终端节点[UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)发出请求。 | 使用 [Amazon Bedrock 构建时终端节点的代理[UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)提出请求。 | 使用 Amazon Bedrock 数据自动化构建时间端点 UntagResource 提出请求。 | 
| 列出资源的标签 | 使用 [Amazon Bedrock 控制平面终端节点[ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)发出请求。 | 使用 [Amazon Bedrock 构建时终端节点的代理[ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)提出请求。 | 使用 Amazon Bedrock 数据自动化构建时间端点 ListTagsForResource 提出请求。 | 

**注意**  
在中查看这些操作时 CloudTrail，您可以通过查看事件详细信息中的请求参数来识别被标记的特定资源。

选择一个选项卡，查看界面或语言中的代码示例。

------
#### [ AWS CLI ]

为代理添加两个标签。用空格分隔 key/value 成对子。

```
aws bedrock-agent tag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tags key=department,value=billing key=facing,value=internal
```

从代理中删除标签。用空格分隔键。

```
aws bedrock-agent untag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tag-keys key=department facing
```

列出代理的标签。

```
aws bedrock-agent list-tags-for-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```

------
#### [ Python (Boto) ]

为代理添加两个标签。

```
import boto3

bedrock = boto3.client(service_name='bedrock-agent')

tags = [
    {
        'key': 'department',
        'value': 'billing'
    },
    {
        'key': 'facing',
        'value': 'internal'
    }
]

bedrock.tag_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', tags=tags)
```

从代理中删除标签。

```
bedrock.untag_resource(
    resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', 
    tagKeys=['department', 'facing']
)
```

列出代理的标签。

```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```

------