标记资源 - Amazon Bedrock

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

标记资源

为了帮助您管理 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代理请求。

要取消资源标签,请发送UntagResourceUntagResource请求。

要列出资源的标签,请发送ListTagsForResourceListTagsForResource请求。

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

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 标签