FOCUS コストおよび使用レポートへのアクセス

FinOps Open Cost and Usage Specification (FOCUS) は、テクノロジー請求データセットに対する統一の要件を定めています。MongoDB Atlas は、FOCUS 1.3 でコストと使用状況の請求データを提供します。形式.Atlas コンソールの Invoices ページから、または FOCUS データAPI を使用して FOCUS レポートを生成できます。

FOCUS について

歴史的に、Atlas の請求データは MongoDB 固有の形式で提供されていました。Atlas のカスタマー、特に大規模なエンタープライズや提携するカスタマーは、Atlas クレジットユニット (ACU) を請求通貨に変換するために手動で作業する必要があります。

FOCUS は共通の言語と請求構造を提供し、Atlas 請求データを FinOps およびクロスベンダーのコストマネジメントツールと理解、照合、統合するのに役立ちます。

PDF および CSV の使用状況の概要では、 MongoDB固有の形式で請求書が表示されます。FOCUS のコストと使用状況のレポートには、同じ請求期間が標準化された FOCUS形式で表示されます。Atlas コンソールの Invoices ページから 3 つすべてをダウンロードできます。

Atlas コンソールから FOCUS レポートをダウンロード

Atlas コンソールの Invoices ページから請求書の FOCUSコストと使用状況レポートをダウンロードできます。請求書の形式を選択する場合は、CSV FOCUS Cost & Usage Report を選択します。

現在の請求期間のレポートをダウンロードするには、「現在の請求書をダウンロード」を参照してください。過去の請求期間のレポートをダウンロードするには、「過去の請求書のダウンロード」を参照してください。

注意

請求データを表示およびダウンロードするには、Organization Billing Admin 、Organization Owner 、またはOrganization Billing Viewer ロールが必要です。

FOCUS データAPI機能

FOCUSデータAPIは、FOCUS形式のコストと使用状況データへのプログラムによるアクセスを提供します。

FOCUS データAPIを使用すると、次のことが可能です。

請求通貨でコストを表示: BilledCostとEffectiveCostに請求通貨で直接アクセスします。手動で変換する必要はありません。
クレジットの種類を識別する: Contract Applied フィールドを通じて、クレジットがプリペイド、プロモーション、エラスティックのいずれであるかを確認します。
コストを完全なコンテキストで分析する: Region、UsageDate、ServiceCategory などのフィールドを使用して、細かいコスト分析を行います。
標準業界用語の使用: groupName などの内部 API 用語の代わりに、SubAccountName とその他の直観的な FOCUS 用語を使用します。

FOCUS 列参照

次の表は、FOCUS データ API 応答で返される列とそれに対応するレガシー請求フィールドを示します。

