Help Center> Cloud Stream Service> API Reference> APIs> APIs Related to Job Management> Running a Job
View PDF

Running a Job

Function

This API is used to run jobs.

URI

  • URI format

    POST /v1.0/{project_id}/job/{job_id}/run

  • Parameter description
    Table 1 URI parameter description

    Parameter

    Type

    Mandatory

    Description

    project_id

    Route parameter

    Yes

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

    job_id

    Route parameter

    Yes

    Job ID.

    resumeSavePoint

    Query parameter

    No

    Whether to restore a job from the latest savepoint. The data type is Boolean.

    • If this parameter is set to true, the job is restored from the latest savepoint.
    • If this parameter is set to false, the job is started normally, not from a specific savepoint. The default value is false.

Request

None

Response

  • Example response 
    {
"message_id": "CS.10001",
"message": "Message content",
  "current_time": 1533686888000
}
  • Parameter description
    Table 2 Response parameters

    Parameter

    Mandatory

    Type

    Description

    message_id

    No

    String

    Message type ID.

    message

    No

    String

    Message content.

    current_time

    No

    Int

    Current time, expressed by milliseconds.

Status Code

Table 3 describes the status code.

Table 3 Status code

Status Code

Description

200

The request of starting a job is sent successfully.

400

The input parameters are invalid.

Error Code

For details, see Error Codes.