すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:SumBills

最終更新日:Apr 16, 2026

インスタンスまたは課金項目ごとに費用情報を集計します。

操作説明

インスタンスまたは課金項目ごとに費用情報を集計します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /api/v1/bills/sum HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

インスタンスまたは課金項目ごとに費用情報を集計するためのリクエストパラメーター。例: {"startDate":1775714495313,"endDate":1776232895313,"statsType":"FEE_ITEM","topN":8}

projectNames

array

任意

インスタンス名のリスト。statsTypeFEE_ITEM に設定されている場合、このパラメーターは必須ではありません。

string

任意

インスタンス名。

projectName

startDate

integer

任意

課金サイクルの開始時刻。

1715393576201

endDate

integer

任意

課金サイクルの終了時刻。

1776232895313

statsType

string

任意

費用を集計するディメンション。有効な値: PROJECT (インスタンス別) および FEE_ITEM (課金項目別)。

PROJECT

topN

integer

任意

費用でソートした後に返す上位結果の数。

5

レスポンスフィールド

フィールド

説明

object

応答オブジェクト。

requestId

string

リクエスト ID。

BB66A390-4EF7-557E-9489-7F98D6F44002

httpCode

integer

HTTP ステータスコード。

200

data

object

戻り値。

totalCost

string

返されたすべての課金項目の合計費用。

123.56

currency

string

すべての費用値に使用される通貨。

CNY

itemBills

array<object>

課金項目のリスト。

object

課金項目オブジェクト。

itemName

string

項目名。リクエストの statsTypePROJECT の場合、これはインスタンス名です。statsTypeFEE_ITEM の場合、これは課金項目のタイプ (例: DRStorageComputationSqlStorage) です。

projectName

cost

string

費用。

123.56

currency

string

通貨。

CNY

percentage

number

この項目が合計費用に占める割合。値にパーセント記号 (%) は含まれません。

56.12

成功レスポンス

JSONJSON

{
  "requestId": "BB66A390-4EF7-557E-9489-7F98D6F44002",
  "httpCode": 200,
  "data": {
    "totalCost": "123.56",
    "currency": "CNY",
    "itemBills": [
      {
        "itemName": "projectName",
        "cost": "123.56",
        "currency": "CNY",
        "percentage": 56.12
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。