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

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

*标签*是您分配给 Amazon 资源的标签。每个标签都由一个*密钥*和一个可选*值组成*，这两个值都是您定义的。

标签使您能够以不同的方式对 Amazon 资源进行分类，例如按用途、所有者或环境进行分类。当你有许多相同类型的资源时，这很有用，你可以根据分配给它的标签快速识别特定的资源。

## 标记概述
<a name="tagging-overview"></a>

每个标签都由一个键和一个可选值组成。例如，您可以为账户的 AgentCore 资源定义一组标签，以帮助您跟踪每个资源的所有者和堆栈级别。

我们建议您针对每类资源设计一组标签，以满足您的需要。使用一组连续的标签键，管理 资源时会更加轻松。您可以根据添加的标签搜索和筛选资源。

标签没有任何语义意义 AgentCore ，被严格解释为字符串。同时，标签不会自动分配至您的资源。您可以修改标签的键和值，还可以随时删除资源的标签。您可以将标签的值设置为空字符串，但不能将标签的值设置为空值。如果添加的标签的键与该资源上现有标签的键相同，新值就会覆盖旧值。如果删除资源，则该资源的所有标签也会被删除。

## 支持标记的资源
<a name="tagging-supported-resources"></a>

以下 AgentCore 资源支持标记：
+ 代理运行时间
+ 代理运行时端点
+ 容量提供程序
+ 代码解释器
+ 浏览器
+ 浏览器配置文件
+ 网关
+ 工作负载身份
+ OAuth2 凭证提供商
+ API 密钥凭证提供商
+ 工作负载身份目录
+ 代币库
+ AgentCore 记忆
+ 自定义评估器
+ 在线评估配置
+ 策略引擎
+ 配置包
+ 批量评估
+ 建议
+ AB 测试

## 标签限制
<a name="tagging-restrictions"></a>

下面是适用于标签的基本限制：
+ 每个资源的标签数上限：50
+ 对于每个资源，每个标签密钥必须是唯一的，并且每个标签密钥只能有一个值。
+ 最大密钥长度 — 包含 128 个 Unicode 字符 UTF-8
+ 最大值长度 — 256 个 Unicode 字符 UTF-8
+ 如果标签方案针对多个服务和资源使用，请记得其他服务可能对支持的字符有限制。通常允许使用的字符有：字母、数字和可表示的空格 UTF-8，以及以下字符：\+-=. \_:/@。
+ 标签键不区分大小写，而标签值区分大小写。
+ 不要使用`aws:``AWS:`、或任何大写或小写组合，例如密钥或值的前缀，因为它们是留待 Amazon 使用的。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

## 使用标签
<a name="tagging-working-with"></a>

您可以使用控制台、API 或 CLI 添加、编辑或删除 AgentCore 资源的标签。

### 添加 标签
<a name="tagging-adding"></a>

**Example**  

1. 创建以下 AgentCore 资源时可以添加标签：
   + 代理运行时间
   + 代理运行时端点
   + 代码解释器
   + 浏览器
   + 浏览器配置文件
   + 网关
   + 工作负载身份
   + OAuth2 凭证提供商
   + API 密钥凭证提供商
   + 自定义评估器
   + 在线评估配置
   + 策略引擎
   + 配置包
   + 批量评估
   + 建议
   + AB 测试

      **在创建资源时添加标签 ** 

1. 打开控制 AgentCore 台。

1. 导航到要创建的资源类型。

1. 按照步骤创建资源。当您到达 “**标签**” 部分时，选择 “**添加标签” **。

1. 输入标签密钥和（可选）标签值。

1. 要添加更多标签，请**再次选择**添加标签。

1. 完成资源创建过程。

    **向现有资源添加标签** 

1. 打开控制 AgentCore 台。

1. 导航到资源类型并选择特定资源。

1. 选择**标签**选项卡。

1. 选择**添加标签**，然后输入密钥和值（可选）。

1. 选择**保存更改**。

