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

# コスト配分に IAM プリンシパルを使用する
<a name="iam-principal-cost-allocation"></a>

## 概要
<a name="iam-principal-cost-allocation-overview"></a>

AWS は、IAM プリンシパル ID とタグに基づいて Amazon Bedrock のコスト配分をサポートしているため、組織はアプリケーションや組織構造全体で発信者 ID によって使用状況とコストを追跡できます。この機能は、 AWS コストと使用状況レポート (CUR 2.0) および AWS コスト管理ツールと統合され、生成 AI 支出を可視化します。

## IAM プリンシパルベースのコスト配分の仕組み
<a name="iam-principal-cost-allocation-how-it-works"></a>

CUR 2.0 で IAM プリンシパルデータを有効にすると、 は各 Bedrock API コールの発信者 ID (IAM プリンシパル ARN) を `line_item_iam_principal`列に自動的に AWS 記録します。IAM プリンシパル (ユーザーまたはロール) にタグを追加すると、それらのタグは関連するコストとトークン使用量で自動的にキャプチャされます。これにより、CloudWatch ログと CloudTrail ログを請求データと組み合わせる必要があった手動調整プロセスがなくなります。

## 主な利点
<a name="iam-principal-cost-allocation-benefits"></a>

この機能は、組織が生成 AI コストを管理する方法を変革します。有効にすると、自動発信者 ID 追跡を通じて Bedrock モデルを呼び出すユーザーとロールがすぐに可視化されます。IAM プリンシパルタグを重ねると、この使用量とコストを組織構造、チーム、プロジェクト、アプリケーションにマッピングできます。

この可視性により、組織全体で効果的なコスト配分が可能になり、情報に基づいた AI リソース計画の決定をサポートし、支出を削減するための最適化の機会が明らかになります。この機能は、 AWS Cost Explorer とコストと使用状況レポート (CUR 2.0) を通じて既存の AWS コスト管理ワークフローとシームレスに統合されるため、追加のツールやプロセスは必要ありません。 Cost Explorer 

組織は正確なチャージバックとショーバックコストを実装し、AI 支出の説明責任を確保できます。

## 前提条件
<a name="iam-principal-cost-allocation-prereqs"></a>

コスト配分に IAM プリンシパルタグを使用する前に、以下があることを確認してください。
+ **IAM ID:** Amazon Bedrock API コールを行う IAM ユーザーまたはロール
+ **IAM プリンシパルタグ:** IAM コンソールで IAM ユーザーまたはロールに適用されるタグ
+ アクセス**許可:** IAM および Billing and AWS Cost Management コンソールへのアクセス

## コスト配分用の IAM プリンシパルタグの設定
<a name="iam-principal-cost-allocation-setup"></a>

### ステップ 1: IAM コンソールで IAM プリンシパルタグを適用する
<a name="iam-principal-cost-allocation-step1"></a>

1. [IAM console] (IAM コンソール) に入ります。

1. Amazon Bedrock にアクセスする IAM ユーザーまたはロールを選択します。

1. 組織構造を表すタグ (、、、`department``cost-center``team`、 など`environment`) `project`を適用します。

**注記**  
Amazon Bedrock の場合、タグを持つ IAM プリンシパルが少なくとも 1 つの API コールを行った後にのみ、タグがアクティベーションに表示されます。これは、プリンシパルが IAM ユーザー、ロール、または引き受けたロールセッションのいずれであっても適用されます。

### ステップ 2: コスト配分のために IAM プリンシパルタグをアクティブ化し、セットアップを検証する
<a name="iam-principal-cost-allocation-step2"></a>

1. [https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/) で Billing and AWS Cost Management コンソールを開きます。

1. 左側のナビゲーションペインの **Cost Organization** で、**Cost Allocation Tags** を選択します。

1. IAM プリンシパルタイプのタグをフィルタリングします。

1. アクティブ化する IAM プリンシパルタグを検索して選択します。

1. [**アクティブ化**] を選択します。

1. これらのタグが**アクティブ**と表示されることを確認します。

**注記**  
IAM プリンシパルにタグを適用すると、アクティベーションのためにタグキーがコスト配分タグページに表示されるまでに最大 24 時間かかることがあります。タグキーがアクティブ化されるまでに最大 24 時間かかることがあります。

