文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 专属资源池和轻量算力集群管理/ 资源池管理/ 查询资源池节点自定义配置 - ShowPoolNodeConfig

更新时间：2026-10-22 GMT+08:00

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

功能介绍

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：用户项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
pool_name	是	String	参数解释：池名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Header参数
参数	参数类型	描述
X-request-id	String	This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

表3 响应Body参数
参数	参数类型	描述
apiVersion	String	参数解释：固定为v2。取值范围：不涉及。
kind	String	参数解释：固定为NodeConfig。取值范围：不涉及。
metadata	NodeconfigMeta object	参数解释：资源池节点的metadata信息。
spec	NodeconfigSpec object	参数解释：资源池节点的规格信息。
status	NodeconfigStatus object	参数解释：资源池节点的状态信息。

表4 NodeconfigMeta
参数	参数类型	描述
name	String	参数解释：固定为node-config。取值范围：不涉及。

表5 NodeconfigSpec
参数	参数类型	描述
configs	configs object	参数解释：节点自定义配置；当前支持节点绑核（cpu_manager）、缓存清理（drop_cache）、透明大页（transparent_hugepage）和镜像预热（image_warm_up）。取值范围：不涉及。

表6 configs
参数	参数类型	描述
image_warm_up	Array of image_warm_up objects	参数解释：镜像预热任务配置列表。取值范围：不涉及。
cpu_manager	cpu_manager object	参数解释：CPU管理策略配置。取值范围：不涉及。
drop_cache	drop_cache object	参数解释：节点缓存清理配置。取值范围：不涉及。
transparent_hugepage	transparent_hugepage object	参数解释：透明大页配置。取值范围：不涉及。

表7 image_warm_up
参数	参数类型	描述
id	String	参数解释：镜像预热任务ID。取值范围：不涉及。
name	String	参数解释：镜像预热任务名称。取值范围：不涉及。
creationTimestamp	String	参数解释：镜像预热任务的创建时间。取值范围：RFC3339格式时间。
type	String	参数解释：镜像类型。取值范围：SWR。
image	String	参数解释：需要预热的镜像地址。取值范围：不涉及。

表8 cpu_manager
参数	参数类型	描述
mode	String	参数解释：CPU管理策略模式。取值范围：static、none。

表9 drop_cache
参数	参数类型	描述
mode	String	参数解释：缓存清理开关。取值范围：enable、disable。

**表10** transparent_hugepage
参数	参数类型	描述
mode	String	参数解释：透明大页模式。取值范围：always、madvise、never。

**表11** NodeconfigStatus
参数	参数类型	描述
phase	String	参数解释：节点配置的执行状态。取值范围：可选值如下： Pending：安装中，表示插件正在安装中。 Running：运行中，表示插件全部实例状态都在运行中，插件正常使用。 Updating：升级中，表示插件正在更新中。 Abnormal：不可用，表示插件状态异常，插件不可使用。可单击状态查看失败原因。 Deleting：删除中，表示插件正在删除中。
configsStatus	configsStatus object	参数解释：各配置项的执行状态。取值范围：不涉及。

**表12** configsStatus
参数	参数类型	描述
image_warm_up	image_warm_up object	参数解释：镜像预热任务的执行状态。取值范围：不涉及。

**表13** image_warm_up
参数	参数类型	描述
state	String	参数解释：镜像预热任务的整体状态。取值范围：可选值如下： Success：全部成功，所有镜像在所有节点上均预热成功。 Failed：全部失败，所有镜像在所有节点上均预热失败。 Pulling：预热中，镜像正在被拉取。 PartialCompletion：部分完成，部分镜像成功、部分失败或部分节点成功。 Unknown：未知状态，解析节点上报数据异常。
message	String	参数解释：镜像预热任务的详细结果信息（JSON 格式字符串），包含以下字段： successfulImages：预热成功的镜像列表 failedImages：预热失败的镜像列表 partialSuccess：部分节点成功的镜像列表 pendingImages：尚未完成预热的镜像列表 additionalInfos：失败原因等附加信息（如镜像不存在、拉取超时、拉取失败、镜像仓库中manifest不存在） successfulImagesConfig：成功镜像的配置详情（id、name、creationTimestamp、type、image） failedImagesConfig：失败镜像的配置详情 partialSuccessConfig：部分成功镜像的配置详情 pendingImagesConfig：待预热镜像的配置详情取值范围：不涉及。

状态码：400

**表14** 响应Header参数
参数	参数类型	描述
X-request-id	String	This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname.

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误描述

请求示例

GET https://{endpoint}/v2/{project_id}/pools/{pool_name}/node-config

响应示例

状态码：200

{
  "apiVersion" : "v2",
  "kind" : "NodeConfig",
  "metadata" : {
    "name" : "node-config"
  },
  "spec" : {
    "configs" : {
      "cpu_manager" : {
        "mode" : "static"
      },
      "drop_cache" : {
        "mode" : "disable"
      },
      "transparent_hugepage" : {
        "mode" : "always"
      },
      "image_warm_up" : [ {
        "creationTimestamp" : "2026-08-14T19:53:27+08:00",
        "id" : "image-warm-up-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "image" : "swr.xxx.com/namespace/repository:v1.0",
        "name" : "warmup-task-1",
        "type" : "SWR"
      } ]
    }
  },
  "status" : {
    "phase" : "Running",
    "configsStatus" : {
      "image_warm_up" : {
        "state" : "Success",
        "message" : "{\n  \"successfulImages\": [\"swr.xxx.com/namespace/repository:v1.0\"],\n  \"failedImages\": [],\n  \"successfulImagesConfig\": [\n    {\"id\": \"image-warm-up-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\", \"name\": \"warmup-task-1\", \"creationTimestamp\": \"2026-08-14T19:53:27+08:00\", \"type\": \"SWR\", \"image\": \"swr.xxx.com/namespace/repository:v1.0\"}\n  ]\n}"
      }
    }
  }
}

状态码

状态码	描述
200	节点自定义配置
400	Error response

错误码

请参见错误码。

父主题： 资源池管理

上一篇：资源池统计 - ShowPoolStatistics

下一篇：更新资源池节点自定义配置 - PatchNodeConfig