フォーカス 1.3列 ID	定義	現在の CSV 相当フィールド	現在の JSON 相当フィールド
`BilledCost`	現在の請求期間中に請求された、請求通貨でのコスト。	該当なし	該当なし
`BillingAccountId`	この請求書の Atlas 組織ID。	組織ID	該当なし
`BillingAccountName`	この請求書の Atlas 組織名。	組織名	該当なし
`BillingCurrency`	この請求の請求通貨。	該当なし	該当なし
`BillingPeriodEnd`	請求期間の終了日。請求期間には終了日は含まれません。	該当なし	"endDate" (請求書)
`BillingPeriodStart`	請求期間の開始日。請求期間には開始日が含まれます。	該当なし	"created" (請求書)
`ChargeCategory`	請求方法の性質に基づいた請求の分類。例えば、「使用量」は消費されたサービスまたはリソースの量に基づいた請求を示します。	該当なし	該当なし
`ChargeDescription`	課金に関する高レベルのコンテキスト。	説明	該当なし
`ChargePeriodEnd`	請求が発生した期間の終わり。請求期間には終了日は含まれません。	該当なし	"endDate" (lineItems)
`ChargePeriodStart`	請求が発生した期間の開始。請求期間には開始日が含まれます。	使用日	"startDate" (lineItems)
`ConsumedQuantity`	消費された単位に基づき、使用されたリソースまたはサービスに関連する所定の SKU のボリューム。	数量	"quantity"
`ConsumedUnit`	指定された SKU の測定に使用される単位。	単位	"unit"
`ContractApplied`	課金を1つ以上の契約コミットメントに関連付けるプロパティのセット。消費された使用量をカバーするために使用される Atlas クレジットの名前を識別します。	該当なし	該当なし
`ContractedCost`	契約された単価と対応する価格設定数量を乗算して計算されるコストを表します。このフィールドは請求通貨で表示されます。	該当なし	該当なし
`ContractedUnitPrice`	関連する SKU の単一の価格設定単位に合意した単位価格、割引を含む。この価格は請求通貨で表示されます。	該当なし	該当なし
`EffectiveCost`	すべての削減率と割引を適用した後の課金の平準化されたコストを表します。このフィールドは請求通貨で表示されます。	該当なし	該当なし
`HostProviderName`	サービスプロバイダーがリソースとサービスを配置する基礎のインフラを提供するエンティティの名前。例: Amazon Web Services、Azure、GCP。	該当なし	該当なし
`InvoiceIssuer`	消費されたリソースまたはサービスの請求書を担当するエンティティ。例えば、MongoDB と直接取引するカスタマーの場合は MongoDB、マーケットプレイスを通じて Atlas と取引するカスタマーの場合はマーケットプレイス。	該当なし	該当なし
`ListCost`	リスト単価と対応する価格設定数量を乗算して計算されるコストを表します。このフィールドは請求通貨で表示されます。	該当なし	該当なし
`ListUnitPrice`	提案されたプロバイダー公開の単位価格は、関連する SKU の単位課金単位の単位価格ですが、割引は適用されません。この価格は課金通貨で表示されます。	該当なし	該当なし
`PricingCurrency`	この請求の課金通貨。例: Atlas クレジット。	該当なし	該当なし
`PricingCurrencyContractedUnitPrice`	関連する SKU の単一の価格設定単位に合意した単位価格、割引を含む。この価格は価格設定通貨で表示されます。	該当なし	該当なし
`PricingCurrencyEffectiveCost`	すべての削減率と割引を適用した後の課金の平準化されたコストを表します。このフィールドは価格設定通貨で表示されます。	金額	"totalPriceCents"
`PricingCurrencyListUnitPrice`	リスト単価と対応する価格設定数量を乗算して計算されるコストを表します。このフィールドは価格設定通貨で表示されます。	単価	"unitPriceDollars"
`PricingQuantity`	価格単位に基づき、使用または購入されたリソースまたはサービスに関連付けられた所定の SKU のボリュームを表します。	該当なし	該当なし
`PricingUnit`	単価を決定する単位。例：GB 時間。	該当なし	該当なし
`RegionId`	リソースがプロビジョニングされるか、サービスが提供される分離された地理的エリアの識別子。例: `us-east-1`	該当なし	該当なし
`RegionName`	リソースがプロビジョニングされるか、サービスが提供される分離された地理的エリアの名前。例: `N. Virginia`	リージョン	該当なし
`ResourceName`	Atlas の場合、これはクラスター名です。	クラスター	"clusterName"
`ServiceCategory`	FOCUS によって定義された最高レベルの分類。MongoDB Atlas の場合は「データベース」です。	該当なし	該当なし
`ServiceName`	MongoDB Atlas など、サービスプロバイダーから購入できるオファーを表します。	該当なし	該当なし
`ServiceProviderName`	使用または購入可能なリソースまたはサービスを提供するエンティティの名前。例: MongoDB。	該当なし	該当なし
`SkuId`	個別の請求可能な構成を表す在庫管理単位 (SKU) の一意の識別子。	該当なし	該当なし
`SkuMeter`	関連する SKU の測定単位。例えば、`GB`、コンピュート時間、リクエストなど、何が測定されているかを示します。	該当なし	該当なし
`SkuPriceDetails`	請求が行われた価格点の価格ディメンジョン。JSON のキーと値のペアとして表示されます。請求に価格点がない場合、または価格点にディメンジョンが指定されていない場合、この列は空になります。	該当なし	該当なし
`SkuPriceId`	請求された価格点の一意の識別子。	該当なし	該当なし
`SubAccountId`	組織構造に基づいたグループ化であるサブアカウントに割り当てられた識別子。これは MongoDB Atlas のプロジェクトに相当します。	プロジェクトID	"groupId"
`SubAccountName`	サブアカウントの表示名。これは MongoDB Atlas のプロジェクトに相当します。	プロジェクト	"groupName"
`Tags`	関連するリソースに割り当てられたタグ。	タグを付ける/アプリケーション	"tags"
`x_AtlasSku`	請求されている Atlas SKU。	SKU	"sku"
`x_BilledDateEnd`	MongoDB が請求を請求した期間の終わり。	日付	"created" (lineItems)
`x_BilledDateStart`	MongoDB が請求を行った期間の開始。	該当なし	該当なし
`x_PricingCurrencyRate`	Atlas クレジットの "価格"。このレートを適用して、請求通貨での Atlas クレジットのコストを検索します。	該当なし	該当なし
`x_SkuCategory`	関連する Atlas SKU の最高レベルの分類。例えば、`Clusters`や`Backup`など。	該当なし	該当なし