### ステップ 3: CUR 2.0 で IAM プリンシパルデータを有効にする
<a name="iam-principal-cost-allocation-step3"></a>

1. Billing and AWS Cost Management コンソールに移動します。

1. **データエクスポート**セクションに移動します。

1. 新しいデータエクスポートを作成するときは、**標準データエクスポート ** (CUR 2.0) を選択します。

1. **追加エクスポートコンテンツ**で、**発信者 ID (IAM プリンシパル) 割り当てデータを含める**を選択します。

1. 設定を保存します。

これにより、CUR 2.0 エクスポートで`line_item_iam_principal`列と関連する IAM プリンシパルタグが有効になります。

**注記**  
IAM プリンシパルデータを有効にすると、各モデルにアクセスする呼び出し元の ID の数の CUR 行数が 1 倍増加し、一般的な CUR エクスポートと比較してファイルサイズが大きくなります。

## AWS コストと使用状況レポートでの IAM プリンシパルタグの表示
<a name="iam-principal-cost-allocation-cur"></a>

セットアップが完了すると、IAM プリンシパルタグが他のコスト配分タグとともに CUR 2.0 に表示されます。CUR 2.0 でコストデータを表示する場合、異なるソース (リソース、ユーザー属性、アカウント、IAM プリンシパル、コストカテゴリ) からのタグはプレフィックスで区別され、複数のコンテキストで同じタグキーを使用する場合の競合を防ぎます。タグプレフィックスの仕組みと重複するタグキーの例の詳細については、[CUR 2.0 Tags Column ドキュメント](https://docs.aws.amazon.com/cur/latest/userguide/table-dictionary-cur2-tag-columns.html)を参照してください。

### 新しい CUR 2.0 列
<a name="iam-principal-cost-allocation-cur-column"></a>

`line_item_iam_principal` 列には、Bedrock AWS リクエストを行うプリンシパルの IAM ARN が含まれます。フォーマットの例:
+ `arn:aws:iam::123456789012:user/userID_A`
+ `arn:aws:iam::123456789012:role/application-role`
+ `arn:aws:sts::123456789012:assumed-role/application-role/session-name`

### タグ列の IAM プリンシパルタグ
<a name="iam-principal-cost-allocation-cur-tags"></a>

IAM プリンシパルタグには、プレフィックスの`iamPrincipal/`後にタグキーが続きます。例えば、次のようになります。
+ `iamPrincipal/department`
+ `iamPrincipal/cost-center`
+ `iamPrincipal/app`

## Cost Explorer での IAM プリンシパルタグの使用
<a name="iam-principal-cost-allocation-ce"></a>

### IAM プリンシパルタグによるグループ化
<a name="iam-principal-cost-allocation-ce-group"></a>

グループ化してカスタムコストビューを作成します。

1. Cost Explorer で、ドロップダウン**でグループ**を選択します。

1. グループ化ディメンションとして**タグ**を選択します。

1. アクティブ化された IAM プリンシパルタグ (例: `iamPrincipal/department`) を選択します。

1. タグ値別に集計コストを表示します。

### IAM プリンシパルタグによるフィルタリング
<a name="iam-principal-cost-allocation-ce-filter"></a>

1. Billing and Cost Management コンソールで AWS Cost Explorer を開きます。

1. **タグ**ドロップダウンに、アクティブ化された IAM プリンシパルタグのフィルターを追加します。

1. これらの IAM プリンシパルタグ別に分類されたコストを表示します。

## ベストプラクティス
<a name="iam-principal-cost-allocation-best-practices"></a>
+ **意味のあるタグキーを使用する:** 組織構造 (`department`、、`cost-center`、) に合ったタグを選択します`team``project`。
+ **高カーディナリティタグを避ける:** 一意のセッション IDs、タイムスタンプ、またはランダム GUIDsタグ値として使用しないでください。
+ **タグ命名を標準化する:** 組織全体で一貫したタグキー命名規則を確立します。
+ **タグの使用を定期的に確認する:** コスト配分に使用されているタグを監視し、未使用のタグを非アクティブ化します。
+ **CUR ファイルサイズの拡大を計画する:** IAM プリンシパルデータを有効にする際の Amazon S3 ストレージコストの増加を考慮します。