FindOps Open Cost and Usage 仕様（FOCUS）は、技術課金データセットの統一された要件を確立します。 MongoDB Atlas は、請求コストと使用状況データを FOCUS.1 3形式で提供します。Invoices Atlas コンソールまたは FOCUS データAPIを使用して、 ページから FOCUS レポートを生成できます。
FOCUS について
これまで、Atlas の請求データはMongoDB固有の形式で提供されていました。 Atlas のカスタマー、特に大規模なエンタープライズやパートナーは、Atlas クレジット ユニット（ACU）を請求通貨に変換するために手動の作業を費やする必要があります。
FOCUS は共通の語彙と請求の構造を提供するため、Atlas の請求データを FindOps やクロスベンダーのコスト管理ツールと理解、調整、統合することができます。
PDF および CSV の使用状況の概要では、 MongoDB固有の形式で請求書が表示されます。 FOCUS のコストと使用状況のレポートには、同じ請求期間が標準化された FOCUS形式で表示されます。 Atlas コンソールの Invoices ページから 3 つすべてをダウンロードできます。
FOCUSデータAPI機能
FOCUS データAPI は、FOCUS 形式のコストと使用状況データへのプログラムによるアクセスを提供します。
FOCUS データAPI を使用すると、次のことが可能になります。
請求通貨のコストを表示:
BilledCostEffectiveCost手動変換することなく、請求通貨で直接 と にアクセスします。クレジットタイプの識別:
Contract Appliedフィールドで、クレジットがプリペイド、プロモーダル、または従量制であるかどうかを確認します。完全なコンテキストでコストを分析します。
RegionUsageDate、 、ServiceCategoryなどのフィールドを使用して、詳細なコスト分析を行います。標準の業界タームを使用します。
SubAccountNameなどの内部APIタームではなく、 やその他の直感的な FOCUS タームを使用します。groupName
FOCUS 列参照
次の表は、FOCUS データAPIレスポンスで返される列と、それに相当するレガシー請求フィールドを示しています。
FOCUS 1.3 列ID | 定義 | 現在の CSV 同等フィールド | 現在のJSONと等価フィールド |
|---|---|---|---|
| 現在の請求期間中に請求されたコスト（請求通貨単位）。 | 該当なし | 該当なし |
| この請求書の Atlas組織ID 。 | 組織ID | 該当なし |
| この請求書の Atlas組織名。 | 組織名 | 該当なし |
| この料金の請求通貨。 | 該当なし | 該当なし |
| 請求期間の終了日。請求期間は終了日を含みません。 | 該当なし | "enddate" （請求書） |
| 請求期間の開始日。請求期間には、開始日を含みます。 | 該当なし | "creed" （請求書） |
| 請求方法に基づく料金の分類。例、" Usage" は 、消費されたサービスまたはリソースの量に基づく料金を示します。 | 該当なし | 該当なし |
| 料金に関する高レベルのコンテキスト。 | 説明 | 該当なし |
| 料金が発生した期間の終了。請求期間は終了日を含みません。 | 該当なし | "enddate" (lineItems) |
| 料金が発生した期間の開始。請求期間には、開始日を含みます。 | 使用日 | "startDate" (lineItems) |
| 消費単位に基づく、使用されたリソースまたはサービスに関連付けられた特定の SKU の量。 | 数量 | "量" |
| 特定の SKU を測定するために使用される単位。 | 単位 | "unit" |
| 請求を 1 つ以上の契約に関連付けるプロパティのセット。消費された使用量をカバーするために使用される Atlas クレジットの名前を識別します。 | 該当なし | 該当なし |
| 契約された単価と対応する価格数量を乗じて計算されたコストを表します。このフィールドは、請求通貨で表示されます。 | 該当なし | 該当なし |
| 関連付けられた SKU の単一の価格設定ユニットの契約ユニット価格（割引を含む）。この価格は、請求通貨で表示されます。 | 該当なし | 該当なし |
| すべての割引率と割引を適用した後の料金の連結コストを表します。このフィールドは、請求通貨で表示されます。 | 該当なし | 該当なし |
| サービス プロバイダーがリソースとサービスを配置する基礎のインフラストラクチャを提供するエンティティの名前。例、 、 AWS、 Azure、 GCP。 | 該当なし | 該当なし |
| 消費されたリソースまたはサービスの請求を担当するエンティティ。例、 MongoDBと直接トランザクションを行うカスタマーにはMongoDB 、マーケットプレイスを通じて Atlas とトランザクションを行うカスタマーには Marketplace を指定します。 | 該当なし | 該当なし |
| リストの単価と対応する価格数量を乗じて計算されたコストを表します。このフィールドは、請求通貨で表示されます。 | 該当なし | 該当なし |
| 関連付けられた SKU の単一の価格設定ユニットの、プロバイダーが公開する推奨されるユニット価格（割引を除く）。この価格は、請求通貨で表示されます。 | 該当なし | 該当なし |
| この料金の測定通貨（例: Atlas クレジット）。 | 該当なし | 該当なし |
| 関連付けられた SKU の単一の価格設定ユニットの契約ユニット価格（割引を含む）。この価格は、価格通貨で表示されます。 | 該当なし | 該当なし |
| すべての割引率と割引を適用した後の料金の連結コストを表します。このフィールドは、通貨の価格体系で表示されます。 | 金額 | "totalPriceCents" |
| リストの単価と対応する価格数量を乗じて計算されたコストを表します。このフィールドは、通貨の価格体系で表示されます。 | 単価 | " unitPriceDollers" |
| 価格設定単位 に基づいて、使用または購入されたリソースまたはサービスに関連付けられた特定の SKU の量を表します。 | 該当なし | 該当なし |
| 単価を決定するための単位を表します（例: 、 GB- 時間）。 | 該当なし | 該当なし |
| リソースがプロビジョニングされる、またはサービスが提供される分離された地理的領域の識別子。例、 | 該当なし | 該当なし |
| リソースがプロビジョニングされる、またはサービスが提供される分離された地理的領域の名前。例、 | リージョン | 該当なし |
| Atlas の場合、これはクラスター名です。 | クラスター | "clusterName" |
| FOCUS によって定義される最上位の分類。これは "データベース" です。 MongoDB Atlas用。 | 該当なし | 該当なし |
| サービス プロバイダー（例: 、 MongoDB Atlas ）から購入できるオプションを表します。 | 該当なし | 該当なし |
| 使用または購入可能なリソースまたはサービスを提供するエンティティの名前。例、 MongoDB。 | 該当なし | 該当なし |
| 個別の請求可能な構成を表す SKU（Item キー ユニット）の一意の識別子。 | 該当なし | 該当なし |
| 関連付けられている SKU の測定単位で、測定対象を示します。例、、、 | 該当なし | 該当なし |
| 料金が請求された価格の価格点（ JSONのキーと値のペア）。料金に価格点がない場合、または価格点でサイズが指定されていない場合、この列は空になります。 | 該当なし | 該当なし |
| 料金が請求された価格点の一意の識別子。 | 該当なし | 該当なし |
| 組織構造に基づくグループであるサブアカウントに割り当てられる識別子。これはMongoDB Atlasの プロジェクトに相当します。 | プロジェクトID | "groupId" |
| サブアカウントの表示名。これはMongoDB Atlasの プロジェクトに相当します。 | プロジェクト | "groupName" |
| 関連付けられているリソースに割り当てられたタグ。 | タグ/アプリケーション | "tags" |
| 請求される Atlas SKU 。 | SKU | "sku" |
| MongoDB が料金を請求した期間の終了。 | 日付 | "creed" (lineItems) |
| MongoDB が料金を請求した期間の開始。 | 該当なし | 該当なし |
| "price"の Atlas クレジット。このレートを適用して、請求通貨で表された Atlas クレジットのコストを調べます。 | 該当なし | 該当なし |
| 関連付けられた Atlas SKU の最上位の分類。例、 、 | 該当なし | 該当なし |
エンドポイント
FOCUS データAPI は、次の 3 つのエンドポイントで Atlas Administration API を拡張したものです。
FOCUS レポートの生成 では、FOCUS 形式の請求レポートの生成がリクエストされます。
FOCUS レポートを検索すると、そのレポートのステータスと、レポートが準備できた場合は、それをダウンロードするためのURL が返されます。
注意
Organization Billing Adminすべてのエンドポイントには、 、Organization Owner 、またはOrganization Billing Viewer ロールが必要です。
組織の請求書を一覧表示する
使用可能な請求書 ID のリストを取得します。クロス組織請求の場合、このエンドポイントはリンクされたすべての組織の請求書を識別します。
ベース URL: /api/atlas/v2/orgs/{orgId}/associatedInvoices
GET /api/atlas/v2/orgs/{orgId}/associatedInvoices
リクエスト パス パラメーター
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
| string | 必須 | 組織を識別する一意な 24 桁の 16 進数のstring 。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
|---|---|---|---|---|
| integer | 任意 | 取得する請求書の月（1-12）。 | 当月 |
| integer | 任意 | 検索する請求書の年。 >:=2000 である必要があります。 | 現在年 |
| ブール値 | 任意 | リンクされた組織からの請求書を含めるかどうかを示すフラグ。 |
|
リクエストの例
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --request GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/associatedInvoices"
応答
{ "associatedInvoices": [ { "invoiceId": "string", "orgId": "string" } ], "month": "06", "year": "2026" }
応答要素
名前 | タイプ | 説明 |
|---|---|---|
| 配列 | 指定された期間の組織に関連付けられた請求書のリスト。 |
| string | 請求書の一意の 24 桁の 16 進数識別子。 |
| string | 組織の一意の 24 桁の 16 進数識別子。 |
| string | 関連付けられている請求書の月を表す 2 桁の数字（例: 、 |
| string | 関連する請求書の年を表す 4 桁の数字（例: 、 |
FOCUS レポートのリクエスト
FOCUS 標準形式の請求レポートの生成を要求します。 Atlas はレポートを非同期に生成し、レポート ステータスをポーリングするために使用するレポートIDを返します。
ベース URL: /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports
POST /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports
リクエスト パス パラメーター
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
| string | 必須 | 組織を識別する一意な 24 桁の 16 進数のstring 。 |
| string | 必須 | 請求書を識別する一意な 24 桁の 16 進数文字列。 |
リクエスト ボディ パラメータ
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
| string | 必須 | 生成するレポートのタイプ。 |
| string | 必須 | レポートの形式。許可される値は |
| string | 任意 | レポート形式仕様のバージョン（例: 、 |
リクエストの例
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ --request POST "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports" \ --data '{ "reportType": "FOCUS", "reportFormat": "CSV", "formatSpecVersion": "1.3" }'
応答
成功すると、レポートIDとレポートの初期状態を含む 201 Created が返されます。
{ "invoiceId": "32b6e34b3d91647abb20e7b8", "reportFormat": "CSV", "reportId": "5f5f4c9e2b8f4b3a1c2d3e4f", "reportType": "FOCUS", "state": "PENDING" }
レポートをダウンロードするには、返されたreportId を エンドポイントの検索に渡します。
FOCUS レポートの取得
リクエストした FOCUS レポートのステータスと詳細を返します。 state が SUCCEEDED または FAILED になるまで、このエンドポイントをポーリングします。
ポーリングは 5 秒ごとの 1 回のみです。レポートの生成に時間がかかる場合は、リクエストの間隔を指数的に増やします。ほとんどのレポートは 秒以内に完了しますが、大規模な請求書のレポートには数分かかる場合があります。
ベース URL: /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}
GET /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}
リクエスト パス パラメーター
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
| string | 必須 | 組織を識別する一意な 24 桁の 16 進数のstring 。 |
| string | 必須 | 請求書を識別する一意な 24 桁の 16 進数文字列。 |
| string | 必須 | レポートを識別する一意な 24 桁の 16 進数の文字列。 |
リクエストの例
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --request GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports/{reportId}"
応答
成功すると、レポートの現在の状態を含む 200 OK が返されます。 state が SUCCEEDED の場合、レスポンスにはダウンロードURLとその有効期限も含まれます。
{ "downloadUrl": "https://<presigned-url>", "expiresAt": "2026-08-17T18:30:00Z", "formatSpecVersion": "1.3", "invoiceId": "32b6e34b3d91647abb20e7b8", "reportFormat": "CSV", "reportId": "5f5f4c9e2b8f4b3a1c2d3e4f", "reportType": "FOCUS", "state": "SUCCEEDED" }
状態を報告する
状態 | 説明 |
|---|---|
| Atlas はリクエストを受け入れましたが、レポートの生成は開始されませんでした。 |
| Atlas はレポートを生成しています。 |
| レポートは準備できました。応答には |
| Atlas によるレポートの生成は失敗しました。応答には |
応答要素
名前 | タイプ | 説明 |
|---|---|---|
| string | レポートをダウンロードするためのURL 。応答には、 |
| string |
|
| string | レポートが失敗した理由。応答には、 |
| string | レポート形式仕様のバージョン。 |
| string | 請求書を識別する一意な 24 桁の 16 進数文字列。 |
| string | 生成されたレポートの形式。 |
| string | レポートを識別する一意な 24 桁の 16 進数の文字列。 |
| string | 生成されたレポートのタイプ。 |
| string | レポート生成の現在の状態。 |
可用性のレポート作成
各 downloadUrl は 15 分間有効です。 URLの有効期限が切れた後にレポートをダウンロードするには、同じ reportId を使用してこのエンドポイントを再度呼び出します。 Atlas は新しい downloadUrl と新しい expiresAt 時間を返します。
レポートは、リクエスト後 7 日間利用可能です。 7 日後に 新しいレポートをリクエストて、同じ請求書データをダウンロードします。
データ動作とパフォーマンス
次のセクションでは、FOCUS データAPI が保留中のデータと大規模なレポート生成を処理する方法について説明します。
保留中の月の可視性
"Pending" のデータをクエリできます。 （現在の）月。 Atlas は使用状況をリアルタイムでクレジットに関連付けてコストの見積もりを提供しますが、請求書が支払い済みになるまでこれらの値は not final です。月が終了した後にデータを再取得して、最終的な請求値を確認します。
大規模なデータのファイル処理
FOCUS データAPI は、大規模な請求データを処理するように設計された方法でレポートを生成および提供します。
非同期生成: レポート生成はリクエストをブロックしません。リクエストエンドポイントはすぐに
reportIdを返し、レポート状態の取得エンドポイントをポーリングします。CSV形式: CSV ファイルとして生成されるレポート
期間限定のダウンロードURL: レポートが成功すると、検索エンドポイントは 分間有効な
downloadUrl15を返します。レポートは 7 日間利用可能なままです。期限切れのURLを更新する方法については、「 可用性のレポート 」を参照してください。単一組織のスコープ: 各リクエストは1 つの組織のデータを返します。クロス組織請求を使用する場合は、リスト
invoiceIdエンドポイントによって返される ごとに 1 つのレポートをリクエスト。
制限
エンドポイントは、使用量ベースのコストのみをカバーします。現在のところ、次の要素は含まれていません。
短縮料金（月額またはフレキシブルな契約の差）。
税金行項目。
調整または返金。
Atlas コンソールで完全な請求書を表示するには、「 請求書の管理 」を参照してください。
サポートとフィードバック
FOCUS データAPIに関する質問については、 MongoDBアカウントチームにお問い合わせください。他の開発者に質問したりディスカッションしたりするには、 Stack Overflowまたは Reddit のMongoDB Community を参照してください。