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

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

标记 Amazon Bedrock 资源

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

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

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

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

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

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

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

  • 自定义模型

  • 模型自定义作业

  • 模型复制作业

  • 预调配模型

  • Batch 推理作业（API仅限）

  • 代理

  • 代理别名

  • 知识库

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

  • 提示管理中的提示

  • 流

  • 流量别名

使用控制台

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

使用 API

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

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

    • 自定义模型

    • 模型自定义作业

    • 模型复制作业

    • 预调配模型

    • 批量推理作业

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

    • 代理

    • 代理别名

    • 知识库

    • 提示管理中的提示

    • 流

    • 流量别名

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

要取消对资源的标记，请发送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')