見積り
見積りの作成
論争
| 引数 | 必須 | 説明 |
|---|---|---|
| viewId | はい | 見積もりを生成する ビューの ID。 viewId=0 はすべてのコストデータに見積もりを適用する。 |
| basis | はい | 見積もりの根拠となる費用。 例: basis=cash basis=amortized basis=adjusted basis=adjustedAmortized basis=list |
見積もりオブジェクト
サマリー・ブロック - 見積もりの主要な数字です
estimatedSpend (数字) - 当月の推定支出額
previousMonthSpend (数字) - 前月の支出合計
cumulativeMtdSpend (array) - 支出オブジェクトのリスト。 各オブジェクトには日付と値が含まれる。
previousMonthFinalized (boolean) - 前月の請求書が確定しているかどうか
currentDate (文字列) - 見積りの有効期限
詳細ブロック - serviceName/usageFamily の組み合わせで定義される、消費ドライバオブジェクトのリスト。 各オブジェクトには
serviceName (string) - AWS EC2, AWS RDS... のようなベンダーサービス名。
usageFamily (文字列) - インスタンス使用量、ストレージ...などのコスト・アクティビティのタイプ。
previousMonthSpend (数字) - 先月、この項目にいくら使ったか
mtdSpend (数字) - この項目に対する当月のこれまでの支出
estimatedSpend (数字) - この項目の月末における推定支出額
累積月-日付支出( cumulativeMtdSpend ) ブロック - 日付支出オブジェクトのリスト
date (string) - 利用日 YYYY-MM-DD
spend (数値) - その日付の使用額(米ドル)。
見積り対象例
このサンプル・レスポンスでは、読みやすさを考慮して、 "cumulativeMtdSpend" と "details" の最初の3つの項目のみを表示している。
{
"result": {
"estimatedSpend": 138429.32,
"previousMonthSpend": 142252.16238499997,
"previousMonthFinalized": true,
"currentDate": "2018-06-11",
"cumulativeMtdSpend": [
{
"date": "2018-06-01",
"spend": 10418.500360999999
},
{
"date": "2018-06-02",
"spend": 14226.970056999999
},
{
"date": "2018-06-03",
"spend": 18270.250674
}
]
},
"details": [
{
"serviceName": "AWS EC2",
"estimatedSpend": 54638.37,
"mtdSpend": 23101.275903,
"previousMonthSpend": 56600.280253,
"usageFamily": "Instance Usage"
},
{
"serviceName": "AWS Support",
"estimatedSpend": 15000,
"mtdSpend": 0,
"previousMonthSpend": 15000,
"usageFamily": "Support"
},
{
"serviceName": "AWS RDS",
"estimatedSpend": 13761.53,
"mtdSpend": 5101.559999999999,
"previousMonthSpend": 13690.639,
"usageFamily": "Instance Usage"
}
]
}
見積依頼例
当月推定値の取得
単純に/estimateエンドポイントでGETリクエストを行い、コストベースを指定する。
その際、 viewId。 viewId=0 を設定すると、すべての支出の見積もりが表示されます。
curl "https://api.cloudability.com/v3/estimate?basis=cash&viewId=11235"\\
-u ‘[auth_token]:
推定エンドポイントは、1ユーザーあたり1分間に10リクエスト、1組織あたり1分間に20リクエストに制限されている。