• MapReduce Service

mrs
  1. Help Center
  2. MapReduce Service
  3. API Reference
  4. APIs
  5. Job Execution Object APIs
  6. Querying Job Execution Object Details

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 or Not

    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

  • Example:

    None.

  • Parameter description

    None.

Response

  • Example:
    {
        "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": null,
            "is_public": null,
            "engine_job_id": null,
            "job_configs": null,
            "data_source_urls": null,
            "info": null
        }
    }
  • Parameter description
    Table 2 Response parameter description

    Parameter

    Mandatory or Not

    Type

    Description

    info

    Yes

    String

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

    cluster_id

    No

    String

    Cluster ID

    job_id

    No

    String

    Job ID

    engine_job_id

    Yes

    String

    Workflow ID of Oozie

    oozie_job_id

    Yes

    String

    Workflow ID returned by Oozie

    tenant_id

    Yes

    String

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

    created_at

    Yes

    String

    Job execution object creation time

    updated_at

    Yes

    String

    Job execution object update time

    start_time

    Yes

    String

    Job start time

    end_time

    Yes

    String

    Job end time

    return_code

    Yes

    String

    Response code after job execution

    input_id

    Yes

    String

    Input data source ID of a job execution object

    output_id

    Yes

    String

    Output data source ID of a job execution object

    is_protected

    No

    Bool

    Whether a job execution object is protected

    • true
    • false

    The current version does not support this function.

    is_public

    No

    Bool

    Whether a job execution object is public

    • true
    • false

    The current version does not support this function.

    job_configs

    Yes

    Object

    Key-value pair set for saving job running configurations

    For details, see Table 3.

    data_source_urls

    Yes

    Object

    Data source URL of a job execution object

    id

    Yes

    String

    Job execution object ID

    Table 3 job_configs parameter description

    Parameter

    Mandatory or Not

    Type

    Description

    configs

    No

    Object

    Key-value pair set configured for a job

    args

    No

    Array

    List of arguments

    params

    No

    Object

    Key-value pair set for running a job

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 section Status Codes.