View a Schedule’s Action

GET /api/v1.2/scheduler/<Schedule ID>/actions/<sequence_id>

Use this API to view an existing schedule’s action.

Schedule ID is the Schedule’s ID and it is a mandatory parameter.

sequence_id is the nth action of the schedule and it is optional.

Required Role

The following users can make this API call:

  • Users who belong to the system-user or system-admin group.
  • Users who belong to a group associated with a role that allows viewing a schedule’s actions. See Managing Groups and Managing Roles for more information.

Response

If you provide only <Schedule ID> in the API call, for example, /api/v1.2/scheduler/123/actions, then the API response contains the list of Scheduler instances in the descending order based on instance ID, that is the most recent run is the first action object in the actions array. The most recent Scheduler instance run might be the re-run instances of an old instance. This is illustrated in Example 1.

If you provide both <Schedule ID> and sequence_id in the API call, for example, /api/v1.2/scheduler/123/actions/5, then the API response contains the list of Scheduler run instances that belong to only that sequence ID and the results are always in the descending order based on rerun_number, that is the most recent rerun is the first action object in the actions array. This is illustrated in Example 2.

The two types of API calls and the corresponding responses are illustrated in the below examples.

Examples

Here are the two different examples.

Example 1

Goal: View details of the schedule’s action by providing only the schedule’s ID.

curl -i -X GET -H "X-AUTH-TOKEN: $AUTH_TOKEN" \
-H "Accept: application/json" \
-H "Content-type: application/json" \
"https://api.qubole.com/api/v1.2/scheduler/16537/actions"

Note

The above syntax uses https://api.qubole.com as the endpoint. Qubole provides other endpoints to access QDS that are described in Supported Qubole Endpoints on Different Cloud Providers.

Response

For brevity, the JSON is truncated.

{
"paging_info": {
    "next_page": null,
    "previous_page": null,
    "per_page": 10
},
"actions": [
    {
        "id": 6587693,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": 3460235,
        "rerun_number": 2,
        "created_at": "2018-02-13T07:27:42Z",
        "query_hist_id": 128128536,
        "dependencies": {
            "found": [],
            "not_found": []
        },
        "done": true,
        "status": "done",
        "periodic_job_id": 16537,
        "perms": {
            "kill": true,
            "rerun": true
        }
        ,
        "command": {
            "id": 128128536,
            "path": "/tmp/2018-02-13/2056/128128536",
            "status": "done",
            "created_at": "2018-02-13T07:27:43Z",
            "updated_at": "2018-02-13T07:27:58Z",
            "command_type": "HiveCommand",
            "progress": 100,
            .....
            "command": {
                "query": "show tables",
                "sample": false,
                ....
            }
        }
    },
    {
        "id": 6587685,
        "sequence_id": 3,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": null,
        "rerun_number": 1,
        ....
        ,
        "command": {
          ....
        }
    },
    {
        "id": 3460235,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": null,
        "rerun_number": 1,
        .....
        ,
        "command": {
           .....
        }
    },
    {
        "id": 3460233,
        "sequence_id": 1,
        "nominal_time": "2017-03-15T18:30:00Z",
        "is_rerun_of": null,
        "rerun_number": 1,
        ....
        ,
        "command": {
          ....
        }
    }
]
}

Example 2

Goal: View a schedule’s action to retrieve its reruns by providing Scheduler ID and Sequence ID.

curl -i -X GET -H "X-AUTH-TOKEN: $AUTH_TOKEN" \
-H "Accept: application/json" \
-H "Content-type: application/json" \
"https://api.qubole.com/api/v1.2/scheduler/16537/actions/2"

Note

The above syntax uses https://api.qubole.com as the endpoint. Qubole provides other endpoints to access QDS that are described in Supported Qubole Endpoints on Different Cloud Providers.

Response

For brevity, the JSON is truncated.

{
"paging_info": {
    "next_page": null,
    "previous_page": null,
    "per_page": 10
},
"actions": [
    {
        "id": 6587693,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": 6587682,
        "rerun_number": 5,
        "created_at": "2018-02-13T07:27:42Z",
        "query_hist_id": 128128536,
        "dependencies": {
            "found": [],
            "not_found": []
        },
        "done": true,
        "status": "done",
        "periodic_job_id": 16537,
        "perms": {
            "kill": true,
            "rerun": true
        },
        "command": {
          ....
        }
    },
    {
        "id": 6587685,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": 3460235,
        "rerun_number": 4,
        "created_at": "2018-02-13T07:22:49Z",
        "query_hist_id": 128127532,
        ....
        ,
        "command": {
          ....
        }
    },
    {
        "id": 6587682,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": 3460235,
        "rerun_number": 3,
        "created_at": "2018-02-13T07:20:27Z",
        "query_hist_id": 128127085,
        .....
        ,
        "command": {
          ....
        }
    },
    {
        "id": 6587667,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": 3460235,
        "rerun_number": 2,
        "created_at": "2018-02-13T07:18:15Z",
        "query_hist_id": 128126570,
        ....
        ,
        "command": {
          ....
        }
    },
    {
        "id": 3460235,
        "sequence_id": 2,
        "nominal_time": "2017-03-16T00:00:00Z",
        "is_rerun_of": null,
        "rerun_number": 1,
        "created_at": "2017-03-16T15:18:25Z",
        "query_hist_id": 61115891,
        ....
        ,
        "command": {
          ....
        }
    }
]
}