標籤資源

為協助您管理 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 Resource Name (ARN)。有兩組標記作業，視要新增標籤或管理標籤的資源而定。

1. 以下資源使用 Amazon 基岩TagResource和ListTagsForResource操作。UntagResource

   • 自訂模型

   • 模型自訂工作

   • 佈建模型

   • 批次推論任務

2. 下列資源使用 Amazon 基岩TagResource和ListTagsForResource作業的代理程式。UntagResource

   • 代理程式

   • 代理程式別名

   • 知識庫

若要將標籤新增至資源，請傳送 Amazon 基岩TagResource或 Amazon 基岩請求的代理程式。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 源。