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

# Amazon Bedrock リソースにタグ付け
<a name="tagging"></a>

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

タグを使用すると、目的、所有者、アプリケーションなど、さまざまな方法で AWS リソースを分類できます。タグ付けのベストプラクティスと制限については、「 [AWS リソースのタグ付け](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)」を参照してください。

タグは、以下のことに役立ちます。
+  AWS リソースを特定して整理します。多くの AWS リソースはタグ付けをサポートしているため、異なるサービスのリソースに同じタグを割り当てて、リソースが同じであることを示すことができます。
+ コストの割り当て。 AWS Billing and Cost Management ダッシュボードでタグをアクティブ化します。 AWS はタグを使用してコストを分類し、毎月のコスト配分レポートを配信します。詳細については、「*AWS Billing and Cost Management * ユーザーガイド」の「[コスト配分タグを使用する](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。
+ リソースへのアクセス制御。Amazon Bedrock でタグを使用して、Amazon Bedrock リソースへのアクセスを制御するポリシーを作成することができます。これらのポリシーを IAM ロールまたはユーザーにアタッチして、タグベースのアクセスコントロールを有効にできます。

**Topics**
+ [コンソールを使用する](#tagging-console)
+ [API を使用する](#tagging-api)

## コンソールを使用する
<a name="tagging-console"></a>

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

## API を使用する
<a name="tagging-api"></a>

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

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


****  

| ユースケース | [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API オペレーションで作成されたリソース | [Amazon Bedrock エージェント](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) API オペレーションで作成されたリソース | Amazon Bedrock Data Automation API で作成されたリソース | 
| --- | --- | --- | --- | 
| リソースへのタグ付け |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/tagging.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/tagging.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/tagging.html)  | 
| リソースのタグの削除 | [Amazon Bedrock コントロールプレーンエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)を使用して [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html) リクエストを行います。 | [Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) リクエストを行います。 | Amazon Bedrock Data Automation ビルドタイムエンドポイントを使用して UntagResource リクエストを行います。 | 
| リソースのタグの一覧表示 | [Amazon Bedrock コントロールプレーンエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp)を使用して [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html) リクエストを行います。 | [Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) リクエストを行います。 | 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')
```

------