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

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

更新资源池节点自定义配置 - PatchNodeConfig

功能介绍

更新资源池节点自定义配置接口用于修改资源池节点的个性化设置。该接口适用于以下场景：当资源池节点需要调整资源分配策略、更新性能参数、创建/删除镜像预热任务或变更其他自定义配置时，用户可通过此接口更新指定资源池节点的自定义配置信息。使用该接口的前提条件是资源池节点已存在且用户具有管理员权限。更新操作完成后，资源池节点的自定义配置将被更新并生效，相关变更将被记录以便后续查询。若资源池节点不存在、用户无权限操作或配置参数格式不正确，接口将返回相应的错误信息。

调试

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

授权信息

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

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

URI

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

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

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
spec	是	spec object	参数解释：待更新的节点配置插件实例请求信息。约束限制：不涉及。

表3 spec
参数	是否必选	参数类型	描述
configs	否	configs object	参数解释：待更新的节点配置。支持镜像预热（image_warm_up）、CPU管理策略（cpu_manager）、缓存清理（drop_cache）、透明大页（transparent_hugepage）等配置项。约束限制：仅Dedicate（专属）资源池支持修改节点配置，非专属资源池调用将返回403。镜像预热配置仅在资源池机型为支持镜像预热的裸金属规格（Ascend 910B/910C）时可用。

表4 configs
参数	是否必选	参数类型	描述
image_warm_up	否	Array of image_warm_up objects	参数解释：镜像预热配置。用于创建或删除镜像预热任务，镜像会被提前拉取到资源池节点，缩短训练任务启动时间。约束限制：镜像预热任务数量上限为10；同一请求内任务名称不可重复、镜像地址不可重复；仅标准池支持，Lite资源池不支持该配置。取值范围：不涉及。默认取值：不涉及。
cpu_manager	否	cpu_manager object	参数解释：CPU管理策略配置，用于设置节点CPU的绑核管理方式。约束限制：不涉及。
drop_cache	否	drop_cache object	参数解释：节点缓存清理配置，用于定期清理节点内存缓存，释放内存空间。约束限制：不涉及。
transparent_hugepage	否	transparent_hugepage object	参数解释：透明大页（Transparent Hugepage，THP）配置，用于设置节点内存大页策略。约束限制：不涉及。

表5 image_warm_up
参数	是否必选	参数类型	描述
id	否	String	参数解释：镜像预热任务ID。约束限制：选填。新增任务时无需填写，系统自动生成；格式为image-warm-up-task-[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]。删除已有任务时必须填写，通过id标识区分。取值范围：不涉及。默认取值：不涉及。
name	否	String	参数解释：镜像预热任务名称。约束限制：必填。由4~32位小写字母、数字或"-"组成，以字母开头、以字母或数字结尾；同一请求内任务名称不可重复。取值范围：不涉及。默认取值：不涉及。
creationTimestamp	否	String	参数解释：镜像预热任务的创建时间。约束限制：选填。新增任务时无需填写，系统自动填充为当前时间。取值范围：RFC3339格式时间，例如2026-08-14T19:53:27+08:00。默认取值：不涉及。
type	否	String	参数解释：镜像类型。约束限制：必填。指定镜像的来源类型。取值范围：可选值如下： SWR：华为云容器镜像服务。默认取值：不涉及。
image	否	String	参数解释：需要预热的镜像地址，例如swr.xxx.com/namespace/repository:v1.0。约束限制：必填。同一请求内镜像地址不可重复。取值范围：不涉及。默认取值：不涉及。

表6 cpu_manager
参数	是否必选	参数类型	描述
mode	否	String	参数解释：CPU管理策略模式。约束限制：不涉及。取值范围：可选值如下： static：静态绑核。 none：不绑定。默认取值：不涉及。

表7 drop_cache
参数	是否必选	参数类型	描述
mode	否	String	参数解释：缓存清理开关。约束限制：不涉及。取值范围：可选值如下： enable：启用。 disable：禁用。默认取值：不涉及。

表8 transparent_hugepage
参数	是否必选	参数类型	描述
mode	否	String	参数解释：透明大页模式。约束限制：不涉及。取值范围：可选值如下： always：始终启用。 madvise：建议启用。 never：不启用。默认取值：不涉及。

响应参数

状态码：200

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

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

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

**表12** 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	参数解释：透明大页配置。取值范围：不涉及。

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

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

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

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

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

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

**表19** 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

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

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

请求示例

更新资源池节点自定义配置，添加镜像预热任务。设置资源池名称为"pool-001"，在节点配置中新增和保留多个镜像预热任务。其中 warmup-task-new 为新增任务（无需填写 id 和 creationTimestamp），warmup-task-1 为保留的已有任务。

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

{
  "spec" : {
    "configs" : {
      "image_warm_up" : [ {
        "name" : "warmup-task-1",
        "id" : "image-warm-up-task-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "type" : "SWR",
        "image" : "swr.xxx.com/namespace/repository-1:v1.0",
        "creationTimestamp" : "2026-09-13T18:31:58+08:00"
      }, {
        "name" : "warmup-task-new",
        "type" : "SWR",
        "image" : "swr.xxx.com/namespace/repository-2:v2.0"
      } ]
    }
  }
}

响应示例

无

状态码

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

错误码

请参见错误码。

父主题： 资源池管理

上一篇：查询资源池节点自定义配置 - ShowPoolNodeConfig

下一篇：查询资源池网络拓扑 - ShowPoolNetworkTopology