getJobExecutions

Prev Next

Available in VPC

Get the list of job executions.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET /api/v1/jobs/{jobId}/executions

Request headers

For information about the headers common to all Data Flow APIs, see Data Flow request headers.

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
jobId String Required Job ID

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
page Integer Optional Page number
  • 0-N (default: 0)
limit Integer Optional Page output count
  • 0-N (default: 1000)

Request example

The request example is as follows:

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

Response

This section describes the response format.

Response body

The response body includes the following data:

Field Type Required Description
list Array - Job execution list
count Integer - Number of response results
page Integer - Page number
limit Integer - Page output count

list

The following describes list.

Field Type Required Description
jobExecutionId String - Job execution ID
jobId String - Job ID
jobCondition Object - Job execution option information
jobCondition.workerType String - Worker type
  • DATAFLOW (default)
jobCondition.numWorker Integer - Number of workers
  • 2 (default)
jobCondition.timeout Integer - Execution timeout (minute)
  • Time spent waiting for the results of a job when it is executed once
  • 0-1440 (default: 360)
jobCondition.nrn String - NAVER Cloud Platform resource identification value for job
jobCondition.scriptPath String - Job execution script storage path
jobCondition.logPath String - Job execution history storage path
status String - Last job execution status
  • READY | RUNNING | COMPLETED | FAILED | CANCELED
    • READY: pending
    • RUNNING: running
    • COMPLETED: completed
    • FAILED: failed
    • CANCELED: canceled
startDate String - Job execution date and time
  • ISO 8601 format (including UTC+9)
endDate String - Job end date and time
  • ISO 8601 format (including UTC+9)
createdDate String - Job creation date and time
  • ISO 8601 format (including UTC+9)
triggerId String - Trigger ID
jobName String - Job name
waitingTime Integer - Job wait time (minute)
executorNum Integer - Number of job workers
runningTime Integer - Job execution time (minute)
parsedParameters Object - Parsed job execution parameter
type String - Job type
  • JOB | WORKFLOW

Response status codes

For response status codes common to all Data Flow APIs, see Data Flow API response status codes.

Response example

The response example is as follows:

{
    "list": [
        {
            "jobExecutionId": "fKE22JFX4PAu",
            "jobId": "gqigvHhTu7ra",
            "jobCondition": {
                "workerType": "DEFAULT",
                "numWorker": 2,
                "timeout": 360,
                "nrn": "nrn:PUB:IAM::*******:Role/********-0496-11f0-baf6-246e96591a38",
                "scriptPath": "dataflow-2706412-****/scripts/",
                "logPath": "dataflow-2706412-****/sparkHistoryLogs/",
                "consoleLogPath": "dataflow-2706412-****/sparkHistoryLogs/console/gqigvHhTu7ra/fKE22JFX4PAu_2025-03-21T11:12:56.log"
            },
            "status": "COMPLETED",
            "startDate": "2025-03-21T11:12:54+09:00",
            "endDate": "2025-03-21T11:27:47+09:00",
            "createdDate": "2025-03-21T11:12:54+09:00",
            "triggerId": "8bjF7EjNypqG",
            "triggerName": "trigger002",
            "jobName": "job001",
            "waitingTime": 830,
            "executorNum": 2,
            "runningTime": 14,
            "parsedParameters": [],
            "type": "WORKFLOW"
        }
    ],
    "count": 1,
    "page": 0,
    "limit": 1000
}