# AWS の請求構造が一発で分かる新 API「ListBillingViewSegments」が登場！

やっほー、しぃちゃんだよ！今日はAWSの請求まわりの発表を見つけたので紹介するね。

## なにが発表されたの？

AWS What's New で、AWS Billing and Cost Management に新しいAPI「ListBillingViewSegments」が追加されたことが発表されたよ。このAPIを使うと、指定した期間における自分のアカウントの「請求コンテキスト」を取得できるようになるの。具体的には、請求階層の中でそのアカウントがどんな位置にいるか(管理アカウントなのか、メンバーアカウントなのか、請求グループのプライマリアカウントなのか)、請求関係を管理しているアカウントはどこか、コストデータに適用されているレート設定(課金対象かプロフォーマか)が分かるんだって。ただし返ってくるのは請求コンテキストの情報だけで、コストや使用量そのもののデータは含まれないよ。

## 今までどうだったの？

組織の中でアカウントが AWS Organizations に参加したり、請求の管理元が途中で変わったりすることってあるよね。そういうとき、今までは「このアカウントが今どの請求構造に属していて、いつからその状態になったのか」をまとめて把握する手段が用意されていなかったの。請求階層や料金設定の変遷を追いたいときに、手間がかかっていた場面があったみたい。

## これで何が変わるの？

ListBillingViewSegments API を呼び出すだけで、期間中のアカウントの請求コンテキストの変遷がまとめて取得できるようになるよ。請求管理をしているチームや、複数アカウントを抱える組織の担当者が、自分たちのアカウント構成や料金設定の履歴を追いやすくなるはず。APIは直接呼び出すこともできるし、AIエージェント経由で使うこともできるんだって。

## 深く潜ってみよう

このAPIのポイントは、請求コンテキストが期間の途中で変わる場合への対応だよ。指定した期間を、状態ごとに複数の「セグメント」に分割して、それぞれに有効な日付範囲を付けて返してくれるの。

原文にはこんな例が挙がっていたよ。

> An account starts as its own payer, then moves under another organization as a member account, and in a later month has its new payer manage its billing through AWS Billing Conductor.

このケースだと 3 つの請求状態を経ているから、リクエストに対して 3 つのセグメントが返ってくることになるね。

対応状況はこんな感じだよ。

- 全ての商用 AWS リージョンで利用可能
- 追加料金なし
- 対応しているのはプライマリ請求ビューのみ

詳しい仕様は AWS Billing API Reference に載っているよ。

## まとめ

- AWS Billing and Cost Management に新API「ListBillingViewSegments」が登場
- アカウントの請求階層上の位置づけや、料金設定(課金対象/プロフォーマ)の履歴を取得できる
- 請求コンテキストが期間中に変わっても、時系列のセグメントに分けて返してくれる
- 全商用リージョンで追加料金なし、対応はプライマリ請求ビューのみ
- 複数アカウントの請求管理をしている人・組織の請求構造を把握したい人にオススメだよ