Updated on 2023-12-18 GMT+08:00

Asynchronous Job Query

Function

This API is used to query the execution status of an asynchronous job.

URI

GET /v1.0/{project_id}/jobs/{job_id}
Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

job_id

Yes

String

Specifies the unique ID assigned to the job for querying the execution status in Combined API.

Request

None

Response

Table 2 Response parameters

Parameter

Type

Description

status

String

Specifies the job execution status.

SUCCESS: The job was successfully executed.

FAIL: The job failed.

RUNNING: The job is in progress.

INIT: The job is being initialized.

entities

Dictionary data structure

Specifies the resource information or error information. The ELB resource ID is used as an example in the response example.

job_id

String

Specifies the unique ID assigned to the job for querying the execution status in Combined API.

job_type

String

Specifies the job type.

error_code

String

Specifies the error code.

fail_reason

String

Specifies the cause of an error.

Example

  • Example request

    None

  • Example response
    {
        "status":"RUNNING",
        "entities":
        {"elb_id":"ea3e5715b68850a747ec41f335625c08"},
        "job_id":"4010b39b4fd3d5ff014fd943bac41619",
        "job_type":"deleteELB",
        "begin_time":"2015-09-17T03:05:38.756Z",
        "end_time":"",
        "error_code":null,
        "fail_reason":null
    }

Status Code

  • Normal

    200

  • Error

    Status Code

    Description

    400 badRequest

    Request error.

    401 unauthorized

    Authentication failed.

    403 userDisabled

    You do not have the permission to perform the operation.

    404 Not Found

    The requested page does not exist.

    500 authFault

    System error.

    503 serviceUnavailable

    The service is unavailable.