Obtaining the Final 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/YYYY/MM

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

HTTPステータスコード#

正常時：200

エラー時：400, 401, 404, 415, 500

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

名前 In Type デフォルト値
/必須指定		 Description
X-Auth-Token header string 必須 認証のトークン
domain_id query string 任意 絞込条件にドメインIDを指定します。省略時には認証トークンから得られるドメイン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"形式です。
sub_div string 請求の集計区分
区分に応じて、以下の文字列が返却されます。
ドメイン毎：
   "D"
プロジェクト毎：
   "P"
domain_id string 請求対象となるドメインのID
project_id string 請求対象となるプロジェクトのID
line_seq number 明細上の行番号
detail_div string 明細上の記載区分
区分に応じて、以下の文字列が返却されます。
定額：
   01
一時：
   02
従量：
   03
割引：
   04
小計：
   05
調整：
   07
合計：
   08
コメント：
   99
reseller_id string 契約しているリセラーのID
product_id string 請求対象となった商品のID
region_id string 請求対象となったリージョンのID
service_provider_id string 商品のサービスプロバイダのID
product_name array 言語毎の商品名が入ったArray
リストの各要素はobject型で、以下のメンバーを持ちます。
"lang"(String)：
   言語コード(ISO639-1)
"value"(String)：
   商品名
comment array 言語毎の備考情報が入ったArray
リストの各要素はobject型で、以下のメンバーを持ちます。
"lang"(String)：
   言語コード(ISO639-1)
"value"(String)：
   備考
usage number 請求対象となった使用量
unit_price number 商品の単価
unit_name array 言語毎の使用量の単位が入ったArray
リストの各要素はobject型で、以下のメンバーを持ちます。
"lang"(String)：
   言語コード(ISO639-1)
"value"(String)：
   単位を表す文字列
charge number 課金額
currency_code string 課金額の通貨コード(ISO4217)

リクエスト例#

GET /v1/charges/2014/06
HTTP/1.1
X-Auth-Token: "JpZCI6ICJjM2VlNzA4YTZhZTI0ZGRmOTJjMDc4..."

レスポンス例#

HTTP/1.1 200 OK
Content-Type： application/json
[
{
  "last_modified" : "2014-07-01T12:00:00.000",
  "billing_month" : "2014-06",
  "sub_div" : "D",
  "domain_id" : "ca-1a2b3c4d5e",
  "project_id" : "capj-1a2b3c4d5e",
  "line_seq" : 1,
  "detail_div" : "01",
  "reseller_id" : "ResellerId",
  "product_id" : "P01C010001",
  "region_id" : "jp-east-1",
  "service_provider_id" : "fujitsu.com",
  "service_id" : "compute",
  "product_name" : [
    { "lang" : "ja", "value" : "商品名" },
    { "lang" : "en", "value" : "Product Name" },
    { "lang" : "de", "value" : "Produktname" }
  ],
  "comment" : [
    { "lang" : "ja", "value" : "備考" },
    { "lang" : "en", "value" : "Notes" },
    { "lang" : "de", "value" : "Bemerkungen" }
  ],
  "usage" : 400,
  "unit_price" : 100,
  "unit_name" : [
    { "lang" : "ja", "value" : "GB" },
    { "lang" : "en", "value" : "GB" },
    { "lang" : "de", "value" : "GB" }
  ],
  "charge" : 40000,
  "currency_code" : "JPY"
},
{
  "last_modified" : "2014-07-01T12:00:00.000",
  "billing_month" : "2014-06",
  "sub_div" : "D",
  "domain_id" : "ca-1a2b3c4d5e",
  "project_id" : "capj-1a2b3c4d5e",
  "line_seq" : 2,
  "detail_div" : "01",
  "reseller_id" : "ResellerId",
  "product_id" : "P01C010001",
  "region_id" : "uk-1",
  "service_provider_id" : "fujitsu.com",
  "service_id" : "compute",
  "product_name" : [
    { "lang" : "ja", "value" : "商品名" },
    { "lang" : "en", "value" : "Product Name" },
    { "lang" : "de", "value" : "Produktname" }
  ],
  "comment" : [
    { "lang" : "ja", "value" : "備考" },
    { "lang" : "en", "value" : "Notes" },
    { "lang" : "de", "value" : "Bemerkungen" }
  ],
  "usage" : 200,
  "unit_price" : 100,
  "unit_name" : [
    { "lang" : "ja", "value" : "GB" },
    { "lang" : "en", "value" : "GB" },
    { "lang" : "de", "value" : "GB" }
  ],
  "charge" : 20000,
  "currency_code" : "JPY"
}
]