すべてのプロダクト
Search

このプロダクト

    MaxCompute:ListJobSnapshotInfos

    ドキュメントセンター

    MaxCompute:ListJobSnapshotInfos

    最終更新日:Nov 26, 2025

    特定の時点におけるジョブスナップショットデータを取得します。

    今すぐお試しください

    この 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:ListJobSnapshotInfos

    list

    *All Resource

    *

    		 なし なし

    リクエスト構文

    POST /api/v1/jobs/snapshot HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    tenantId

    string

    任意

    テナント ID。テナント ID を表示するには、MaxCompute コンソールにログインします。左側のナビゲーションウィンドウで、[テナント管理] > [テナントプロパティ] を選択します。

    478403690625249
    region

    string

    任意

    リージョン ID。

    cn-chengdu
    orderColumn

    string

    任意

    ソートに使用する列。有効な値：

    • submittedAtTime

    • waitingTime

    • runningAtTime

    • runningTime

    • snapshotTime

    • totalTime

    • cpuUsage

    • memoryUsage

    • minCpuPct

    • minMemoryPct

    • priority

    • cpuRequest

    • memoryRequest

    • cpuUsageToRequestRatio

    • memoryUsageToRequestRatio

    cpuUsage
    ascOrder

    boolean

    任意

    結果を昇順でソートするかどうかを指定します。

    true
    pageNumber

    integer

    任意

    ページ番号。

    1
    pageSize

    integer

    任意

    1 ページあたりのエントリ数。

    10
    body

    object

    任意

    リクエストボディ。

    from

    integer

    任意

    開始 UNIX タイムスタンプ。

    説明

    このパラメーターは無効です。終了タイムスタンプは、表示したいスナップショットの時点です。

    1706840714
    to

    integer

    必須

    終了 UNIX タイムスタンプ。

    1706840714
    quotaNickname

    string

    任意

    ジョブが使用する計算クォータのニックネーム。

    quota_A
    projectList

    array

    任意

    プロジェクト名。

    string

    任意

    プロジェクト名。

    projectA
    typeList

    array

    任意

    ジョブタイプ。

    string

    任意

    ジョブタイプ。

    SQL
    jobOwnerList

    array

    任意

    ジョブオーナー。

    string

    任意

    ジョブオーナー。

    ALIYUN$7632***@aliyun.com
    signatureList

    array

    任意

    SQL ジョブの署名。

    string

    任意

    SQL ジョブの署名。

    signatureabc
    extNodeIdList

    array

    任意

    アップストリームノード ID。

    string

    任意

    アップストリームノード ID。

    76358164
    instanceIdList

    array

    任意

    ジョブインスタンス ID。

    string

    任意

    ジョブインスタンス ID。

    20241028****jkl
    statusList

    array

    任意

    ジョブステータス。

    string

    任意

    ジョブステータス。

    running
    priorityList

    array

    任意

    ジョブの優先度。

    integer

    任意

    ジョブの優先度。

    9
    sortByList

    array

    任意

    複数列ソートのフィールド。

    string

    任意

    複数列ソートのフィールド。

    cuUsage
    sortOrderList

    array

    任意

    複数列ソートのソート順。

    string

    任意

    複数列ソートのソート順。

    desc

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    PopResult

    requestId

    string

    リクエスト ID。

    0b87b7e716665825896565060e87a4
    httpCode

    integer

    HTTP ステータスコード。

    • 1xx：情報 - リクエストは受信され、処理は継続中です。

    • 2xx：成功 - リクエストは正常に受信、理解、承認されました。

    • 3xx：リダイレクト - リクエストを完了するには、さらなるアクションが必要です。

    • 4xx：クライアントエラー - リクエストに不正な構文が含まれているか、リクエストを処理できません。

    • 5xx：サーバーエラー - サーバーが有効なリクエストの処理に失敗しました。

    200
    errorCode

    string

    エラーコード。

    OBJECT_NOT_EXIST
    errorMsg

    string

    エラーメッセージ。

    异常信息
    data

    object

    返されるデータ。

    jobInfoList

    array<object>

    ジョブスナップショットのリスト。

    object

    ジョブスナップショット情報。

    tenantId

    string

    テナント ID。

    213065738244354
    region

    string

    リージョン ID。

    cn-chengdu
    instanceId

    string

    ジョブ ID。

    20241028****jkl
    jobOwner

    string

    ジョブオーナー。

    ALIYUN$7632***@aliyun.com
    project

    string

    プロジェクト名。

    projectA
    jobType

    string

    ジョブタイプ。

    SQL
    priority

    integer

    ジョブの優先度。

    9
    status

    string

    ジョブステータス。

    説明

    スナップショットジョブのステータスは `running` のみです。

    running
    quotaNickname

    string

    ジョブが使用する計算クォータのニックネーム。

    quota_A
    quotaType

    string

    クォータタイプ。

    subscription
    cpuUsage

    integer

    スナップショット時間におけるジョブの CPU 使用量。単位：コア。

    100
    memoryUsage

    integer

    スナップショット時間におけるジョブのメモリ使用量。単位：MB。

    409600
    maxCpuPct

    number

    このパラメーターは使用されません。

    -1
    minCpuPct

    number

    スナップショット時間におけるサブスクリプションジョブの CPU 使用率。この値は、CPU 使用量を予約済み CPU 保証とエラスティック予約済み CPU の合計で割って計算されます。このパラメーターは、従量課金ジョブでは利用できません。

    0.6
    maxMemoryPct

    number

    このパラメーターは使用されません。

    -1
    minMemoryPct

    number

    観測時間におけるサブスクリプションジョブのメモリ使用率。この値は、メモリ使用量を予約済みメモリ保証とエラスティック予約済みメモリの合計で割って計算されます。このパラメーターは、従量課金ジョブでは利用できません。

    0.6
    submittedAtTime

    integer

    ジョブが送信された時間。

    1736821785
    waitingTime

    integer

    待機時間 (秒)。ジョブが送信されてから実行を開始するまでの時間です。ジョブが開始されていない場合は、送信時間からスナップショット時間までの時間です。

    20
    runningAtTime

    integer

    ジョブが実行を開始した時間。

    説明

    ジョブが最初の計算リソースを取得した時間。

    1736821805
    runningTime

    integer

    実行時間 (秒)。ジョブが実行を開始してからスナップショット時間までの時間です。ジョブが開始されていない場合、このパラメーターは空です。

    43
    snapshotTime

    integer

    スナップショット時間。

    1736821848
    totalTime

    integer

    合計時間 (秒)。ジョブが送信されてからスナップショット時間までの時間です。

    63
    signature

    string

    SQL ジョブの署名。

    signatureabc
    extPlantFrom

    string

    アップストリームプラットフォーム。

    Dataworks
    extNodeId

    string

    アップストリームノード ID。

    76358164
    extNodeOnDuty

    string

    タスクオーナーのアカウント ID。

    duty_2
    cpuRequest

    integer

    スナップショット時間においてジョブがリクエストした CPU コア数。

    200
    memoryRequest

    integer

    スナップショット時間においてジョブがリクエストしたメモリ量 (MB)。

    409600
    cpuUsageToRequestRatio

    number

    スナップショット時間におけるジョブの CPU 履行率。CPU 使用量を CPU リクエストで割って計算されます。

    0.5
    memoryUsageToRequestRatio

    number

    スナップショット時間におけるジョブのメモリ履行率。メモリ使用量をメモリリクエストで割って計算されます。

    1
    extPlatformId

    string

    totalCount

    integer

    返されたエントリの総数。

    123
    pageNumber

    integer

    ページ番号。

    1
    pageSize

    integer

    1 ページあたりのエントリ数。

    10

    例

    成功レスポンス

    JSONJSON

    {
  "requestId": "0b87b7e716665825896565060e87a4",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "异常信息",
  "data": {
    "jobInfoList": [
      {
        "tenantId": "213065738244354",
        "region": "cn-chengdu",
        "instanceId": "20241028****jkl",
        "jobOwner": "ALIYUN$7632***@aliyun.com",
        "project": "projectA",
        "jobType": "SQL",
        "priority": 9,
        "status": "running",
        "quotaNickname": "quota_A",
        "quotaType": "subscription",
        "cpuUsage": 100,
        "memoryUsage": 409600,
        "maxCpuPct": -1,
        "minCpuPct": 0.6,
        "maxMemoryPct": -1,
        "minMemoryPct": 0.6,
        "submittedAtTime": 1736821785,
        "waitingTime": 20,
        "runningAtTime": 1736821805,
        "runningTime": 43,
        "snapshotTime": 1736821848,
        "totalTime": 63,
        "signature": "signatureabc",
        "extPlantFrom": "Dataworks",
        "extNodeId": "76358164",
        "extNodeOnDuty": "duty_2",
        "cpuRequest": 200,
        "memoryRequest": 409600,
        "cpuUsageToRequestRatio": 0.5,
        "memoryUsageToRequestRatio": 1,
        "extPlatformId": ""
      }
    ],
    "totalCount": 123,
    "pageNumber": 1,
    "pageSize": 10
  }
}

    エラーコード

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

    変更履歴

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