Billing API

支払履歴、料金明細API情報

history

月毎の支払い履歴の取得

Properties

  • data
    • 月毎の一覧
    • Type: string
    • Example: Data Propertiesを参照
  • meta:account_id
    • アカウントID
    • Type: string
    • Example: "71000090048"
  • meta:updated_at
    • 最終更新日
    • Type: string
    • Example: "2016-04-07T10:03:00+0900"

Data Properties

  • billing_amount
    • 合計額
    • Type: number
    • Example: 1080
  • month
    • 請求月
    • Type: string
    • Example: "2016-05"
  • payment_status
    • 支払いステータス(1:料金未確定, 2:未払い, 3:確定済)
    • Type: number
    • Example: 1

GET /history

支払履歴一覧の取得

Optional Properties

  • format
    • フォーマット
    • Type: string
    • Example: "json", "csv"

Curl Example

$ curl -n https://your.idcfcloud.com/api/v1/billings/history \
  -G \
  -d format=json \
  -H "X-IDCF-APIKEY: SrE5Ceeb1Q9MPl0yM0qbd3D3_CCpLWqnbcruMBj2WyK03Q6r0l6YJhIdCsYUmB7VM8AFttoqsxc3FxQrsAh8VQ" \
  -H "X-IDCF-Expires: 1437142261" \
  -H "X-IDCF-Signature: EenNFoNxnYEQVGW279XcQ+tBgwFPpMmTkDZQvKryIZg="
HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "meta": {
      "account_id": 71000090048,
      "updated_at": "2016-04-07T10:03:00+0900"
    },
    "data": [
      {
        "billing_amount": 1080,
        "month": "2016-04",
        "payment_status": 1
      },
      {
        "billing_amount": 1080,
        "month": "2016-03",
        "payment_status": 1
      }
    ]
  }
]

month

月次の利用料金明細の取得

Properties

  • data
    • 使用量一覧
    • Type: array
    • Example: Data Propertiesを参照
  • meta:meta:account_id
    • アカウントID
    • Type: string
    • Example: "71000090048"
  • meta:billing_period_end_at
    • 課金終了日
    • Type: string
    • Example: "2016-04-30"
  • meta:billing_period_start_at
    • 課金開始日
    • Type: string
    • Example: "2016-04-01"
  • meta:invoice_no
    • 請求番号 (当月はnullになります)
    • Type: string
    • Example: "B7112834501"
  • meta:tax
    • 消費税額
    • Type: number
    • Example: 3484
  • meta:taxable_amount
    • 小計
    • Type: number
    • Example: 43608
  • meta:total
    • 合計額
    • Type: number
    • Example: 47092
  • meta:updated_at
    • 最終更新日
    • Type: string
    • Example: 2016-04-07T10:03:00+0900

Data Properties

  • Allocated
    • リソースの確保時間
    • Type: number
    • Example: 144.0
  • Amount
    • 税抜請求額
    • Type: number
    • Example: 13320
  • Category
    • サービスのカテゴリー
    • Type: string
    • Example: "VirtualMachine"
  • EndDate
    • リソース使用量の算出終了日
    • Type: string
    • Example: "2016-04-06"
  • Menu
    • 商品名
    • Type: string
    • Example: "highio.5XL128"
  • Net
    • 税込請求額
    • Type: number
    • Example: 14385
  • Region
    • リージョン名
    • Type: string
    • Example: "jp-east"
  • ResourceDisplayName
    • リソースの表示名
    • Type: string
    • Example: "highiot"
  • Running
    • 仮想マシンの起動時間(仮想マシンのみ)
    • Type: number
    • Example: 144
  • ServiceName
    • サービス名
    • Type: string
    • Example: "Cloud Computing"
  • StartDate
    • リソース使用量の算出開始日
    • Type: string
    • Example: "2016-04-04"
  • Stopped
    • 仮想マシンの停止時間(仮想マシンのみ)
    • Type: number
    • Example: 0
  • Tax
    • 消費税
    • Type: number
    • Example: 1065
  • Usage
    • リソースの使用量
    • Type: number
    • Example: 144
  • ZoneName
    • ゾーン名
    • Type: string
    • Example: "tesla"

GET /:month

月次の利用料金明細

Optional Properties

  • format
    • フォーマット
    • Type: string
    • Example: "json", "csv"

Curl Example

$ curl -n https://your.idcfcloud.com/api/v1/billings/2016-04 \
  -G \
  -d format=json \
  -H "X-IDCF-APIKEY: SrE5Ceeb1Q9MPl0yM0qbd3D3_CCpLWqnbcruMBj2WyK03Q6r0l6YJhIdCsYUmB7VM8AFttoqsxc3FxQrsAh8VQ" \
  -H "X-IDCF-Expires: 1437142261" \
  -H "X-IDCF-Signature: EenNFoNxnYEQVGW279XcQ+tBgwFPpMmTkDZQvKryIZg="
HTTP/1.1 200 OK
Content-Type: application/json
{
  "meta": {
    "account_id": 71000090048,
    "billing_period_start_at": "2016-04-01",
    "billing_period_end_at": "2016-04-30",
    "invoice_no": "B7112834501",
    "taxable_amount": 43608,
    "tax": 3484,
    "total": 47092,
    "updated_at": "2016-04-07T10:03:00+0900"
  },
  "data": [
    {
      "Allocated": 42.0,
      "Amount": 42,
      "Category": "example",
      "Enddate": "2016-02-01",
      "Menu": "highio.5XL128",
      "Net": 42,
      "Region": "jp-east",
      "ResourceDisplayName": "ROOT-2622",
      "Running": 42.0,
      "ServiceName": "Cloud Computing",
      "StartDate": "2016-02-01",
      "Stopped": 42.0,
      "Tax": 42,
      "Usage": 42.0,
      "ZoneName": "tesla"
    }
  ]
}