View a markdown version of this page

标记 Amazon Bedrock 资源 - Amazon Bedrock
在基底运行时端点上标记资源在基岩地幔端点上标记资源

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

标记 Amazon Bedrock 资源

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

标签使您能够以不同的方式对 AWS 资源进行分类，例如按用途、所有者或应用程序进行分类。有关标记的最佳做法和限制，请参阅为资源添加 AWS 标签。

标签可帮助您执行以下操作：

  • 识别和整理您的 AWS 资源。许多 AWS 资源都支持标记，因此您可以为不同服务中的资源分配相同的标签，以表明这些资源是相同的。

  • 分配成本。您可以在 AWS 账单与成本管理 控制面板上激活标签。 AWS 使用标签对您的成本进行分类，并向您提供每月成本分配报告。有关更多信息，请参阅AWS 账单与成本管理 用户指南中的使用成本分配标签。

  • 控制对 资源的访问。您可以在 Amazon Bedrock 中使用标签来创建策略以控制对 Amazon Bedrock 资源的访问。这些策略可以附加到 IAM 角色或用户，以启用基于标签的访问控制。

在基底运行时端点上标记资源

通过bedrock-runtime控制平面创建的资源（例如代理、知识库、自定义模型、预配置吞吐量和流程）使用专用的标记 API 操作进行标记。

使用控制台

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

使用 API

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

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

使用案例 使用 Amazon Bedrock API 操作创建的资源 使用 Amazon Bedrock 代理 API 操作创建的资源 使用 Amazon Bedrock 数据自动化功能 API 创建的资源
标记资源

  • 如果资源尚未创建，请在创建资源时使用 tags 字段。

  • 如果资源已创建，请使用 Amazon Bedrock 数据自动化构建时间终端节点 TagResource 提出请求。
取消标记资源 使用 Amazon Bedrock 控制平面终端节点UntagResource发出请求。 使用适用于 Amazon Bedrock 构建时终端节点的代理UntagResource提出请求。 使用 Amazon Bedrock 数据自动化构建时间终端节点 UntagResource 提出请求。
列出资源的标签 使用 Amazon Bedrock 控制平面终端节点ListTagsForResource发出请求。 使用适用于 Amazon Bedrock 构建时终端节点的代理ListTagsForResource提出请求。 使用 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')

在基岩地幔端点上标记资源

该bedrock-mantle端点支持标记项目、自定义模型和预留。与bedrock-runtime控制平面不同，bedrock-mantle它不公开专用TagResourceUntagResource、或 ListTagsForResource API 操作。相反，您可以通过资源 API 内联设置和读取标签。

设置标签

处理建议 API 调用 标记字段
创建带有标签的项目 POST /v1/organization/projects tags
在现有项目上添加或移除标签 POST /v1/organization/projects/{project_id} add_tags, remove_tag_keys, tags
使用标签创建自定义模型 Customized-model 创建终端节点 tags
更新自定义模型上的标签 Customized-model 更新终端节点 add_tags, remove_tag_keys
使用标签创建预约 预留创建端点 tags
更新预订的标签 预留更新终端节点 add_tags, remove_tag_keys

这些资源的 “获取” 和 “列出” 响应中会以内联方式返回标签。

IAM 操作

尽管没有专用的标记终端节点，但是在您在bedrock-mantle资源上设置、更改或读取标签时，会评估以下 IAM 操作。您可以使用这些操作名称以及aws:RequestTagaws:TagKeys、和aws:ResourceTag条件键编写 IAM 策略来控制基于标签的访问权限。

  • bedrock-mantle:TagResource

  • bedrock-mantle:UntagResource

  • bedrock-mantle:ListTagsForResource

示例

以下示例使用以下方法创建具有两个标签的项目curl：

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "billing-experiments",
      "tags": {
        "department": "billing",
        "facing": "internal"
      }
    }'

以下示例在现有项目中添加一个标签并移除另一个标签：

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "add_tags": { "owner": "alice" },
      "remove_tag_keys": ["facing"]
    }'