翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Bedrock リソースにタグ付け

Amazon Bedrock リソースを管理しやすくするために、各リソースにメタデータをタグとして割り当てることができます。タグは、 AWS リソースに割り当てるラベルです。各タグは、キー と 値 から構成されます。

タグを使用すると、目的、所有者、アプリケーションなど、さまざまな方法で AWS リソースを分類できます。タグ付けのベストプラクティスと制限については、「 AWS リソースのタグ付け」を参照してください。

タグは、以下のことに役立ちます。

bedrock-runtime エンドポイントのリソースにタグを付ける

bedrock-runtime コントロールプレーンを介して作成されたリソース (エージェント、ナレッジベース、カスタムモデル、プロビジョニングされたスループット、フローなど) は、専用のタグ付け API オペレーションを使用してタグ付けされます。

コンソールを使用する

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

API を使用する

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

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

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

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

bedrock-mantle エンドポイントのリソースにタグを付ける

bedrock-mantle エンドポイントは、タグ付けプロジェクト、カスタマイズされたモデル、予約をサポートしています。bedrock-runtime コントロールプレーンとは異なり、 bedrock-mantleは専用の TagResource、UntagResource、または ListTagsForResource API オペレーションを公開しません。代わりに、リソース APIs。

タグの設定

タグは、これらのリソースの応答の取得と一覧表示でインラインで返されます。

IAM アクション

専用タグ付けエンドポイントはありませんが、bedrock-mantleリソースのタグを設定、変更、または読み取ると、次の IAM アクションが評価されます。これらのアクション名と aws:RequestTag、、および aws:ResourceTag条件キーを使用して IAM ポリシーを記述しaws:TagKeys、タグベースのアクセスを制御できます。

例

次の例では、 を使用して 2 つのタグを持つプロジェクトを作成しますcurl。

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "billing-experiments",
      "tags": {
        "department": "billing",
        "facing": "internal"
      }
    }'

次の例では、1 つのタグを追加し、既存のプロジェクトから別のタグを削除します。

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "add_tags": { "owner": "alice" },
      "remove_tag_keys": ["facing"]
    }'