MaxCompute API で従量課金コンピューティングメトリクスをクエリ - MaxCompute - Alibaba Cloud - MaxCompute

インスタンスレベルのタスクのコンピュート使用量を一覧表示します。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

odps:ListComputeMetricsByInstance

list

*すべてのリソース。

*

なし

リクエスト構文

POST /api/v1/computeMetrics/listByInstance HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
body	object	任意	リクエストボディのパラメーター。
projectNames	array	任意	プロジェクト名。
	string	任意	プロジェクト名。	odps_porject
startDate	integer	任意	開始時間。この値はミリ秒単位の UNIX タイムスタンプです。	1715393576201
endDate	integer	任意	終了時間。この値はミリ秒単位の UNIX タイムスタンプです。	1718590596556
instanceId	string	任意	タスクの ID。	20240730****ddlr
jobOwner	string	任意	タスクのオーナー。	ALIYUN$7632***@aliyun.com
signature	string	任意	SQL タスクのシグネチャ。	ghijkl789012
pageNumber	integer	任意	ページ番号。	1
pageSize	integer	任意	1 ページあたりのエントリ数。デフォルト値: 10。	10
types	array	任意	メータリングタイプ。
	string	任意	メータリングタイプ。有効な値: ComputationSql: 内部テーブルを操作する SQL タスクのメータリングデータ。 ComputationSqlOTS: OTS 外部テーブルを操作する SQL タスクのメータリングデータ。 ComputationSqlOSS: OSS 外部テーブルを操作する SQL タスクのメータリングデータ。 MapReduce: MapReduce タスクのメータリングデータ。 spark: Spark タスクのメータリングデータ。 mars: Mars タスクのメータリングデータ。	SQL
specCodes	array	任意	スペックタイプ。
	string	任意	スペックタイプ。有効な値: OdpsStandard: 従量課金の課金方法 Standard Edition。 OdpsSpot: 従量課金の課金方法 Off-peak エディション。	OdpsStandard

レスポンスフィールド

フィールド	型	説明	例
	object	応答。例: { "data":{ "instanceComputeMetrics":[ { "unit":"GBCplx", "instanceId":"20260415082755g4af3vobxio", "submitTime":1776241680, "specCode":"OdpsStandard", "signature":"4c504210645f7850cf847c17886bf", "usage":0.8054948877543211, "jobOwner":"RAM$1393348188455728:role/aliyunservicerolefomputemms", "endTime":1776241682, "type":"ComputationSql", "projectName":"dbs_mc" }, { "unit":"GBCplx", "instanceId":"202604150828258gv9abz7unq14", "submitTime":1776241707, "specCode":"OdpsStandard", "signature":"cacb1e31deb**c19e515b59634a", "usage":0.1720797186717391, "jobOwner":"ALIYUN$mc_ma_testcloud_com", "endTime":1776241707, "type":"ComputationSql", "projectName":"webui_139728_hangzhou" } ], "pageNumber":1, "pageSize":10, "totalCount":2808 }, "requestId":"0adb99df17763408113761151d0001" }
requestId	string	リクエスト ID。	0bc059b717363029839908920ea631
httpCode	integer	HTTP 状態コード。有効な値: 1xx: 情報応答。リクエストは受信され、処理中です。 2xx: 成功。リクエストはサーバーによって正常に受信、理解、および受け入れられました。 3xx: リダイレクト。リクエストはリダイレクトされ、リクエストを完了するにはさらに操作が必須です。 4xx: クライアントエラー。リクエストに無効なパラメーターまたは正しくない構文が含まれているか、特定のリクエスト条件を満たすことができません。 5xx: サーバーエラー。他の理由により、サーバーはリクエストを満たすことができません。	200
data	object	応答データ。
instanceComputeMetrics	array<object>	従量課金タスクのコンピュート使用量のリスト。
	object
instanceId	string	タスクの ID。	20240730****ddlr
type	string	メータリングタイプ。有効な値: ComputationSql: 内部テーブルを操作する SQL タスクのメータリングデータ。 ComputationSqlOTS: OTS 外部テーブルを操作する SQL タスクのメータリングデータ。 ComputationSqlOSS: OSS 外部テーブルを操作する SQL タスクのメータリングデータ。 MapReduce: MapReduce タスクのメータリングデータ。 spark: Spark タスクのメータリングデータ。 mars: Mars タスクのメータリングデータ。	ComputationSql
specCode	string	スペックタイプ。有効な値: OdpsStandard: 従量課金の課金方法 Standard Edition。 OdpsSpot: 従量課金の課金方法 Off-peak エディション。	OdpsStandard
jobOwner	string	タスクのオーナー。	ALIYUN$7632***@aliyun.com
projectName	string	プロジェクト名。	odps_porject
submitTime	integer	タスクの送信時間。この値はミリ秒単位の UNIX タイムスタンプです。	1610432000000
endTime	integer	タスクの終了時間。この値はミリ秒単位の UNIX タイムスタンプです。	1710432000000
signature	string	SQL タスクのシグネチャ。	pqrs12345tuv
usage	number	コンピュート使用量。スキャンベースの課金タイプの場合、単位は GB です。これには、スキャンされたデータ量に基づいて課金される ComputationSql、ComputationSqlOTS、および ComputationSqlOSS 課金タイプが含まれます。コンピュート使用量は、各タスクのスキャンボリューム × 複雑さとして計算されます。ComputationSqlOTS および ComputationSqlOSS タイプの複雑さは 1 に固定されています。 CU 時間ベースの課金タイプの場合、単位は CU 時間です。これには、CU 時間に基づいて課金される MapReduce、spark、および mars 課金タイプが含まれます。	1024
unit	string	コンピュート使用量の単位。	GB
totalCount	integer	返されるエントリの総数。	64
pageNumber	integer	現在のページ番号。	1
pageSize	integer	1 ページあたりのエントリ数。	10

例

成功レスポンス

JSONJSON

{
  "requestId": "0bc059b717363029839908920ea631",
  "httpCode": 200,
  "data": {
    "instanceComputeMetrics": [
      {
        "instanceId": "20240730****ddlr",
        "type": "ComputationSql",
        "specCode": "OdpsStandard",
        "jobOwner": "ALIYUN$7632***@aliyun.com",
        "projectName": "odps_porject",
        "submitTime": 1610432000000,
        "endTime": 1710432000000,
        "signature": "pqrs12345tuv",
        "usage": 1024,
        "unit": "GB"
      }
    ],
    "totalCount": 64,
    "pageNumber": 1,
    "pageSize": 10
  }
}

エラーコード

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

変更履歴

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