• MapReduce Service

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

Querying Job Object Details

Function

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

URI

  • Format:

    GET /v1.1/{project_id}/jobs/{job_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_id

    Yes

    Job object ID

Request

  • Example:

    None.

  • Parameter description

    None.

Response

  • Example:
    {
        "job": {
            "name": "my-mapreduce-job",
            "type": "MapReduce",
            "description": "This is the Map Reduce job template",
            "mains": [],
            "libs": [
                {
                    "name": "my-job-binary-666",
                    "url": "/simple/mapreduce/program",
                    "description": "this is the job binary template",
                    "id": "2628d0e4-6109-4a09-a338-c4ee1b0963ed",
                    "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
                    "is_public": false,
                    "is_protected": null,
                    "extra": null
                }
            ],
            "created_at": "2017-06-22T09:39:13",
            "updated_at": "2017-06-22T09:39:13",
            "id": "38a04cba-c113-4868-b11f-f50e8b1bf252",
            "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
            "is_public": false,
            "is_protected": false,
            "interface": []
        }
    }
  • Parameter description
    Table 2 Response parameter description

    Parameter

    Mandatory or Not

    Type

    Description

    is_public

    No

    Bool

    Whether a job object is public

    • true
    • false

    The current version does not support this function.

    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 object creation time

    id

    Yes

    String

    Job object ID

    name

    Yes

    String

    Job object name

    updated_at

    Yes

    String

    Job object update time

    description

    Yes

    String

    Job object description

    interface

    Yes

    Array

    User-defined interface set

    libs

    Yes

    Array

    Dependency package set of a job object

    type

    Yes

    String

    Job object type

    mains

    Yes

    Array

    Executable program set of a job object

    is_protected

    No

    Bool

    Whether a job object is protected

    • true
    • false

    The current version does not support this function.

Status Code

Table 3 describes the status code of this API.

Table 3 Status code

Status code

Description

200

The job object details are queried successfully.

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