エンドポイント

FOCUS データ API は、Atlas Administration API を 3 つのエンドポイントとなる接続されたデバイスで拡張します。

組織の請求書をリストするには、組織で利用可能な請求書がリストされています。
FOCUS レポートをリクエストすると、FOCUS 形式の請求レポートの生成がリクエストされます。
FOCUS レポートを検索すると、そのレポートのステータスが返され、レポートの準備が整うとダウンロード用の URL が返されます。

注意

すべてのエンドポイントとなる接続されたデバイスには、Organization Billing Admin、Organization Owner、またはOrganization Billing Viewerのロールが必要です。

組織の請求書を一覧表示

使用可能な請求 ID のリストを取得します。For Cross-Org 請求、このエンドポイントとなる接続されたデバイスは、すべてのリンクされた組織の請求を識別します。

ベース URL: /api/atlas/v2/orgs/{orgId}/associatedInvoices

GET /api/atlas/v2/orgs/{orgId}/associatedInvoices

リクエストパスパラメーター

名前	タイプ	必要性	説明
`orgId`	string	必須	組織を識別する一意な 24 桁の 16 進数のstring 。

リクエストクエリパラメータ

次のクエリパラメータは任意です。

名前	タイプ	必要性	説明	default
`month`	integer	任意	取得する請求書の月 (1-12)。	当月
`year`	integer	任意	検索する請求書の年。2000 以上である必要があります。	現在の年
`includeLinkedOrgs`	ブール値	任意	リンクされた組織からの請求書を含めるかどうかを示すフラグ。	`false`

リクエストの例

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"
}

応答要素

名前	タイプ	説明
`associatedInvoices`	配列	指定された期間に組織に関連する請求書のリスト。
`associatedInvoices[n].invoiceId`	string	請求書の一意的な 24 桁の 16 進数デジット識別子。
`associatedInvoices[n].orgId`	string	組織の一意の 24 格 16 進数デジット識別子。
`month`	string	2 桁の数値で、関連する請求書の月を表します。例、`06`です。
`year`	string	関連する請求書の年を表す 4 桁の数字。例: `2026`

FOCUS レポートをリクエストする

FOCUS 標準形式での請求レポートの生成をリクエストします。Atlas はレポートを非同期的に生成し、レポートのステータスをポーリングするために使用するレポート ID を返します。

ベース URL: /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports

POST /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/reports

リクエストパスパラメーター

名前	タイプ	必要性	説明
`orgId`	string	必須	組織を識別する一意な 24 桁の 16 進数のstring 。
`invoiceId`	string	必須	請求書を識別する一意的な 24 桁の 16 進数文字列。

リクエストボディパラメータ

名前	タイプ	必要性	説明
`reportType`	string	必須	生成するレポートのタイプ。 `FOCUS` に設定する必要があります。
`reportFormat`	string	必須	レポートの形式。許可される値: `CSV`
`formatSpecVersion`	string	任意	レポート形式仕様のバージョン。例: `1.3`

リクエストの例

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}

リクエストパスパラメーター

名前	タイプ	必要性	説明
`orgId`	string	必須	組織を識別する一意な 24 桁の 16 進数のstring 。
`invoiceId`	string	必須	請求書を識別する一意的な 24 桁の 16 進数文字列。
`reportId`	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"
}

レポートの状態

状態	説明
`PENDING`	Atlas はリクエストを受け入れましたが、レポートの生成はまだ開始されていません。
`RUNNING`	Atlas がレポートを生成しています。
`SUCCEEDED`	レポートの準備が整いました。応答には `downloadUrl` と `expiresAt` が含まれます。
`FAILED`	Atlas はレポートを生成できませんでした。応答には `failureReason` が含まれます。

