見積り

見積りの作成

論争

引数 必須

説明

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リクエストに制限されている。