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 ロールまたはユーザーにアタッチして、タグベースのアクセスコントロールを有効にできます。

コンソールを使用する

サポートされているリソースの作成中または編集中に、いつでもタグを追加、変更、削除できます。

API を使用する

タグ付けオペレーションを実行するには、タグ付けオペレーションを実行するリソースの Amazon リソースネーム (ARN) が必要です。タグを追加または管理するリソースに応じて、タグ付けオペレーションのセットが 2 種類あります。

次の表は、さまざまなユースケースと、それらに使用するタグ付けオペレーションをまとめたものです。

ユースケース	Amazon Bedrock API オペレーションで作成されたリソース	Amazon Bedrock Agents API オペレーションで作成されたリソース	Amazon Bedrock Data Automation API で作成されたリソース
リソースにタグを付ける	リソースがまだ作成されていない場合は、リソースの作成時に tagsフィールドを使用します。 リソースが既に作成されている場合は、Amazon Bedrock コントロールプレーンエンドポイントを使用して TagResource リクエストを行います。	リソースがまだ作成されていない場合は、リソースの作成時に tagsフィールドを使用します。 リソースが既に作成されている場合は、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して TagResource リクエストを行います。	リソースがまだ作成されていない場合は、リソースの作成時に tagsフィールドを使用します。 リソースがすでに作成されている場合は、Amazon Bedrock Data Automation ビルドタイムエンドポイントを使用して TagResource リクエストを行います。
リソースのタグを解除する	Amazon Bedrock コントロールプレーンエンドポイントを使用して UntagResource リクエストを行います。	Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して UntagResource リクエストを行います。	Amazon Bedrock Data Automation ビルドタイムエンドポイントを使用して UntagResource リクエストを行います。
リソースのタグの一覧表示	Amazon Bedrock コントロールプレーンエンドポイントを使用して ListTagsForResource リクエストを行います。	Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して ListTagsForResource リクエストを行います。	Amazon Bedrock Data Automation ビルドタイムエンドポイントを使用して ListTagsForResource リクエストを行います。

注記

CloudTrail でこれらのオペレーションを表示する場合、イベントの詳細でリクエストパラメータを確認することで、タグ付けされている特定のリソースを特定できます。

タブを選択すると、インターフェイスまたは言語でコード例が表示されます。

AWS CLI

エージェントに 2 つのタグを追加します。キーと値のペア同士をスペースで区切ります。

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)

エージェントに 2 つのタグを追加します。

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