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

:GetJobRun

最終更新日:Mar 23, 2026

ジョブの詳細を取得します。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

emr-serverless-spark:GetJobRun

get

*All Resource

*

なし なし

リクエスト構文

GET /api/v1/workspaces/{workspaceId}/jobRuns/{jobRunId} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

workspaceId

string

必須

ワークスペースの ID。

w-d2d82aa09151****

jobRunId

string

必須

ジョブ実行の ID。

jr-93d98d2f7061****

リクエストパラメーター

パラメーター

必須 / 任意

説明

regionId

string

任意

リージョン ID。例: cn-hangzhou は中国 (杭州) リージョンを表します。

cn-hangzhou

レスポンスフィールド

フィールド

説明

object

返されるデータ。

jobRun

object

ジョブの詳細。

workspaceId

string

ワークスペース ID。

w-d2d82aa09155****

jobRunId

string

ジョブ実行 ID。

jr-93d98d2f7061****

name

string

ジョブの名前。

jobName

state

string

ジョブの状態。

Running

stateChangeReason

object

状態変更の理由。

code

string

エラーコード。

ERR-100000

message

string

エラーメッセージ。

connection refused

submitTime

integer

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

1684119314000

endTime

integer

ジョブが終了した時間。

1684122914000

codeType

string

ジョブのコードタイプ。有効な値:

  • SQL

  • JAR

  • PYTHON

SQL

webUI

string

ジョブの Web UI。

http://spark-ui

executionTimeoutSeconds

integer

ジョブ実行のタイムアウト期間。

3600

resourceOwnerId

string

ジョブを作成したユーザーの UID。

150978934701****

tags

array

タグ。

Tag

タグ。

log RunLog

実行ログのパス。

releaseVersion

string

Spark エンジンバージョン。

esr-3.3.1

resourceQueueId

string

ジョブが実行されるキューの名前。

root_queue

jobDriver JobDriver

Spark ドライバー情報。

configurationOverrides

object

ジョブの Spark 構成。

configurations

array

構成。

Configuration

構成。

displayReleaseVersion

string

コンソールに表示されるバージョン。

esr-4.0.0 (Spark 3.5.2, Scala 2.12)

fusion

boolean

Fusion エンジンを有効にしてジョブ実行を高速化するかどうかを示します。

false

environmentId

string

環境 ID。

env-cpv569tlhtgndjl8****

notebookAccessUrl

string

ジョブ実行のノートブックのアクセス URL。

http://workflow-ide-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/spark-notebook-output/w-xxxxxxxxx/xxxxxxx

priority

string

ジョブ実行の優先度。

5

requestId

string

リクエスト ID。

DD6B1B2A-5837-5237-ABE4-FF0C8944****

成功レスポンス

JSONJSON

{
  "jobRun": {
    "workspaceId": "w-d2d82aa09155****",
    "jobRunId": "jr-93d98d2f7061****",
    "name": "jobName",
    "state": "Running",
    "stateChangeReason": {
      "code": "ERR-100000",
      "message": "connection refused"
    },
    "submitTime": 1684119314000,
    "endTime": 1684122914000,
    "codeType": "SQL",
    "webUI": "http://spark-ui",
    "executionTimeoutSeconds": 3600,
    "resourceOwnerId": "150978934701****",
    "tags": [
      {
        "key": "workflowId",
        "value": "wf-123test"
      }
    ],
    "log": {
      "driverStdOut": "oss://bucket/path/to/stdout",
      "driverStdError": "oss://bucket/path/to/stderr",
      "driverSyslog": "oss://bucket/path/to/syslog",
      "driverStartup": "oss://bucket/path/to/startup"
    },
    "releaseVersion": "esr-3.3.1",
    "resourceQueueId": "root_queue",
    "jobDriver": {
      "sparkSubmit": {
        "entryPoint": "oss://bucket/path/to/entrypoint.jar",
        "entryPointArguments": [
          "arg1"
        ],
        "sparkSubmitParameters": "--conf spark.app.name=test"
      }
    },
    "configurationOverrides": {
      "configurations": [
        {
          "configFileName": "common.conf",
          "configItemKey": "hive.metastore.type",
          "configItemValue": "USER_RDS"
        }
      ]
    },
    "displayReleaseVersion": "esr-4.0.0 (Spark 3.5.2, Scala 2.12)",
    "fusion": false,
    "environmentId": "env-cpv569tlhtgndjl8****",
    "notebookAccessUrl": "http://workflow-ide-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/spark-notebook-output/w-xxxxxxxxx/xxxxxxx",
    "priority": "5"
  },
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

エラーコード

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

変更履歴

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