ListJobMetric でジョブパフォーマンスメトリクスを監視・分析 - 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:ListJobMetric

list

*All Resource

*

なし

リクエスト構文

POST /api/v1/jobs/metric HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
startTime	integer	必須	観測間隔の開始時刻。	1735534322
endTime	integer	必須	観測間隔の終了時刻。	1735536322
body	object	任意	リクエストボディのパラメーター。
metric	string	任意	観測メトリックの名前。列挙値: inputBytes : inputBytes memory : メモリ num : num inputBytesPerCu : inputBytesPerCu cpu : cpu runningTime : runningTime	num
type	string	任意	観測メトリックのタイプ。列挙値: p1 : メトリック `runningTime` のみ p99 : メトリック `runningTime` のみ total : メトリック `num`、`cpu`、`memory`、`inputBytes`、`inputBytesPerCu` のみ min : メトリック `runningTime` のみ avg : メトリック `runningTime` のみ max : メトリック `runningTime` のみ p5 : メトリック `runningTime` のみ p90 : メトリック `runningTime` のみ p50 : メトリック `runningTime` のみ p95 : メトリック `runningTime` のみ p10 : メトリック `runningTime` のみ	total
project	array	任意	MaxCompute プロジェクトの名前 (フィルター用)。
	string	任意	MaxCompute プロジェクトの名前。	project_a
quota	array	任意	ジョブで使用されるコンピューティングクォータのニックネーム (フィルター用)。
	string	任意	ジョブで使用されるコンピューティングクォータのニックネーム。	os_PayAsYouGoQuota
period	integer	任意	モニタリング統計期間。単位：秒。列挙値: 3600 : 3600 86400 : 86400	3600
group	string	任意	グループ化の基準。説明指定できる値：`project`、`quota`、`type`、`status`。それぞれの意味は次のとおりです： `project`：プロジェクトごとにグループ化して集計します。 `quota`：クォータごとにグループ化して集計します。 `type`：ジョブタイプごとにグループ化して集計します。 `status`：ジョブステータスごとにグループ化して集計します。列挙値: quota : quota project : project type : type status : status	project

レスポンスフィールド

フィールド	型	説明	例
	object	PopResult
requestId	string	リクエスト ID。	0be3e0aa16667684362147582e038f
httpCode	integer	HTTP ステータスコード。 1xx：情報レスポンス - リクエストは受信され、処理は継続中です。 2xx：成功 - リクエストは正常に受信、理解、およびサーバーに受け入れられました。 3xx：リダイレクト - リクエストを完了するには、さらなるアクションが必要です。 4xx：クライアントエラー - リクエストに正しくない構文が含まれているか、リクエストを処理できません。 5xx：サーバーエラー - サーバーが有効なリクエストの処理に失敗しました。	200
errorCode	string	エラーコード。	OBJECT_NOT_EXIST
errorMsg	string	エラーメッセージ。	This object does not exist.
data	object	返されるデータ。
category	string	メトリックのカテゴリ。	job
name	string	観測メトリックの名前。	num
period	integer	モニタリング統計期間。単位：秒。	3600
metrics	array<object>	メトリックの詳細。
	array<object>	メトリックの値。
metric	object	メトリック関連情報。
	string	メトリック情報。説明指定できる値：`type`、`project`、`quota`、`group`。	"type": "total"
values	array	メトリック値の情報。
	array	メトリック値のリスト。
	number	最初の列はタイムスタンプを表し、2 番目の列は対応する値を表します。	1736679600, 3

例

成功レスポンス

JSONJSON

{
  "requestId": "0be3e0aa16667684362147582e038f",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "category": "job",
    "name": "num",
    "period": 3600,
    "metrics": [
      {
        "metric": {
          "key": "\"type\": \"total\""
        },
        "values": [
          [
            0
          ]
        ]
      }
    ]
  }
}

エラーコード

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

変更履歴

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