View a markdown version of this page

标记资源 AgentCore - Amazon Bedrock AgentCore
标记概述支持标记的资源标签限制使用标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

标记资源 AgentCore

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

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

标记概述

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

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

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

支持标记的资源

以下 AgentCore 资源支持标记：

  • 代理运行时间

  • 代理运行时端点

  • 容量提供程序

  • 代码解释器

  • 浏览器

  • 浏览器配置文件

  • 网关

  • 工作负载身份

  • OAuth2 凭证提供商

  • API 密钥凭证提供商

  • 工作负载身份目录

  • 代币库

  • AgentCore 记忆

  • 自定义评估器

  • 在线评估配置

  • 策略引擎

  • 配置包

  • 批量评估

  • 建议

  • AB 测试

标签限制

下面是适用于标签的基本限制：

  • 每个资源的标签数上限：50

  • 对于每个资源，每个标签密钥必须是唯一的，并且每个标签密钥只能有一个值。

  • 最大密钥长度 — 包含 128 个 Unicode 字符 UTF-8

  • 最大值长度 — 256 个 Unicode 字符 UTF-8

  • 如果标签方案针对多个服务和资源使用，请记得其他服务可能对支持的字符有限制。通常允许使用的字符有：字母、数字和可表示的空格 UTF-8，以及以下字符：+-=. _:/@。

  • 标签键不区分大小写，而标签值区分大小写。

  • 不要使用aws:AWS:、或任何大写或小写组合，例如密钥或值的前缀，因为它们是留待 Amazon 使用的。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

使用标签

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

添加 标签

例
Console

  1. 创建以下 AgentCore 资源时可以添加标签：

    • 代理运行时间

    • 代理运行时端点

    • 代码解释器

    • 浏览器

    • 浏览器配置文件

    • 网关

    • 工作负载身份

    • OAuth2 凭证提供商

    • API 密钥凭证提供商

    • 自定义评估器

    • 在线评估配置

    • 策略引擎

    • 配置包

    • 批量评估

    • 建议

    • AB 测试

      在创建资源时添加标签

  2. 打开控制 AgentCore 台。

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

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

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

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

  7. 完成资源创建过程。

    向现有资源添加标签

  8. 打开控制 AgentCore 台。

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

  10. 选择标签选项卡。

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

  12. 选择保存更改。

API

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

    创建资源时添加标签

    在使用以下 API 操作创建资源时，可以添加标签：

CLI

  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

管理标签

例
Console

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

    编辑现有资源的标签

  2. 打开控制 AgentCore 台。

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

  4. 选择标签选项卡。

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

  6. 选择保存更改。

API

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

    清单标签

    使用ListTagsForResource操作列出资源的标签。

    更新标签

    使用该TagResource操作通过为现有密钥添加新值来更新现有标签。

CLI

  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

删除标签

例
Console

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

    从资源中删除标签

  2. 打开控制 AgentCore 台。

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

  4. 选择标签选项卡。

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

  6. 选择保存更改。

API

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

    移除标签

    使用该UntagResource操作从资源中移除标签。

CLI

  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