Deployments (Notebooks)

URL:
https://<root>/notebooks/deployments
Methods:
GET
Child Resources:
Deployment
Required Capability:
Access allowed with "Create and edit notebooks" privilege
Version Introduced:
11.4

Description

The deployments resource returns a list of Kubernetes deployment objects, and their properties, that are present in the cluster for a user. An administrator can view and manage notebook deployments that are owned by all users. Non-administrator organization members will only see the notebook deployments they own.

Request parameters

ParameterDetails

f

The response format. The default response format is html.

Values: htmlm| jsonm| pjson

Response properties

PropertyDetails

notebookRuntimeVersion

The version of the notebook runtime used for this notebook deployment.

notebookRuntimeName

The name of the notebook runtime used for this notebook deployment.

dateCreated

When the notebook deployment was created.

allowHiddenFileDownloads

By default, hidden files, files that have names starting with a dot (.), stored in a user's workspace cannot be downloaded using the data access download API. Set this property to true to allow the owner of those files to download them.

id

The ID of the notebook deployment in the site.

notebookRuntimeId

The ID of the notebook runtime used for this notebook deployment.

username

The user the notebook deployment is assigned to. Only one user can be assigned any given container.

Example usage

The following is a sample request URL used to access the deployments resource:

Use dark colors for code blocksCopy
1
https://organization.domain.com/context/admin/notebooks/deployments?f=pjson

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
  "nbDeployments": [
    {
      "privateUrl": "",
      "type": "openNotebook",
      "url": "/notebooks/fa80941bbca9404ab837c5967c80c07a",
      "notebookRuntimeVersion": "10.0",
      "revision": 1713915907561,
      "notebookRuntimeName": "ArcGIS Notebook Python 3 Advanced",
      "dateCreated": 1713915907560,
      "numNotebooks": 1,
      "deploymentId": "ktdqlmr8nyebm0qox7ivu",
      "id": "fa80941bbca9404ab837c5967c80c07a",
      "notebookRuntimeId": "7715c753-2be8-43ce-949d-9688279ebeb0",
      "username": "jane",
      "notebookToken": ""
    },
    {
      "privateUrl": "",
      "type": "openNotebook",
      "url": "/notebooks/6a2cec58844e4a0a8c2ab94e8c1e9590",
      "notebookRuntimeVersion": "10.0",
      "revision": 1713931004917,
      "notebookRuntimeName": "ArcGIS Notebook Python 3 Standard",
      "dateCreated": 1713931004916,
      "numNotebooks": 0,
      "deploymentId": "kf2371z89qln4q9e6ddkk",
      "id": "6a2cec58844e4a0a8c2ab94e8c1e9590",
      "notebookRuntimeId": "a0ae041c-d11a-4840-9b06-b11c8b1d0151",
      "username": "joe",
      "notebookToken": ""
    }
  ]
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.