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

タグ付けできる Amazon Bedrock リソースは以下のとおりです。

  • アプリケーション推論プロファイル

  • カスタムモデル

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

  • モデル複製ジョブ

  • プロビジョンドモデル

  • バッチ推論ジョブ (API のみ）

  • エージェント

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

  • ナレッジベース

  • モデル評価 (コンソールのみ)

  • プロンプト管理におけるプロンプト

  • フロー

  • フローのエイリアス

コンソールを使用する

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

API を使用する

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

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

    • アプリケーション推論プロファイル

    • カスタムモデル

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

    • モデル複製ジョブ

    • プロビジョンドモデル

    • バッチ推論ジョブ

  2. 次のリソースは、Amazon Bedrock エージェント TagResource、UntagResource、および ListTagsForResourceオペレーションを使用します。

    • エージェント

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

    • ナレッジベース

    • プロンプト管理におけるプロンプト

    • フロー

    • フローのエイリアス

リソースにタグを追加するには、Amazon Bedrock TagResourceまたは 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')