リソースのタグ付け

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

1. 以下のリソースでは、Amazon Bedrock の TagResource、UntagResource、および ListTagsForResourceオペレーションを使用します。

   • カスタムモデル

   • モデルカスタマイズジョブ

   • プロビジョンドモデル

   • バッチ推論ジョブ

2. 以下のリソースでは、 Agents for Amazon Bedrock TagResource、、UntagResourceおよび ListTagsForResourceオペレーションを使用します。

   • エージェント

   • エージェントエイリアス

   • ナレッジベース

リソースにタグを追加するには、Amazon Bedrock TagResourceまたは Agents for Amazon Bedrock TagResourceリクエストを送信します。

リソースのタグを解除するには、 UntagResourceまたは UntagResourceリクエストを送信します。

リソースのタグを一覧表示するには、 ListTagsForResourceまたは ListTagsForResourceリクエストを送信します。

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

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

ベストプラクティスと制約事項

タグ付けのベストプラクティスと制限については、「 AWS リソースのタグ付け」を参照してください。