Querying Details of a Notebook Instance
Function
This API is used to query details about a notebook instance, including its ID, name, flavor, image, status, and accessible URLs.
Constraints
None
URI
GET /v1/{project_id}/notebooks/{id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
id |
Yes |
String |
Notebook instance ID. |
project_id |
Yes |
String |
Project ID. For details, see Obtaining a Project ID. |
Request Parameters
None
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
action_progress |
Array of JobProgress objects |
Instance initialization progress. |
description |
String |
Instance description |
endpoints |
Array of EndpointsRes objects |
Local IDE (such as PyCharm and vsCode) or SSH client for remotely accessing a notebook instance through SSH. |
fail_reason |
String |
Instance failure cause |
feature |
String |
Instance type. Options:
|
flavor |
String |
Instance flavor |
id |
String |
Instance ID. |
image |
Image object |
Instance image |
lease |
Lease object |
Countdown to automatic instance stop. |
name |
String |
Instance name |
pool |
Pool object |
Basic information about the dedicated pool, which is returned by the instance created in the dedicated pool. |
status |
String |
Instance status Options:
|
token |
String |
Token used for notebook authentication |
url |
String |
URL for accessing the notebook instance |
volume |
VolumeRes object |
Storage volume |
workspace_id |
String |
Workspace ID. If no workspace is created, the default value is **0**. If a workspace is created and used, use the actual value. |
Parameter |
Type |
Description |
---|---|---|
notebook_id |
String |
Instance ID. |
status |
String |
Job status in a specified step. Options:
|
step |
Integer |
Job step. Options:
|
step_description |
String |
Description of a step in a job. |
Parameter |
Type |
Description |
---|---|---|
allowed_access_ips |
Array of strings |
Whitelist of public IP addresses that are allowed to access the notebook instance through SSH. By default, all public IP addresses can access the notebook instance. If this parameter is specified, only the clients with the specified IP addresses can access the notebook instance. |
dev_service |
String |
Supported services. Options:
|
ssh_keys |
Array of strings |
List of SSH key pairs. You can set multiple key pairs to access an SSH instance at the same time. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Image ID |
name |
String |
Image name. |
swr_path |
String |
SWR image address |
type |
String |
Image type. Options:
|
Parameter |
Type |
Description |
---|---|---|
create_time |
Long |
Time (UTC) when the instance is created, accurate to millisecond. |
duration |
Long |
Instance running duration, which is calculated based on the instance creation time. If the instance creation time plus the duration is greater than the current time, the system automatically stops the instance. |
enable |
Boolean |
Whether to enable auto stop of the instance. |
update_time |
Long |
Time (UTC) when the instance is last updated (excluding the keepalive heartbeat time), accurate to millisecond. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
ID of a dedicated resource pool |
name |
String |
Name of a dedicated resource pool |
Parameter |
Type |
Description |
---|---|---|
capacity |
Integer |
Storage capacity. The default value is 5 GB for EVS and 50 GB for EFS. The maximum value is 4,096 GB. |
category |
String |
Storage category. Options:
|
mount_path |
String |
Directory of the notebook instance to which OBS storage is mounted. Currently, the directory is /home/ma-user/work/. |
ownership |
String |
Owner to which the resource belongs. Options:
|
status |
String |
EVS disk capacity expansion status, which is RESIZING during capacity expansion and does not affect the instance. |
Example Requests
None
Example Responses
Status code: 200
OK
{ "create_at" : 1638778344314, "description" : "api-test", "endpoints" : [ { "service" : "NOTEBOOK", "uri" : "https://authoring-modelarts-cnnorth7.ulanqab.xxxx.com/f9937afa-631e-4a8f-a8f7-3b6c800585f0/lab" } ], "feature" : "NOTEBOOK", "flavor" : "modelarts.vm.cpu.2u", "id" : "f9937afa-631e-4a8f-a8f7-3b6c800585f0", "image" : { "arch" : "X86_64", "currentTag" : "3.3.1.B007_V2", "feature" : "DEFAULT", "id" : "e1a07296-22a8-4f05-8bc8-e936c8e54090", "name" : "notebook2.0-mul-kernel-cpu-cp36", "swr_path" : "swr.xxx.xxxx.com/atelier/notebook2.0-mul-kernel-cpu-cp36:3.3.1.B007_V2", "type" : "BUILD_IN" }, "lease" : { "create_at" : 1638778344300, "duration" : 3600000, "enable" : true, "update_at" : 1638778344300 }, "name" : "notebooks_test", "status" : "CREATE_FAILED", "token" : "7b22482a-a4cb-4b46-e3b3-6a793a47967e", "update_at" : 1638778346131, "url" : "https://authoring-modelarts-cnnorth7.ulanqab.xxxx.com/f9937afa-631e-4a8f-a8f7-3b6c800585f0/lab", "workspace_id" : "0" }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.