文档首页/ AI开发平台ModelArts/ API参考/ 资源管理/ 查询资源池节点自定义配置
更新时间:2025-10-11 GMT+08:00
分享

查询资源池节点自定义配置

功能介绍

查询资源池节点自定义配置接口用于获取指定资源池节点的自定义配置信息。该接口适用于以下场景:当需要查看资源池节点的详细配置、优化资源分配或管理节点资源时,用户可通过此接口获取节点的自定义配置数据。使用该接口的前提条件是资源池节点已存在且用户具有访问该节点的权限。调用接口成功后,系统将返回资源池节点的自定义配置信息,包括硬件规格、软件环境、网络设置等详细参数。若资源池节点不存在、用户无权限访问或节点配置信息未正确配置,接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/pools/{pool_name}/node-config

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

pool_name

String

参数解释:池名称。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

apiVersion

String

参数解释: 固定为v2。

取值范围: 不涉及。

kind

String

参数解释: 固定为NodeConfig。

取值范围: 不涉及。

metadata

NodeconfigMeta object

参数解释: 资源池节点的metadata信息。

spec

NodeconfigSpec object

参数解释: 资源池节点的规格信息。

status

NodeconfigStatus object

参数解释: 资源池节点的状态信息。

表3 NodeconfigMeta

参数

参数类型

描述

name

String

参数解释: 固定为node-config。

取值范围: 不涉及。

表4 NodeconfigSpec

参数

参数类型

描述

configs

Object

参数解释: 节点自定义配置;当前支持节点绑核、是否启用缓存清理、是否启用透明大页。

"configs": {

"cpu_manager": {

"mode": "static/none" //static为启用绑核, none为不启用绑核

},

"drop_cache": {

"mode": "enable/disable" // enable启用缓存清理

},

"transparent_hugepage": {

"mode": "always/madvise/never" // always为启用透明大页,never为关闭透明大页,madvice交给系统选择。

}

}

表5 NodeconfigStatus

参数

参数类型

描述

phase

String

参数解释: 插件实例的状态。

取值范围: 可选值如下:

  • Pending:安装中,表示插件正在安装中。

  • Running:运行中,表示插件全部实例状态都在运行中,插件正常使用。

  • Updating:升级中,表示插件正在更新中。

  • Abnormal:不可用,表示插件状态异常,插件不可使用。可单击状态查看失败原因。

  • Deleting:删除中,表示插件正在删除中。

状态码:400

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码

状态码

描述

200

节点自定义配置

400

Error response

错误码

请参见错误码

相关文档