標記 Amazon Bedrock 資源 - Amazon Bedrock
使用主控台使用 API

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

標記 Amazon Bedrock 資源

為協助您管理 Amazon Bedrock 資源，您可以將中繼資料當做標籤將指派給每個資源。標籤是您指派給 AWS 資源的標籤。每個標籤皆包含索引鍵與值。

標籤可讓您以不同的方式分類 AWS 資源，例如依用途、擁有者或應用程式。如需標記的最佳實務和限制，請參閱標記您的 AWS 資源。

標籤可協助您執行以下操作：

  • 識別和組織您的 AWS 資源。許多 AWS 資源都支援標記，因此您可以將相同的標籤指派給不同服務中的資源，以指出資源是相同的。

  • 配置成本。您可以在 AWS 帳單與成本管理 儀表板上啟用標籤。 AWS 使用標籤來分類您的成本，並為您提供每月成本分配報告。如需詳細資訊，請參閱 AWS 帳單與成本管理 使用者指南中的使用成本配置標籤。

  • 控制對資源的存取。您可以搭配 Amazon Bedrock 使用標籤建立政策，以控制對 Amazon Bedrock 資源的存取。這些政策可連接至 IAM 角色或使用者，以啟用標籤型存取控制。

使用主控台

您可以在建立或編輯支援的資源時，隨時新增、修改和移除標籤。

使用 API

若要執行標記作業，您需要的是要對其執行標記作業的資源的 Amazon Resource Name (ARN)。有兩組標記作業，視要新增標籤或管理標籤的資源而定。

下表摘要說明不同的使用案例，以及要用於它們的標記操作：

使用案例 使用 Amazon Bedrock API 操作建立的資源 使用 Amazon Bedrock Agents API 操作建立的資源 使用 Amazon Bedrock Data Automation 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')