Updated on 2022-12-14 GMT+08:00

Querying Job Execution Object Details

Function

This API is used to query detailed information about a job execution object. This API is compatible with Sahara.

URI

  • Format

    GET /v1.1/{project_id}/job-executions/{job_execution_id}

  • Parameter description
    Table 1 URI parameter description

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Project ID. For details on how to obtain the project ID, see Obtaining a Project ID.

    job_execution_id

    Yes

    Job execution object ID

Request

Request parameters

None.

Response

Table 2 Response parameter description

Parameter

Type

Description

info

String

Key-value pair set, containing job running information returned by Oozie

cluster_id

String

Cluster ID

job_id

String

Job ID

engine_job_id

String

Workflow ID of Oozie

oozie_job_id

String

Workflow ID returned by Oozie

tenant_id

String

Project ID. For details on how to obtain the project ID, see Obtaining a Project ID.

created_at

String

Job execution object creation time

updated_at

String

Job execution object update time

start_time

String

Job start time

end_time

String

Job end time

return_code

String

Response code after job execution

input_id

String

Input data source ID of a job execution object

output_id

String

Output data source ID of a job execution object

is_protected

Bool

Whether a job execution object is protected

  • true
  • false

The current version does not support this function.

is_public

Bool

Whether a job execution object is public

  • true
  • false

The current version does not support this function.

job_configs

Object

Key-value pair set for saving job running configurations

For details, see Table 3.

data_source_urls

Object

Data source URL of a job execution object

Id

String

Job execution object ID

Table 3 job_configs parameter description

Parameter

Type

Description

configs

Object

Key-value pair set configured for a job

args

Array

List of arguments

params

Object

Key-value pair set for running a job

Example

  • Example request

    None.

  • Example response
    {
        "job_execution": {
            "created_at": "2017-06-22T06:23:51",
            "updated_at": "2017-06-22T06:23:51",
            "id": "852042ea-a32c-424b-aacf-df2e6d6642b5",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "job_id": "",
            "start_time": "2017-06-22T06:23:51",
            "end_time": null,
            "cluster_id": "33dff020-7f96-4270-9c3a-88b99627f6e2",
            "oozie_job_id": null,
            "return_code": null,
            "input_id": null,
            "output_id": null,
            "is_protected": false,
            "is_public": null,
            "engine_job_id": null,
            "job_configs": null,
            "data_source_urls": null,
            "info": null
        }
    }

Status Code

Table 4 describes the status code of this API.

Table 4 Status code

Status Code

Description

200

The job execution object details are queried successfully.

For the description about error status codes, see Status Codes.