確定済み課金情報（リソース単位）の取得 (GET /v1/charges/resources/YYYY/MM)

指定した期間と条件に合致する各月の確定済み課金情報を取得する。

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

Request Headers

X-Auth-Token:

認証トークンIDを指定する。

Data Type	Cardinality
String	1..1

Request Parameter

検索条件を以下のキーで指定できる。各キーは完全一致で検索される。

domain_id

絞込条件にドメインIDを指定する。

Data Type	Cardinality
String	1..1[Mandatory]

project_id

絞込条件にプロジェクトIDを指定する。指定時には、プロジェクト毎に集計された課金情報を返却する。

Data Type	Cardinality
String	0..1

product_id

絞込条件に商品IDを指定する。

Data Type	Cardinality
String	0..1

service_id

絞込条件にサービスIDを指定する。

Data Type	Cardinality
String	0..1

region_id

絞込条件にリソースが配備されているリージョンのIDを指定する。

Data Type	Cardinality
String	0..1

Response Headers

ステータス

リクエストのステータスを返却する。

以下もしくは「API共通エラー情報」へ記載のステータス。

200：: 正常終了

Data Type	Cardinality
Int	1..1

Content-Type

application/json

Data Type	Cardinality
String	1..1

Response Elements

last_modified

本データの最終更新時刻(UTC)

ISO-8601の下記形式とする。

YYYY-MM-DD'T'HH:mm:ss.sss

タイムゾーンは指定しない。

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

billing_month

請求の対象となる月

"YYYY-MM"形式とする。

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

domain_id

請求対象となるドメインのID

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

currency_code

課金額の通貨コード(ISO4217)

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

reseller_id

請求対象となるリセラーのID

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

projects

プロジェクト毎の情報が入ったArray

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

project_id

請求対象となるプロジェクトのID

"YYYY-MM"形式とする。

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

region_id

請求対象となるリージョンのID

"YYYY-MM"形式とする。

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

products

商品毎の情報が入ったArray

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

product_id

請求対象となる商品のID

"YYYY-MM"形式とする。

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

service_provider_id

商品のサービスプロバイダのID

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

service_id

請求対象となった商品を提供するサービスのID

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

product_name

言語毎の商品名が入ったArray

リストの各要素はobject型で、以下のメンバーを持つ。

"lang"(String)：: 言語コード(ISO639-1)
"value"(String)：: 商品名

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

unit_name

言語毎の使用量の単位が入ったArray

リストの各要素はobject型で、以下のメンバーを持つ。

"lang"(String)：: 言語コード(ISO639-1)
"value"(String)：: 単位を表す文字列

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

resources

リソース毎の情報が入ったArray

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

resource_id

請求対象となるリソースのID

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

details

課金区分毎の情報が入ったArray

Data Type	Cardinality	Parent Element	Child Element(s)
Array	1..1	None	None

detail_type

課金の区分

billing」(課金)か「trial」(トライアル)

Data Type	Cardinality	Parent Element	Child Element(s)
String	1..1	None	None

usage

請求対象となった使用量

Data Type	Cardinality	Parent Element	Child Element(s)
Number	1..1	None	None

charge

課金額

Data Type	Cardinality	Parent Element	Child Element(s)
Number	1..1	None	None

unit_price

商品の単価

Data Type	Cardinality	Parent Element	Child Element(s)
Number	1..1	None	None

Example of Request


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

Example of Response

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