1. 您可以在创建资源时添加标签，也可以使用 AgentCore API 向现有资源添加标签。

    **创建资源时添加标签 ** 

   在使用以下 API 操作创建资源时，可以添加标签：
   +  [CreateAgentRuntime](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateAgentRuntime.html)— 在`tags`参数中包含标签。
   +  [CreateAgentRuntimeEndpoint](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateAgentRuntimeEndpoint.html)— 在`tags`参数中包含标签。
   +  [CreateCapacityProvider](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateCapacityProvider.html)— 在`tags`参数中包含标签。
   +  [CreateCodeInterpreter](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateCodeInterpreter.html)— 在`tags`参数中包含标签。
   +  [CreateBrowser](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateBrowser.html)— 在`tags`参数中包含标签。
   +  [CreateBrowserProfile](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateBrowserProfile.html)— 在`tags`参数中包含标签。
   +  [CreateGateway](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateGateway.html)— 在`tags`参数中包含标签。
   +  [CreateWorkloadIdentity](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateWorkloadIdentity.html)— 在`tags`参数中包含标签。
   +  [CreateOAuth2CredentialProvider](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateOAuth2CredentialProvider.html)— 在`tags`参数中包含标签。
   +  [CreateAPIKeyCredentialProvider](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateAPIKeyCredentialProvider.html)— 在`tags`参数中包含标签。
   +  [CreateEvaluator](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateEvaluator.html)— 在`tags`参数中包含标签。
   +  [CreateOnlineEvaluationConfig](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateOnlineEvaluationConfig.html)— 在`tags`参数中包含标签。
   +  [CreatePolicyEngine](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreatePolicyEngine.html)— 在`tags`参数中包含标签。
   +  [CreatePaymentCredentialProvider](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreatePaymentCredentialProvider.html)-在`tags`参数中包含标签。
   +  [CreatePaymentManager](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreatePaymentManager.html)-在`tags`参数中包含标签。
   +  [CreateConfigurationBundle](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_CreateConfigurationBundle.html)— 在`tags`参数中包含标签。
   +  [StartBatchEvaluation](https://docs.amazonaws.cn/bedrock-agentcore/latest/APIReference/API_StartBatchEvaluation.html)— 在`tags`参数中包含标签。
   +  [StartRecommendation](https://docs.amazonaws.cn/bedrock-agentcore/latest/APIReference/API_StartRecommendation.html)— 在`tags`参数中包含标签。
   +  [createAbTest ](https://docs.amazonaws.cn/bedrock-agentcore/latest/APIReference/API_CreateABTest.html) — 在参数中`tags`包含标签。

      **为现有资源添加标签 ** 

     使用[TagResource](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_TagResource.html)操作向现有资源添加标签。

1. 您可以使用 CLI 为 AgentCore 资源添加标签。

    **为资源添加标签** 

   使用 `tag-resource` 命令：

   ```
   aws bedrock-agentcore tag-resource \
       --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:agent-runtime/example-runtime \
       --tags Key=Environment,Value=Production Key=Team,Value=AI
   ```

### 管理标签
<a name="tagging-managing"></a>

**Example**  

1. 您可以在控制台中编辑现有资源的标签值。

    **编辑现有资源的标签 ** 

1. 打开控制 AgentCore 台。

1. 导航到资源类型并选择特定资源。

1. 选择**标签**选项卡。

1. 要编辑标签，请直接修改密钥或值。

1. 选择**保存更改**。

1. 您可以使用 AgentCore API 列出和管理资源的标签。

    **清单标签 ** 

   使用[ListTagsForResource](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_ListTagsForResource.html)操作列出资源的标签。

    **更新标签 ** 

   使用该[TagResource](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_TagResource.html)操作通过为现有密钥添加新值来更新现有标签。

1. 您可以使用 CLI 列出和管理 AgentCore 资源的标签。

    **列出资源标签** 

   使用 `list-tags-for-resource` 命令：

   ```
   aws bedrock-agentcore list-tags-for-resource \
       --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:agent-runtime/example-runtime
   ```

    **更新资源的标签 ** 

   使用`tag-resource`命令更新现有标签：

   ```
   aws bedrock-agentcore tag-resource \
       --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:agent-runtime/example-runtime \
       --tags Key=Environment,Value=Staging
   ```

### 删除标签
<a name="tagging-deleting"></a>

**Example**  

1. 您可以在控制台中删除资源的标签。

    **从资源中删除标签 ** 

1. 打开控制 AgentCore 台。

1. 导航到资源类型并选择特定资源。

1. 选择**标签**选项卡。

1. 要删除标签，请选择标签旁边的**删除**。

1. 选择**保存更改**。

1. 您可以使用 AgentCore API 从资源中移除标签。

    **移除标签 ** 

   使用该[UntagResource](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/API_UntagResource.html)操作从资源中移除标签。

1. 您可以使用 CLI 从 AgentCore 资源中删除标签。

    **从资源中删除标签** 

   使用 `untag-resource` 命令：

   ```
   aws bedrock-agentcore untag-resource \
       --resource-arn arn:aws:bedrock-agentcore:us-east-1:123456789012:agent-runtime/example-runtime \
       --tag-keys Environment Team
   ```