标记 Amazon Bedrock 资源 - Amazon Bedrock
使用控制台使用 API

标记 Amazon Bedrock 资源

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

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

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

  • 标识和整理您的 AWS 资源。许多 AWS 资源支持标记，因此，您可以将同一标签分配给不同服务中的资源，以指示这些资源是相同的。

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

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

使用控制台

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

使用 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

为代理添加两个标签。用空格分隔键/值对。

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')