# 获取用户所属空间的notebook列表 - ListUserNotebook #### 功能介绍 获取用户所属空间的notebook列表。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0100.html)。 #### URI GET /v1/{project_id}/eihealth-projects/notebooks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0033.html)中获取。 **约束限制**： 不涉及 **取值范围**： 只能由英文字母、数字、中划线和下划线组成，且长度为\[1-128\]的字符。 **默认取值**： 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | notebook_name | 否 | String | **参数解释**： notebook名称。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-200\]的字符。 **默认取值**： 不涉及 | | description | 否 | String | **参数解释**： notebook描述信息。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-200\]的字符。 **默认取值**： 不涉及 | | image_name | 否 | String | **参数解释**： 镜像名称。 **约束限制**： 不涉及 **取值范围**： 长度\[1-256\]的字符。 **默认取值**： 不涉及 | | is_creator | 否 | Boolean | **参数解释**： 是否仅展示当前用户创建的notebook。 **约束限制**： 不涉及 **取值范围**： - true：仅展示当前用户创建的notebook - false：展示所有用户创建的notebook **默认取值**： true | | eihealth_project_names | 否 | Array of strings | **参数解释**： 空间名称列表。 **约束限制**： 列表长度为\[0-10\]，每个元素为长度\[1-512\]的字符。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | statuses | 否 | Array of strings | **参数解释**： 作业运行状态列表。 **约束限制**： 数组长度\[0-11\]，数组元素为长度\[1-16\]的字符。 **取值范围**： - RUNNING：运行中 - ABNORMAL：异常 - HIBERNATE：停止 - SUCCEEDED：成功 - CREATING：创建中 - DELETING：删除中 - UPDATING：更新中 - CREATEDFAILED：创建失败 - DELETEDFAILED：删除失败 - UPDATEDFAILED：更新失败 - UNKNOWN：未知 **默认取值**： 不涉及 | | start_create_time | 否 | Long | **参数解释**： 最小创建时间，用于时间范围过滤。 **约束限制**： 不涉及 **取值范围**： 整数，范围1000000000000-9999999999999。 **默认取值**： 不涉及 | | end_create_time | 否 | Long | **参数解释**： 最大创建时间，用于时间范围过滤。 **约束限制**： 不涉及 **取值范围**： 整数，范围1000000000000-9999999999999。 **默认取值**： 不涉及 | | start_update_time | 否 | Long | **参数解释**： 最小更新时间，用于时间范围过滤。 **约束限制**： 不涉及 **取值范围**： 整数，范围1000000000000-9999999999999。 **默认取值**： 不涉及 | | end_update_time | 否 | Long | **参数解释**： 最大更新时间，用于时间范围过滤。 **约束限制**： 不涉及 **取值范围**： 整数，范围1000000000000-9999999999999。 **默认取值**： 不涉及 | | sort_dir | 否 | String | **参数解释**： 排序规则，目前默认时间降序。 **约束限制**： 不涉及 **取值范围**： - DESC：降序 - ASC：升序 **默认取值**： DESC | | sort_by | 否 | String | **参数解释**： 排序规则，默认更新时间降序，支持根据create_time，update_time排序。 **约束限制**： 不涉及 **取值范围**： - create_time：按照创建时间排序 - update_time：按照更新时间排序 **默认取值**： update_time | | limit | 否 | Integer | **参数解释**： 限制量，单次查询总量。 **约束限制**： 不涉及 **取值范围**： 整数，范围1-1000 **默认取值**： 100 | | offset | 否 | Integer | **参数解释**： 偏移量，查询起始偏移。 **约束限制**： 不涉及 **取值范围**： 整数，范围0-100000000。 **默认取值**： 0 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0011.html)接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]的字符。 **默认取值**： 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | count | Integer | **参数解释**： notebook总数。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | notebooks | Array of [NotebookBaseInfo] objects | **参数解释**： notebook详情列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表5NotebookBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： notebook ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | name | String | **参数解释**： notebook名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | eihealth_project_id | String | **参数解释**： 空间ID，您可以从[获取空间ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0099.html)中获取。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | eihealth_project_name | String | **参数解释**： 空间名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | description | String | **参数解释**： notebook描述。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | creator | String | **参数解释**： notebook所属用户。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | url | String | **参数解释**： notebook访问URL。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | flavor | [FlavorInfo] object | **参数解释**： notebook规格。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | status | String | **参数解释**： notebook状态。 **约束限制**： 不涉及 **取值范围**： - RUNNING：运行中 - ABNORMAL：异常 - HIBERNATE：停止 - SUCCEEDED：成功 - CREATING：创建中 - DELETING：删除中 - UPDATING：更新中 - CREATEDFAILED：创建失败 - DELETEDFAILED：删除失败 - UPDATEDFAILED：更新失败 - UNKNOWN：未知 **默认取值**： 不涉及 | | image | [NotebookImage] object | **参数解释**： notebook镜像信息。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | create_time | String | **参数解释**： notebook创建时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | update_time | String | **参数解释**： notebook更新时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | failed_message | String | **参数解释**： notebook失败信息。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表6FlavorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cpu_type | String | **参数解释**： cpu架构类型。 **约束限制**： 不涉及 **取值范围**： - X86: X86架构 - ARM：ARM架构 **默认取值**： X86 | | cpu | Float | **参数解释**： notebook占用的cpu， 0.1核为100m，单位为"C"。 **约束限制**： 不涉及 **取值范围**： 1-128之间的浮点数。 **默认取值**： 1 | | gpu | Float | **参数解释**： notebook占用的gpu，0.1为使用单卡10%，1为占满单个显卡，1+为使用多个显卡。 **约束限制**： 不涉及 **取值范围**： 0-16之间的浮点数。 **默认取值**： 0 | | gpu_type | String | **参数解释**： gpu架构类型。 **约束限制**： 不涉及 **取值范围**： - GPU：支持GPU - Snt9：支持Snt9 **默认取值**： 不涉及 | | memory | Float | **参数解释**： notebook占用的内存，单位为"G"。 **约束限制**： 不涉及 **取值范围**： 范围\[2-512\]。 **默认取值**： 2 | 表7NotebookImage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | image_type | String | **参数解释**： 镜像类型。 **约束限制**： 不涉及 **取值范围**： - SYSTEM：系统预置 - CUSTOMER：自定义 **默认取值**： 不涉及 | | image_info | [ImageInfo] object | **参数解释**： 镜像信息。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表8ImageInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | source_project_name | String | **参数解释**： 源空间名。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-128\]的字符。 **默认取值**： 不涉及 | | image_name | String | **参数解释**： 镜像名。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-128\]的字符，支持小写字母、数字、中划线(-)、下划线(_)、点(.)和斜杠(/)。 **默认取值**： 不涉及 | | image_tag | String | **参数解释**： 镜像tag名。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-64\]的字符，支持大小写字母、数字、中划线(-)、下划线(_)、点(.)和斜杠(/)。 **默认取值**： 不涉及 | | profile | String | **参数解释**： 系统镜像名。 **约束限制**： 不涉及 **取值范围**： 仅支持PY3 **默认取值**： 不涉及 | #### 请求示例 获取用户所属空间的notebook列表。 ``` https://{endpoint}/v1/{project_id}/eihealth-projects/notebooks ``` #### 响应示例 **状态码：200** OK ``` { "count" : 1, "notebooks" : [ { "id" : "DE-7d558ef8-c73d-11ea-964c-0255ac100033", "name" : "notebook-example", "description" : "notebook description in here", "eihealth_project_id" : "project-id", "eihealth_project_name" : "demo-project", "creator" : "notebook_creator", "flavor" : { "cpu" : "1", "gpu" : "0", "memory" : "100" }, "status" : "Running", "image" : { "image_type" : "SYSTEM", "image_info" : { "source_project_name" : "eihealth-project", "image_name" : "eihealth-notebook", "image_tag" : "3.1.0-latest", "profile" : "PY3" } }, "create_time" : "2020-09-10T10:07:17Z", "update_time" : "2020-09-10T10:07:17Z", "failed_message" : "failed massage in here" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ai4sservice/ErrorCode.html)。