标记资源

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

标签使您能够以不同的方式对 AWS 资源进行分类，例如按用途、所有者或应用程序。标签可帮助您执行以下操作：

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

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

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

您可以标记的 Amazon Bedrock 资源包括：

• 自定义模型

• 模型自定义作业

• 预调配模型

• 批量推理作业（仅限 API）

• 代理

• 代理别名

• 知识库

• 模型评估（仅限控制台）

• 提示管理中的提示

• 流

• 流量别名

使用控制台

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

使用 API

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

1. 以下资源使用 Amazon Bedrock TagResourceUntagResource、和ListTagsForResource操作。

   • 自定义模型

   • 模型自定义作业

   • 预调配模型

   • 批量推理作业

2. 以下资源使用 Amazon Bedrock TagResource代理和ListTagsForResource操作。UntagResource

   • 代理

   • 代理别名

   • 知识库

   • 提示管理中的提示

   • 流

   • 流量别名

要为资源添加标签，请发送 Amazon Bedrock TagResource或 Amazon Bedrock TagResource代理请求。

要取消资源标签，请发送UntagResource或UntagResource请求。

要列出资源的标签，请发送ListTagsForResource或ListTagsForResource请求。

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

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

最佳实践和限制

有关标记的最佳做法和限制，请参阅为资源添加 AWS 标签。