Resource URL: /platform/<<version=3>>/job/events

    Overview: This resource applies the standard collection pattern to job
              events.

     Methods: GET

********************************************************************************

Method GET: List job events.

       URL: GET /platform/<<version=3>>/job/events

Query arguments:
timeout_ms=<integer> Query timeout in milliseconds. The default is 10000 ms.
       end=<integer> Restrict the query to events before the given time, in
                     seconds since the Epoch.
    job_id=<integer> Restrict the query to the given job ID.
     resume=<string> Continue returning results from previous call using this
                     token (token should come from the previous call, resume
                     cannot be used with other options).
   job_type=<string> Restrict the query to the given job type.
     begin=<integer> Restrict the query to events at or after the given time,
                     in seconds since the Epoch.
        state=<enum> Where <enum> is one of running, paused_user,
                     paused_system, paused_policy, paused_priority,
                     cancelled_user, cancelled_system, failed, succeeded,
                     unknown.  Restrict the query to events containing the
                     given state.
     limit=<integer> Return no more than this many results at once (see resume).
        key=<string> Restrict the query to the given key name.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "total": {
      "type": "integer", 
      "description": "Total number of items available."
    }, 
    "events": {
      "items": {
        "type": "object", 
        "properties": {
          "job_id": {
            "minimum": 1, 
            "type": "integer", 
            "description": "Job ID.", 
            "required": true
          }, 
          "job_type": {
            "required": true, 
            "type": "string", 
            "description": "Job Type."
          }, 
          "value": {
            "required": true, 
            "type": "string", 
            "description": "Event value."
          }, 
          "flags": {
            "required": true, 
            "type": "string", 
            "description": "Event flags."
          }, 
          "key": {
            "required": true, 
            "type": "string", 
            "description": "Event key name."
          }, 
          "time": {
            "required": true, 
            "type": "integer", 
            "description": "Time of event in Unix epoch seconds."
          }, 
          "phase": {
            "required": true, 
            "type": "integer", 
            "description": "Job phase number at time of event."
          }, 
          "id": {
            "required": true, 
            "type": "string", 
            "description": "Job event ID."
          }
        }
      }, 
      "type": "array"
    }, 
    "resume": {
      "type": [
        "string", 
        "null"
      ], 
      "description": "Continue returning results from previous call using this token (token should come from the previous call, resume cannot be used with other options)."
    }
  }
}
