Obtaining the Final resource-based billing information#

指定した期間と条件に合致する、各月の確定済み課金情報（リソース単位）を取得します。

APIエンドポイント#

リージョン	APIエンドポイント
西日本リージョン3の場合	https://billing.gls.cloud.global.fujitsu.com
東日本リージョン3の場合	https://billing.gls.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/v1/charges/resources/YYYY/MM

取得する請求対象月は、URIの「YYYY」には4桁の西暦、「MM」には2桁の月で指定します。2021年1月分の情報を検索対象とする場合には、「/v1/charges/resources/2021/01」をURIとしてください。

HTTPステータスコード#

正常時：200

エラー時：400, 401, 500, 503

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
X-Auth-Token	header	string	必須	認証のトークン
domain_id	query	string	必須	絞込条件にドメインIDを指定します。
project_id	query	string	任意	絞込条件にプロジェクトIDを指定します。指定時には、プロジェクト毎に集計された課金情報を返却します。
product_id	query	string	任意	絞込条件に商品IDを指定します。
service_id	query	string	任意	絞込条件にサービスIDを指定します。
region_id	query	string	任意	絞込条件にリソースが配備されているリージョンのIDを指定します。

レスポンスボディ（正常系）の説明#

名前	Type	Description
Content-Type	string	「application/json」が表示されます。
last_modified	string	本データの最終更新時刻(UTC)ISO-8601の下記形式です。 YYYY-MM-DD'T'HH:mm:ss.sss タイムゾーンは指定しません。
billing_month	string	請求の対象となる月 "YYYY-MM"形式です。
domain_id	string	請求対象となるドメインのID
currency_code	string	課金額の通貨コード(ISO4217)
reseller_id	string	請求対象となるリセラーのID
projects	array	プロジェクト毎の情報が入ったArray
project_id	string	請求対象となるプロジェクトのID "YYYY-MM"形式です。
region_id	string	請求対象となるリージョンのID "YYYY-MM"形式です。
products	array	商品毎の情報が入ったArray
product_id	string	請求対象となる商品のID "YYYY-MM"形式です。
service_provider_id	string	商品のサービスプロバイダのID
service_id	string	請求対象となった商品を提供するサービスのID
product_name	array	言語毎の商品名が入ったArray リストの各要素はobject型で、以下のメンバーを持ちます。 "lang"(String)：言語コード(ISO639-1) "value"(String)：商品名
unit_name	array	言語毎の使用量の単位が入ったArray リストの各要素はobject型で、以下のメンバーを持ちます。 "lang"(String)：言語コード(ISO639-1) "value"(String)：単位を表す文字列
resources	array	リソース毎の情報が入ったArray
resource_id	string	請求対象となるリソースのID
details	array	課金区分毎の情報が入ったArray
detail_type	string	課金の区分「billing」(課金)か「trial」(トライアル)
usage	number	請求対象となった使用量
charge	number	課金額
unit_price	number	商品の単価

リクエスト例#

GET /v1/charges/resources/2021/01
HTTP/1.1
X-Auth-Token: "JpZCI6ICJjM2VlNzA4YTZhZTI0ZGRmOTJjMDc4..."

レスポンス例#

{
  "last_modified" : "2021-01-01T12:00:00.000",
  "billing_month" : "2021-01",
  "domain_id" : "ca-1a2b3c4d5e",
  "currency_code" : "JPY",
  "reseller_id" : "ResellerId",
  "projects" : [
    {
      "project_id" : "a6944d763bf64ee6a275f1263fae0352",
      "region_id" : "jp-east-1",
      "products" : [
        {
          "product_id" : "P01C010001",
          "service_provider_id" : "fujitsu.com",
          "service_id" : "compute",
          "product_name" : [
            { "lang" : "ja", "value" : "商品名" },
            { "lang" : "en", "value" : "Product Name" },
            { "lang" : "de", "value" : "Produktname" }
          ],
          "unit_name" : [
            { "lang" : "ja", "value" : "GB" },
            { "lang" : "en", "value" : "GB" },
            { "lang" : "de", "value" : "GB" }
          ],
          "resources" : [
            {
              "resource_id" : "f5dc173b-6804-445a-a6d8-c705dad5b5eb",
              "details" : [
                {
                  "detail_type" : "trial",
                  "usage" : 23038502.1,
                  "charge" : 0,
                  "unit_price" : 0
                },
                {
                  "detail_type" : "billing",
                  "usage" : 23038502.1,
                  "charge" : 1280,
                  "unit_price" : 0.214
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}