応答要素

名前	タイプ	説明
`downloadUrl`	string	レポートをダウンロードする URL。応答には、`state` が `SUCCEEDED` の場合にのみこのパラメータが含まれます。
`expiresAt`	string	`downloadUrl` の有効期限が切れる日時。UTC の ISO 8601 形式で表示されます。各ダウンロード URL は 15 分間有効です。レスポンスには、`state` が `SUCCEEDED` の場合にのみこのパラメータが含まれます。
`failureReason`	string	レポートの失敗の理由。応答には、`state` が `FAILED` の場合にのみこのパラメータが含まれます。
`formatSpecVersion`	string	レポート形式仕様のバージョン。
`invoiceId`	string	請求書を識別する一意的な 24 桁の 16 進数文字列。
`reportFormat`	string	生成されたレポートの形式。
`reportId`	string	レポートを識別する一意な 24 桁の 16 進数の文字列。
`reportType`	string	生成されたレポートの種類。
`state`	string	レポート生成の現在の状態。

レポートの利用可能性

各 downloadUrl は 15 分間有効です。URL の有効期間が切れた後にレポートをダウンロードするには、同じ reportId を使用してこのエンドポイントを再度呼び出します。Atlas は新しい downloadUrl と新しい expiresAt 時間を返します。

リポートはリクエストされてから 7 日間利用できます。7 日後になった場合は、新しいリポートをリクエストして同じ請求書データをダウンロードする。

データの動作とパフォーマンス

以下のセクションでは、FOCUS データ API が保留データと大規模なレポート生成をどのように取り扱うかを説明します。

保留月の可視性

「保留」(現在)月のデータをクエリできます。Atlas はコスト見積も提供するため、クレジットとの使用量をリアルタイムで関連付けますが、これらの値は請求書が確定するまでは not final です。月が確定した後にデータを再プルして、最終の請求額を確認します。

大容量データのファイル処理

FOCUS データ API は、大規模な請求データを取り扱うように設計された方法でレポートを生成して配送します。

非同期生成: リポートの生成によってリクエストがブロックされることはありません。リクエストエンドポイントはすぐに reportId を返し、リポート状態のために検索するエンドポイントをポーリングします。
CSV 形式: レポートは CSV ファイルとして生成されます。
期間限定のダウンロードURL: レポートが成功すると、検索エンドポイントは downloadUrl を返します。それは 15 分間有効です。レポートは 7 日間利用可能なままです。期限切れのURLを更新する方法については、可用性のレポートを参照してください。
単一組織スコープ: 各リクエストは 1 つの組織のデータを返します。組織横断の請求を使用する場合は、リストエンドポイントによって返される各 invoiceId のレポートを 1 つリクエストします。

制限

エンドポイントとなる接続されたデバイスは、使用に基づくコストのみを対象とします。現在は、次のものは含まれていません。
- 不足金（月額/フレックスコミットメントの差額）。
- 税金明細。
- 調整または払い戻し。

Atlas コンソールで請求書全体を表示するには、請求書の管理を参照してください。

サポートとフィードバック

FOCUS データAPIに関する質問は、MongoDBアカウントチームにお問い合わせください。他の開発者に質問したり、議論に参加したりするには、Stack Overflow または Reddit のMongoDBコミュニティを参照してください。

戻る

請求書の内訳

サブスクリプション

FOCUS コストおよび使用レポートへのアクセス

FOCUS について

Atlas コンソールから FOCUS レポートをダウンロード

注意

FOCUS データAPI機能

FOCUS 列参照

エンドポイント

注意

組織の請求書を一覧表示

リクエスト パス パラメーター

リクエスト クエリ パラメータ

リクエストの例

応答

応答要素

FOCUS レポートをリクエストする

リクエスト パス パラメーター

リクエスト ボディ パラメータ

リクエストの例

応答

FOCUS レポートを検索する

リクエスト パス パラメーター

リクエストの例

応答

レポートの状態

応答要素

レポートの利用可能性

データの動作とパフォーマンス

保留月の可視性

大容量データのファイル処理

制限

サポートとフィードバック

リクエストパスパラメーター

リクエストクエリパラメータ

リクエストパスパラメーター

リクエストボディパラメータ

リクエストパスパラメーター