getJob

VPC環境で利用できます。

ジョブの詳細情報を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/api/v1/jobs/{jobId}

リクエストヘッダ

Data Flow APIで共通して使用されるヘッダの詳細は、Data Flowのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`jobId`	String	Required	ジョブ ID getJobsを参照

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://dataflow.apigw.ntruss.com/api/v1/jobs/gqigvH******' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`jobId`	String	-	ジョブ ID
`name`	String	-	ジョブ名
`type`	String	-	ジョブタイプ `VISUAL` \| `SCRIPT`
`status`	String	-	ジョブの状態 `READY` `READY`: ジョブが実行可能
`maxConcurrentRuns`	Integer	-	最大同時実行回数
`lastExecutionStatus`	String	-	最終ジョブ実行の状態 `READY`\|`RUNNING`\|`COMPLETED`\|`FAILED`\|`CANCELLING`\|`CANCELLED`\|`TIMEOUT` `READY`: 実行待機 `RUNNING`: 実行中 `COMPLETED`: 完了 `FAILED`: 失敗 `CANCELLING`: キャンセル処理中 `CANCELLED`: キャンセル済み `TIMEOUT`: 実行制限時間超過実行履歴のないジョブはフィールドに含まれない
`nodes`	Array	-	ジョブのノード情報 ETLJobNodeを参照
`runCondition`	Object	-	ジョブ実行オプション
`runCondition.numWorker`	Integer	-	ワーカー数 2~10
`runCondition.timeout`	Integer	-	実行タイムアウト(分) 1~1440
`runCondition.nrn`	String	-	ジョブに対する NAVERクラウドプラットフォームリソースの識別値
`runCondition.scriptPath`	String	-	ジョブ実行スクリプトの保存先パス
`runCondition.logPath`	String	-	ジョブの実行履歴の保存先パス
`runCondition.parameters`	Object	-	ジョブに保存されているデフォルトのパラメータキー・値形式の文字列マップパラメータがない場合は空のオブジェクト(`{}`)
`createdDate`	String	-	ジョブの作成日時 ISO 8601形式(UTC+9を含む)
`updatedDate`	String	-	ジョブの更新日時 ISO 8601形式(UTC+9を含む)
`lastExecutionDate`	String	-	ジョブの最終実行日時 ISO 8601形式(UTC+9を含む)

レスポンスステータスコード

Data Flow APIで共通して使用されるレスポンスステータスコードの詳細は、Data Flowのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "jobId": "5Yns7J******",
  "name": "daily_sales_job",
  "type": "SCRIPT",
  "status": "READY",
  "maxConcurrentRuns": 3,
  "lastExecutionStatus": "COMPLETED",
  "nodes": [],
  "runCondition": {
    "numWorker": 2,
    "timeout": 360,
    "nrn": "nrn:PUB:IAM::*******:Role/********",
    "scriptPath": "dataflow-2706412-****/scripts/",
    "logPath": "dataflow-2706412-****/sparkHistoryLogs/",
    "parameters": {
      "target_date": "2025-03-21",
      "input_path": "aitems/sales/",
      "output_format": "parquet"
    }
  },
  "createdDate": "2025-03-21T10:02:02+09:00",
  "updatedDate": "2025-03-21T10:02:02+09:00",
  "lastExecutionDate": "2025-03-21T11:12:54+09:00"
}