Job

• URL:https://<notebookserveradmin>/system/jobs/<jobID>
  
• Required Capability:Administrator or Create and Edit ArcGIS Notebooks
• Version Introduced:10.7

Description

A job represents an asynchronous operation in ArcGIS Notebook Server. You can acquire progress information by querying the jobs resource.

Request parameters

Parameter	Details
f	The response format. The default response format is html. Values: html | json | pjson

Example usage

https://gisserver.domain.com:11443/arcgis/admin/system/jobs/jf9322f05-6b31-4bdd-8d42-be471fe904eb7?f=pjson

JSON Response syntax

Example 1

The following is a job response for the openNotebook operation:

{
  "jobId": "<jobId>",
  "inputs": {
    "itemId": "<itemId>"
  },
  "startTime": <start time in epoch milliseconds>,
  "endTime": <end time in epoch milliseconds>,
  // "results" is available when the job status is "COMPLETED" or "FAILED"
  "results": {
    "notebookUrl": "<notebookUrl>",
    "notebookId": "<notebookId>",
    "webToolVersion": <web tool version if exists>
  },
  "type": "openNotebook",
  "status": "SUBMITTED|PROCESSING|FAILED|COMPLETED",
  "username": "<username>",
  "customAttributes": {
    "openNotebook": "<notebookRuntimeId>",
    "isCancelled": true|false,
    // "openNotebookProgress" is available when the job status is "PROCESSING"
    "openNotebookProgress": {
      "message": "<message>",
      "percent": <progressValuePercentage>
    }
  }
}

Example 2

The following is a job response for the executeNotebook operation:

{
  "jobId": "<jobId>",
  "inputs": {
    "itemId": "<itemId>",
    "updatePortalItem": true|false,
    "saveInjectedParameters": true|false,
    "notebookParameters": "{\"parameter name 1\":\"parameter value 1\",\"parameter name 2\":\"parameter value2\"}",
    "executeJobUpdated": true|false
  },
  "startTime": <start time in epoch milliseconds>,
  "endTime": <end time in epoch milliseconds>,
  "results": {
    "containerConfigStoreId": "<containerConfigStoreId>"
  },
  "messages": [
    "<message1>",
    "<message2>",
    "<message3>",
    "<message4>",
    "<message5>"
  ],
  "type": "executeNotebook",
  "status": "SUBMITTED|PROCESSING|FAILED|COMPLETED",
  "username": "<username>",
  "customAttributes": {
    "isCancelled": true|false
  }
}

JSON Response examples

Job responses for the openNotebook operation

Example 1

The following is a job status response for an openNotebook request in the SUBMITTED state:

{
  "jobId": "jf9322f05-6b31-4bdd-8d42-be471fe904eb",
  "startTime": 1600418685508,
  "type": "openNotebook",
  "status": "SUBMITTED",
  "username": "admin",
  "customAttributes": {
    "isCancelled": false
  }
}

Example 2

The following is a job status response for an openNotebook request in the PROCESSING state:

{
  "jobId": "j52c9f6a4-2a7c-418f-a360-0ce757077342",
  "inputs": {
    "itemId": "c21213a381804c85935f50a1349a390f"
  },
  "startTime": 1600419767280,
  "type": "openNotebook",
  "results": {},
  "status": "PROCESSING",
  "username": "admin",
  "customAttributes": {
    "openNotebook": "994368e4-bfdc-49e4-abea-b1cddd80f952",
    "isCancelled": false,
    "openNotebookProgress": {
      "message": "Creating New Docker Container.",
      "percent": 50
    }
  }
}

Example 3

The following is a job status response for an openNotebook request in the COMPLETED state:

{
  "jobId": "j52c9f6a4-2a7c-418f-a360-0ce757077342",
  "inputs": {
    "itemId": "c21213a381804c85935f50a1349a390f"
  },
  "startTime": 1600419767280,
  "endTime": 1600419770042,
  "type": "openNotebook",
  "results": {
    "notebookUrl": "https://machine.domain.com/notebookserver/notebooks/4a491bea47864f91b4aee7ae2c4739e3/notebooks/c21213a381804c85935f50a1349a390f.ipynb",
    "notebookId": "0a465abc08ed4fe8ac087f204222fb02",
    "webToolVersion": "11.2"
  },
  "status": "COMPLETED",
  "username": "admin",
  "customAttributes": {
    "openNotebook": "994368e4-bfdc-49e4-abea-b1cddd80f952",
    "isCancelled": false
  }
}

Job response for the executeNotebook operation

Example 1

The following is a job status response for an executeNotebook request in the SUBMITTED state:

{
  "jobId": "j252e2b9a-4f35-4737-ad98-33465b3db57a",
  "startTime": 1600420355086,
  "type": "executeNotebook",
  "status": "SUBMITTED",
  "username": "admin",
  "customAttributes": {
    "isCancelled": false
  }
}

Example 2

The following is a job status response for an executeNotebook request in the PROCESSING state:

{
  "jobId": "j6185135c-92a8-4402-b8de-90a66dc61fcc",
  "inputs": {
    "itemId": "c21213a381804c85935f50a1349a390f",
    "updatePortalItem": true,
    "saveInjectedParameters": true,
    "notebookParameters": "{\"Abbr\":\"CA\",\"Name\":\"California\"}",
    "executeJobUpdated": false
  },
  "startTime": 1600419894050,
  "type": "executeNotebook",
  "results": {
    "containerConfigStoreId": "408119d098564c1c9c0448c31d1db32b"
  },
  "status": "PROCESSING",
  "username": "admin",
  "customAttributes": {
    "isCancelled": false
  }
}

Example 3

The following is a job status response for an executeNotebook request in the COMPLETED state:

{
  "jobId": "j6185135c-92a8-4402-b8de-90a66dc61fcc",
  "inputs": {
    "itemId": "c21213a381804c85935f50a1349a390f",
    "updatePortalItem": true,
    "saveInjectedParameters": true,
    "notebookParameters": "{\"Abbr\":\"CA\",\"Name\":\"California\"}",
    "executeJobUpdated": false
  },
  "messages": [
    "Input Notebook Path:  /arcgis/home/.tasks/j6185135c-92a8-4402-b8de-90a66dc61fcc/c21213a381804c85935f50a1349a390f.ipynb",
    "Output Notebook Path:  /arcgis/home/.tasks/j6185135c-92a8-4402-b8de-90a66dc61fcc/output.ipynb",
    "Start processing time: 2020-09-18 09:05:04.315161",
    "Finish processing time: 2020-09-18 09:05:35.189362",
    "Successfully completed."
  ],
  "startTime": 1600419894050,
  "endTime": 1600419939146,
  "type": "executeNotebook",
  "results": {
    "containerConfigStoreId": "408119d098564c1c9c0448c31d1db32b"
  },
  "status": "COMPLETED",
  "username": "admin",
  "customAttributes": {
    "isCancelled": false
  }
}