- URL:
- https://<notebookserveradmin>/notebooks/runtimes/
- Methods:
GET
- Operations:
- Register Runtime, Restore Factory Runtimes, Validate Runtimes
- Child Resources:
- Notebook Runtime
- Required Capability:
- Administrator or Create and Edit
- Version Introduced:
- 10.7
Description
This resource provides a list of the notebook runtimes that have been registered with your ArcGIS Notebook Server site.
There is one runtime included in each Docker container image, which is applied to a container at launch time. Notebook authors open ArcGIS Notebooks in their individual containers. The runtime included with the container image makes a precise collection of Python modules available to each notebook in the container.
By default, there are two runtimes for ArcGIS Notebook Server: ArcGI
and ArcGI
. These runtimes are loaded with their corresponding container images during ArcGIS Notebook Server installation, by running the postinstallation utility.
Request parameters
Parameter | Details |
---|---|
| The response format. The default is Values: |
JSON Response syntax
{
"currentRuntimeVersion": "<currentRuntimeVersion>",
"runtimes": [
{
"deprecationDate": <epoch time in milliseconds>,
"imageId": "<runtime1 imageId>",
"containerType": "<containerType>",
"imagePullString": "<imagePullString>",
"maxCpu": <maxCpu cores>,
"version": "<runtime1 version>",
"maxMemory": <maxMemory>,
"esriProvidedRuntime": true|false,
"dockerRuntime": "<dockerRuntime>",
"name": "<runtime1 name>",
"maxMemoryUnit": "<maxMemoryUnit>",
"maxSwapMemory": <maxSwapMemory>,
"maxSwapMemoryUnit": "<maxSwapMemoryUnit>",
"disabled": true|false,
"id": "runtime1 id",
"requiresAdvancedPrivileges": true|false,
"sharedMemorySizeUnit": "<sharedMemorySizeUnit>",
"sharedMemorySize": <sharedMemorySize>
},
{
"deprecationDate": <epoch time in milliseconds>,
"imageId": "<runtime2 imageId>",
"containerType": "<containerType>",
"imagePullString": "<imagePullString>",
"maxCpu": <maxCpu cores>,
"version": "<runtime2 version>",
"maxMemory": <maxMemory>,
"esriProvidedRuntime": true|false,
"dockerRuntime": "<dockerRuntime>",
"name": "<runtime2 name>",
"maxMemoryUnit": "<maxMemoryUnit>",
"maxSwapMemory": <maxSwapMemory>,
"maxSwapMemoryUnit": "<maxSwapMemoryUnit>",
"disabled": true|false,
"id": "runtime2 id",
"requiresAdvancedPrivileges": true|false,
"sharedMemorySizeUnit": "<sharedMemorySizeUnit>",
"sharedMemorySize": <sharedMemorySize>
}
]
}
JSON Response example
The following example demonstrates the response returned when the two default runtimes are loaded into the site:
{
"currentRuntimeVersion": "10.0",
"runtimes": [
{
"deprecationDate": 1796112000000,
"imageId": "fc46755b0a77cb7f6dadf6818cbea6545abdf2d4bcc58fd2ff9a805ee562c09",
"containerType": "docker",
"imagePullString": "",
"maxCpu": 2,
"version": "10.0",
"maxMemory": 6,
"esriProvidedRuntime": true,
"dockerRuntime": "",
"name": "ArcGIS Notebook Python 3 Standard",
"maxMemoryUnit": "g",
"maxSwapMemory": 0,
"maxSwapMemoryUnit": "g",
"disabled": false,
"id": "7897276e-dc36-4616-8874-7beaf6ff45d3",
"requiresAdvancedPrivileges": false,
"sharedMemorySizeUnit": "m",
"sharedMemorySize": 2048
},
{
"deprecationDate": 1796112000000,
"imageId": "fc46755b0a77cb7f6dadf6818cbea6545abdf2d4bcc58fd2ff9a805ee562c09",
"containerType": "docker",
"imagePullString": "",
"maxCpu": 2,
"version": "10.0",
"maxMemory": 6,
"esriProvidedRuntime": true,
"dockerRuntime": "",
"name": "ArcGIS Notebook Python 3 Advanced",
"maxMemoryUnit": "g",
"maxSwapMemory": 0,
"maxSwapMemoryUnit": "g",
"disabled": false,
"id": "bae2177f-4393-4201-b7af-5284f7b6cd1b",
"requiresAdvancedPrivileges": true,
"sharedMemorySizeUnit": "m",
"sharedMemorySize": 2048
}
]
}