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

コンソールを使用する

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

API を使用する

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

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

ユースケース Amazon Bedrock API オペレーションで作成されたリソース Amazon Bedrock エージェント API オペレーションで作成されたリソース Amazon Bedrock Data Automation API で作成されたリソース
リソースへのタグ付け

  • リソースがまだ作成されていない場合は、リソースの作成時に 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')