# 更新资源池节点自定义配置 - PatchNodeConfig #### 功能介绍 更新资源池节点自定义配置接口用于修改资源池节点的个性化设置。该接口适用于以下场景：当资源池节点需要调整资源分配策略、更新性能参数、创建/删除镜像预热任务或变更其他自定义配置时，用户可通过此接口更新指定资源池节点的自定义配置信息。使用该接口的前提条件是资源池节点已存在且用户具有管理员权限。更新操作完成后，资源池节点的自定义配置将被更新并生效，相关变更将被记录以便后续查询。若资源池节点不存在、用户无权限操作或配置参数格式不正确，接口将返回相应的错误信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=PatchNodeConfig)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI PATCH /v2/{project_id}/pools/{pool_name}/node-config 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | pool_name | 是 | String | **参数解释**：池名称。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | spec | 是 | [spec] object | **参数解释**：待更新的节点配置插件实例请求信息。 **约束限制**：不涉及。 | 表3spec | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | configs | 否 | [configs] object | **参数解释**：待更新的节点配置。支持镜像预热（image_warm_up）、CPU管理策略（cpu_manager）、缓存清理（drop_cache）、透明大页（transparent_hugepage）等配置项。 **约束限制**：仅Dedicate（专属）资源池支持修改节点配置，非专属资源池调用将返回403。镜像预热配置仅在资源池机型为支持镜像预热的裸金属规格（Ascend 910B/910C）时可用。 | 表4configs | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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）配置，用于设置节点内存大页策略。 **约束限制**：不涉及。 | 表5image_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。 **约束限制**：必填。同一请求内镜像地址不可重复。 **取值范围**：不涉及。 **默认取值**：不涉及。 | 表6cpu_manager | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mode | 否 | String | **参数解释**：CPU管理策略模式。 **约束限制**：不涉及。 **取值范围**：可选值如下： - static：静态绑核。 - none：不绑定。 **默认取值**：不涉及。 | 表7drop_cache | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mode | 否 | String | **参数解释**：缓存清理开关。 **约束限制**：不涉及。 **取值范围**：可选值如下： - enable：启用。 - disable：禁用。 **默认取值**：不涉及。 | 表8transparent_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 | **参数解释**：资源池节点的状态信息。 | 表10NodeconfigMeta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**：固定为node-config。 **取值范围**：不涉及。 | 表11NodeconfigSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | configs | [configs] object | **参数解释**：节点自定义配置；当前支持节点绑核（cpu_manager）、缓存清理（drop_cache）、透明大页（transparent_hugepage）和镜像预热（image_warm_up）。 **取值范围**：不涉及。 | 表12configs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释**：透明大页配置。 **取值范围**：不涉及。 | 表13image_warm_up | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**：镜像预热任务ID。 **取值范围**：不涉及。 | | name | String | **参数解释**：镜像预热任务名称。 **取值范围**：不涉及。 | | creationTimestamp | String | **参数解释**：镜像预热任务的创建时间。 **取值范围**：RFC3339格式时间。 | | type | String | **参数解释**：镜像类型。 **取值范围**：SWR。 | | image | String | **参数解释**：需要预热的镜像地址。 **取值范围**：不涉及。 | 表14cpu_manager | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释**：CPU管理策略模式。 **取值范围**：static、none。 | 表15drop_cache | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释**：缓存清理开关。 **取值范围**：enable、disable。 | 表16transparent_hugepage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释**：透明大页模式。 **取值范围**：always、madvise、never。 | 表17NodeconfigStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | phase | String | **参数解释**：节点配置的执行状态。 **取值范围**：可选值如下： - Pending：安装中，表示插件正在安装中。 - Running：运行中，表示插件全部实例状态都在运行中，插件正常使用。 - Updating：升级中，表示插件正在更新中。 - Abnormal：不可用，表示插件状态异常，插件不可使用。可单击状态查看失败原因。 - Deleting：删除中，表示插件正在删除中。 | | configsStatus | [configsStatus] object | **参数解释**：各配置项的执行状态。 **取值范围**：不涉及。 | 表18configsStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | image_warm_up | [image_warm_up] object | **参数解释**：镜像预热任务的执行状态。 **取值范围**：不涉及。 | 表19image_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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。