1 つの組織のすべての請求書を取得
Cloud Manager は、 2024年8月30日でMongoDB 3.6と4.0のオートメーション、バックアップおよびモニタリングのサポートを終了します。 MongoDB の配置をアップグレードするか、Atlas に移行してください。
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
ベース URL: https://cloud.mongodb.com/api/public/v 1.0
Resource
GET /orgs/{ORG-ID}/invoices/
リクエスト パス パラメーター
名前 | タイプ | 説明 |
---|---|---|
ORG-ID | string | 組織の一意の識別子です。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
---|---|---|---|---|
pageNum | 数値 | 任意 | 結果のサブセクションを返す 1 から始まる整数。 | 1 |
itemsPerPage | 数値 | 任意 | 1 ページあたりに返す項目の数は最大 500 です。 | 100 |
pretty | ブール値 | 任意 | レスポンス本体を pretty-print にするかどうかを示すフラグ 形式。 | false |
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の APIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリで 結果のリストを返すエンドポイントの場合、 | false |
backupJobsEnabledOnly | ブール値 | 任意 | データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。 これを false に設定し、 backupJobsEnabled フラグがfalse に設定されているデーモン構成を含めます。 | true |
リクエスト ボディ パラメータ
このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。
応答
result
配列内の各ドキュメントは 1 件の請求書を表します。 料金は通常翌日に表示されます。
名前 | タイプ | 説明 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
amountBilledCents | 数値 | この請求書の請求額は、 subtotalCents + salesTaxCents - startingBalanceCents として計算されます。 | ||||||||||||||||
amountPaidCents | 数値 | この請求書の支払額(USD セント単位)。 | ||||||||||||||||
created | string | ISO8601 のタイムスタンプ この請求書が作成されたときの UTC の日付と時刻形式。 | ||||||||||||||||
creditsCents | 数値 | MongoDB によってクレジットされた金額(USD セント単位)。 | ||||||||||||||||
endDate | string | ISO8601 のタイムスタンプ この請求書の請求期間が終了したときの日付と時刻形式( UTC) 。 | ||||||||||||||||
id | string | この請求書のユニーク識別子。 | ||||||||||||||||
links | オブジェクト配列 | サブリソースや関連リソースへの 1 つ以上のリンク。 URL 間の関係タイプについては、 Web リンク仕様 で説明されています。 。 | ||||||||||||||||
groupId | string | 請求書が関連付けられているプロジェクトの一意の識別子。 すべての請求書に表示されるわけではありません。 | ||||||||||||||||
orgId | string | この請求書を受信した組織の一意の識別子。 | ||||||||||||||||
salesTaxCents | 数値 | subtotalCentsに課される税金の額。 | ||||||||||||||||
startDate | string | ISO8601 のタイムスタンプ この請求書の開始日の UTC での日付と時刻形式。 | ||||||||||||||||
statusName | string | この請求書の状態。 指定できる値は以下のとおりです。
| ||||||||||||||||
subtotalCents | 数値 | すべての正の請求書の明細項目を USD セント単位で合計します。 | ||||||||||||||||
updated | string | ISO8601 のタイムスタンプ 請求書が最後に更新されたときの日付と時刻形式( UTC) 。 |
リクエストの例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true"
応答例
{ "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true&pageNum=1&itemsPerPage=100", "rel" : "self" } ], "results" : [ { "amountBilledCents" : 0, "amountPaidCents" : 0, "created" : "2018-06-01T04:05:10Z", "endDate" : "2018-07-01T00:00:00Z", "id" : "{INVOICE-ID}", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}", "rel" : "self" } ], "orgId" : "{ORG-ID}", "salesTaxCents" : 0, "startDate" : "2018-06-01T00:00:00Z", "startingBalanceCents" : 0, "statusName" : "PENDING", "subtotalCents" : 0, "updated" : "2018-06-01T04:05:10Z" }, { "amountBilledCents" : 726, "amountPaidCents" : 726, "created" : "2018-02-01T06:05:04Z", "endDate" : "2018-03-01T00:00:00Z", "id" : "{INVOICE-ID}", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}", "rel" : "self" } ], "orgId" : "{ORG-ID}", "salesTaxCents" : 57, "startDate" : "2018-02-01T00:00:00Z", "startingBalanceCents" : 0, "statusName" : "PAID", "subtotalCents" : 669, "updated" : "2018-03-01T07:00:54Z" } ], "totalCount" : 16 }