# 更新资源池 - PatchPool
#### 功能介绍
更新资源池接口用于修改指定资源池的配置和容量。该接口适用于以下场景：当资源池需要扩展容量、调整配置或优化性能时，用户可通过此接口更新资源池的相关信息。使用该接口的前提条件是资源池已存在且用户具有管理员权限。更新操作完成后，资源池的配置和容量将被更新，相关资源和配置也将被调整。若资源池不存在、用户无权限操作或资源池处于不可更新状态，接口将返回相应的错误信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=PatchPool)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                   | 访问级别  | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | modelarts:pool:update | Write | pool \*     | g:ResourceTag/\<tag-key\> | -  | -      |
  | modelarts:pool:update | Write | -           | g:EnterpriseProjectId     | -  | -      |
     
  
 
#### URI
PATCH /v2/{project_id}/pools/{pool_name}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| pool_name  | 是    | String | **参数解释**：系统生成的资源池名称。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                                       |
   
#### 请求参数
表2请求Header参数 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| X-ModelArts-User-ID | 否    | String | **参数解释**：实际的外部租户ID，如果有的话，工作空间鉴权以该ID为准。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Content-Type        | 是    | String | **参数解释**：消息体的类型（格式）。 **约束限制**：不涉及。 **取值范围**：可选值如下： - application/merge-patch+json    **默认取值**：不涉及。 |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型                                                                                                                | 描述                       |
|:---|:---|:---|:---|
| metadata | 否    | [PoolMetadataUpdate] object | **参数解释**：资源池的metadata信息。 |
| spec     | 否    | [PoolSpecUpdate] object         | **参数解释**：资源池的描述信息。       |
   
 表4PoolMetadataUpdate 
| 参数          | 是否必选 | 参数类型                                                                                                  | 描述                 |
|:---|:---|:---|:---|
| annotations | 否    | [annotations] object | **参数解释**：资源池的注释信息。 |
   
 表5annotations 
| 参数                       | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| os.modelarts/description | 否    | String | **参数解释**：资源池描述信息，用于说明资源池用于某种指定场景。不能包含特殊字符!\<\>=\&"'。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| os.modelarts/order.id    | 否    | String | **参数解释**：订单id，包周期创建和变更的时候需要传递该参数。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。                    |
   
 表6PoolSpecUpdate 
| 参数         | 是否必选 | 参数类型                                                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| scope      | 否    | Array of strings                                                                                            | **参数解释**：更新启用的作业类型。 **约束限制**：不涉及。 **取值范围**：可选值如下： - Train：训练作业   - Infer：推理作业   - Notebook：Notebook作业    **默认取值**：不涉及。 |
| resources  | 否    | Array of [resources] objects | **参数解释**：更新的资源规格列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| jobFlavors | 否    | Array of strings                                                                                            | **参数解释**：资源池支持的作业规格信息列表。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| driver     | 否    | [PoolDriver] object         | **参数解释**：资源池驱动信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表7resources 
| 参数     | 是否必选 | 参数类型                                                                                                          | 描述                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| flavor | 是    | String                                                                                                        | **参数解释**：资源规格。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。      |
| count  | 是    | Integer                                                                                                       | **参数解释**：相应规格的资源数量。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| azs    | 否    | Array of [PoolNodeAz] objects | **参数解释**：更新的AZ列表。                                                                                                                                                                                                                                                                                    |
   
 表8PoolNodeAz 
| 参数    | 是否必选 | 参数类型    | 描述                                                                                                              |
|:---|:---|:---|:---|
| az    | 是    | String  | **参数解释**：可用区名称。 **取值范围**：不涉及。      |
| count | 是    | Integer | **参数解释**：可用区资源实例的数量。 **取值范围**：不涉及。 |
   
 表9PoolDriver 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| gpuVersion     | 否    | String | **参数解释**：资源池默认的GPU驱动版本。物理资源池中包含GPU规格时有效。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| npuVersion     | 否    | String | **参数解释**：资源池默认的NPU驱动版本。物理资源池中包含NPU规格时有效。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| updateStrategy | 否    | String | **参数解释**：资源池驱动升级策略。 **取值范围**：可选值如下： - force：强制升级，立即升级节点驱动，可能影响节点上正在运行的作业。   - idle：安全升级，待节点上没有作业运行时进行驱动升级。    |
   
#### 响应参数
**状态码：200**
表10响应Body参数 
| 参数         | 参数类型                                                                                                       | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| apiVersion | String                                                                                                     | **参数解释**：资源的API版本。 **取值范围**：可选值如下： - v2：当前资源版本为v2。    |
| kind       | String                                                                                                     | **参数解释**：资源的类型。 **取值范围**：可选值如下： - Pool：资源池。           |
| metadata   | [PoolMetadata] object   | **参数解释**：资源池的元信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| spec       | [PoolSpecModel] object | **参数解释**：资源池的规格信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| status     | [PoolStatus] object       | **参数解释**：资源池的状态信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表11PoolMetadata 
| 参数                | 参数类型                                                                                                                   | 描述                                                                                                                                     |
|:---|:---|:---|
| name              | String                                                                                                                 | **参数解释**：资源池的ID。 **取值范围**：不涉及。                            |
| creationTimestamp | String                                                                                                                 | **参数解释**：资源池的创建时间。例如"2025-11-01T03:49:41Z"。 **取值范围**：不涉及。 |
| labels            | [PoolMetaLabels] object           | **参数解释**：资源池的标签信息。                                                                                                                     |
| annotations       | [PoolMetaAnnotations] object | **参数解释**：资源池的注释信息。                                                                                                                     |
   
 表12PoolMetaLabels 
| 参数                                 | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| os.modelarts/name                  | String | **参数解释**：资源池的显示名称。 **取值范围**：不涉及。                                                                                                                 |
| os.modelarts/workspace.id          | String | **参数解释** ：工作空间ID。获取方法请参见[查询工作空间列表](https://support.huaweicloud.com/api-modelarts/ListWorkspace.html#ZH-CN_TOPIC_0000002723741766)。 **取值范围**：不涉及。 |
| os.modelarts/node.prefix           | String | **参数解释**：自定义节点前缀，可选值。 **取值范围**：不涉及。                                                                                                              |
| os.modelarts/resource.id           | String | **参数解释**：资源计费使用的资源ID。 **取值范围**：不涉及。                                                                                                              |
| os.modelarts/tenant.domain.id      | String | **参数解释**：资源池所属的租户ID。 **取值范围**：不涉及。                                                                                                               |
| os.modelarts/tenant.project.id     | String | **参数解释**：资源池所属的租户项目ID。 **取值范围**：不涉及。                                                                                                             |
| os.modelarts/enterprise.project.id | String | **参数解释**：资源池所属的企业项目ID。 **取值范围**：0到36字节                                                                                                           |
| os.modelarts.pool/biz              | String | **参数解释**：资源池商业类型，public是公共池，private个人专属池。 **取值范围**：不涉及。                                                                                          |
| os.modelarts/create-from           | String | **参数解释**：资源池创建来源，比如admin-console，标记来自admin创建，console标记来自ma console。 **取值范围**：不涉及。                                                                |
| os.modelarts/nobilling             | String | **参数解释**：公共资源池、资源队列存在计费标签。 **取值范围**：不涉及。                                                                                                         |
| os.modelarts/order.name            | String | **参数解释**：上一次资源池关联的订单作业。 **取值范围**：不涉及。                                                                                                            |
| os.modelarts/region                | String | **参数解释**：资源池所属区域。 **取值范围**：不涉及。                                                                                                                  |
   
 表13PoolMetaAnnotations 
| 参数                                                | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| os.modelarts/description                          | String | **参数解释**：资源池描述信息，用于说明资源池用于某种指定场景。 **取值范围**: 0到100字节                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| os.modelarts/billing.mode                         | String | **参数解释**：计费模式。 **取值范围**：可选值如下： - 0：按需计费   - 1：包周期计费                                          |
| os.modelarts/period.num                           | String | **参数解释**：包周期资源池的订购周期。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| os.modelarts/period.type                          | String | **参数解释**：包周期资源池的订购类型。 **取值范围**：可选值如下： - 2：包月。   - 3：包年。                                      |
| os.modelarts/auto.renew                           | String | **参数解释**：包周期资源池的自动续费类型，仅在ModelArts页面新购开启自动续费时为有效值。 **取值范围**：可选值如下： - 0：不自动续费。   - 1：自动续费。    |
| os.modelarts/promotion.info                       | String | **参数解释**：用户在运营平台选择的折扣信息。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| os.modelarts/service.console.url                  | String | **参数解释**：购买包周期资源在订单支付完成后跳转地址。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| os.modelarts/order.id                             | String | **参数解释**：包周期资源池购买时传递的订单ID。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| os.modelarts/flavor.resource.ids                  | String | **参数解释**：包周期资源池中资源规格对应的资源ID。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| os.modelarts/tms.tags                             | String | **参数解释**：资源池上的资源标签。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| os.modelarts.pool/scheduler.queue.strategy        | String | **参数解释**：资源池调度队列的策略，用于定义任务调度的规则。 **取值范围**：枚举：FIFO、Range。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| os.modelarts.pool/subpools.count                  | String | **参数解释**：资源池包含的逻辑子池的数量。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| os.modelarts/tenant.domain.name                   | String | **参数解释**：资源池的租户账号 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| os.modelarts.pool/scope.external.dependency.train | String | **参数解释**：训练外部依赖标识 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表14PoolSpecModel 
| 参数               | 参数类型                                                                                                             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| type             | String                                                                                                           | **参数解释**：资源池类型。 **取值范围**：可选值如下： - Dedicate：物理资源池，独立的网络，支持网络打通，定制驱动，定制作业类型。   - Logical：逻辑资源池。没有独立的网络，不支持网络打通，资源池创建和扩缩容相较物理资源池更快。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| scope            | Array of strings                                                                                                 | **参数解释**：资源池支持的作业类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| resources        | Array of [resources] objects     | **参数解释**：资源池中的资源规格信列表，包括资源规格和相应规格的资源数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| containernetwork | [containernetwork] object | **参数解释**：k8s 容器网络。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| network          | [network] object                   | **参数解释**：资源池网络参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| jobFlavors       | Array of strings                                                                                                 | **参数解释**：资源池支持的作业规格列表。参数为作业规格名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| driver           | [PoolDriver] object             | **参数解释**：资源池驱动信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| controlMode      | Integer                                                                                                          | **参数解释**：资源池的受限状态。状态可以叠加，比如9代表转包周期受限和冻结状态。 **取值范围**：可选值如下： - 0：代表不受限   - 1：转包周期受限   - 2：规格变更受限   - 4：服务受限   - 8：冻结   - 16：公安冻结（不可退订）    |
   
 表15resources 
| 参数                 | 参数类型                                                                                                                 | 描述                                                                                                                               |
|:---|:---|:---|
| flavor             | String                                                                                                               | **参数解释**：资源规格ID。 **取值范围**：不涉及。                      |
| count              | Integer                                                                                                              | **参数解释**：资源池中资源规格实例数量。 **取值范围**：不涉及。                |
| maxCount           | Integer                                                                                                              | **参数解释**：资源规格的弹性资源量。物理池中该值和count必须一致。 **取值范围**：不涉及。 |
| azs                | Array of [PoolNodeAz] objects       | **参数解释**：资源池中期望创建的资源规格实例的az分布。                                                                                                   |
| extendParams       | [extendParams] object             | **参数解释**：资源池自定义配置参数。                                                                                                             |
| os                 | [Os] object                                 | **参数解释**：资源池中节点操作系统镜像信息。                                                                                                         |
| dataVolumes        | [dataVolumes] object               | **参数解释**：自定义数据盘（云硬盘）列表信息，指定后不可修改。                                                                                                |
| volumeGroupConfigs | [volumeGroupConfigs] object | **参数解释**：磁盘高级配置信息。                                                                                                               |
   
 表16extendParams 
| 参数             | 参数类型   | 描述                                                                                                                                 |
|:---|:---|:---|
| dockerBaseSize | String | **参数解释**：资源池创建的节点的容器引擎空间大小。值为0时表示不限制大小。 **取值范围**：不涉及。 |
| volumeGroup    | String | **参数解释**：磁盘分组名称。 **取值范围**：不涉及。                        |
| runtime        | String | **参数解释**：模型运行时环境。 **取值范围**：不涉及。                       |
   
 表17Os 
| 参数        | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| name      | String | **参数解释**：操作系统名称和版本，如EulorOS 2.5。指定私有镜像时可不指定。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| imageId   | String | **参数解释**：操作系统镜像id。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| imageType | String | **参数解释**：操作系统镜像类型。设置私有镜像时必须指定。默认为预置镜像，无需指定该字段。 **取值范围**：可选值如下： - private：私有镜像   - ""：不指定类型即预置镜像。    |
| autoMatch | String | **参数解释**：操作系统镜像自动匹配配置。当配置该参数时将会自动选择最优镜像，同时该参数会自动清空。 **取值范围**：操作系统名称和版本，如EulorOS 2.5。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表18dataVolumes 
| 参数           | 参数类型                                                                                           | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| volumeType   | String                                                                                         | **参数解释**：磁盘类型，具体内容可参考磁盘类型及性能介绍。 **取值范围**：可选值如下： - SSD：超高IO硬盘   - GPSSD：通用型SSD   - SAS：高IO硬盘    |
| size         | String                                                                                         | **参数解释**：磁盘大小，单位为Gi。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| count        | String                                                                                         | **参数解释**：磁盘个数。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| extendParams | [表19] object | **参数解释**：磁盘自定义配置                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
 表19extendParams 
| 参数          | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| billing     | String | **参数解释**：标识存储实例是否计费，默认开启。为空则表示不计费。该字段用户不可指定或修改。 **取值范围**：默认开启 on                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| volumeGroup | String | **参数解释**：磁盘分组名称，用于各个存储空间的划分。 **取值范围**：可选项如下： - vgpaas：容器盘。   - default：普通数据盘，以默认方式挂载。   - vguser{num}：普通数据盘，指定挂载路径，不同路径的分组名称不同，如vguser1，vguser2。   - vg-everest-localvolume-persistent：普通数据盘，作为持久存储卷   - vg-everest-localvolume-ephemeral：普通数据盘，作为临时存储卷    |
   
 表20volumeGroupConfigs 
| 参数             | 参数类型                                                                                               | 描述                                                                                                                                                 |
|:---|:---|:---|
| volumeGroup    | String                                                                                             | **参数解释**：磁盘分组名称。作为dataVolumes中volumeGroup的索引。 **取值范围**：不涉及。           |
| dockerThinPool | Integer                                                                                            | **参数解释**：资源池节点容器盘占数据盘的百分比。仅磁盘分组名称为vgpaas时，即容器盘，才可指定此参数。 **取值范围**：不涉及。 |
| lvmConfig      | [lvmConfig] object | **参数解释**：LVM配置管理。                                                                                                                                  |
   
 表21lvmConfig 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| lvType | String | **参数解释**：LVM写入模式 **取值范围**：可选项如下： - linear：线性模式。   - striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能。    |
   
 表22containernetwork 
| 参数   | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| mode | String | **参数解释**：容器网络模型。 **取值范围**：可选值如下： - overlay_l2：容器隧道网络，通过OVS（OpenVSwitch）为容器构建的overlay_l2网络。   - vpc-router：VPC网络，使用ipvlan和自定义VPC路由为容器构建的Underlay的l2网络。   - eni：云原生网络2.0，深度整合VPC原生ENI弹性网卡能力，采用VPC网段分配容器地址，支持ELB直通容器，享有高性能，创建CCE Turbo集群时指定。    |
   
 表23network 
| 参数   | 参数类型   | 描述                                                                                                        |
|:---|:---|:---|
| name | String | **参数解释**：网络ID。 **取值范围**：不涉及。 |
   
 表24PoolDriver 
| 参数             | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| gpuVersion     | String | **参数解释**：资源池默认的GPU驱动版本。物理资源池中包含GPU规格时有效。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| npuVersion     | String | **参数解释**：资源池默认的NPU驱动版本。物理资源池中包含NPU规格时有效。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| updateStrategy | String | **参数解释**：资源池驱动升级策略。 **取值范围**：可选值如下： - force：强制升级，立即升级节点驱动，可能影响节点上正在运行的作业。   - idle：安全升级，待节点上没有作业运行时进行驱动升级。    |
   
 表25PoolStatus 
| 参数        | 参数类型                                                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| phase     | String                                                                                               | **参数解释**：资源池的状态。 **取值范围**：可选值如下： - Creating：资源池在创建中。   - Running：资源池在运行中。   - Abnormal：资源池异常。   - Deleting：资源池在删除中。   - Error：资源池错误。    |
| message   | String                                                                                               | **参数解释**：资源池当前状态的提示信息。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| resources | [表26] object          | **参数解释**：资源池中不同状态的资源信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| scope     | Array of [scope] objects | **参数解释**：资源池当前支持的业务类型的状态信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| driver    | [driver] object         | **参数解释**：资源池驱动状态信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| parent    | String                                                                                               | **参数解释**：资源池所属父资源池的ID，物理池为空。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| root      | String                                                                                               | **参数解释**：资源池根资源池的ID。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| clusters  | [clusters] object     | **参数解释**：资源池集群信息，特权池才有该字段。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表26resources 
| 参数        | 参数类型                                                                                                                           | 描述                       |
|:---|:---|:---|
| creating  | [PoolResourceFlavorCount] object | **参数解释**：资源池中创建状态的资源信息。  |
| available | [PoolResourceFlavorCount] object | **参数解释**：资源池中可用状态的资源信息。  |
| abnormal  | [PoolResourceFlavorCount] object | **参数解释**：资源池中异常状态的资源信息。  |
| deleting  | [PoolResourceFlavorCount] object | **参数解释**：资源池中删除中状态的资源信息。 |
   
 表27PoolResourceFlavorCount 
| 参数       | 参数类型                                                                                                           | 描述                                                                                                                                 |
|:---|:---|:---|
| flavor   | String                                                                                                         | **参数解释**：资源规格ID。 **取值范围**：不涉及。                        |
| count    | Integer                                                                                                        | **参数解释**：资源池中资源规格实例数量。 **取值范围**：不涉及。                  |
| maxCount | Integer                                                                                                        | **参数解释**：资源池中资源规格实例弹性数量。物理池中该值和count相同。 **取值范围**：不涉及。 |
| azs      | Array of [PoolNodeAz] objects | **参数解释**：资源池中期望创建的资源规格实例的az分布。                                                                                                     |
| nodePool | String                                                                                                         | **参数解释**：节点池ID。 **取值范围**：不涉及。                         |
   
 表28PoolNodeAz 
| 参数    | 参数类型    | 描述                                                                                                              |
|:---|:---|:---|
| az    | String  | **参数解释**：可用区名称。 **取值范围**：不涉及。      |
| count | Integer | **参数解释**：可用区资源实例的数量。 **取值范围**：不涉及。 |
   
 表29scope 
| 参数        | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| scopeType | String | **参数解释**：资源池的业务类型。 **取值范围**：可选值如下： - Train：训练任务。   - Infer：旧版推理任务。   - X-infer：推理2.0任务。   - Reinforcement Learning：强化学习。   - Notebook：Notebook作业。    |
| state     | String | **参数解释**：资源池业务类型状态。 **取值范围**：可选值如下： - Enabling：启动中。   - Enabled：已启动。   - EnableFailed 开启失败   - Disabling：关闭中。   - Disabled：已关闭。                      |
   
 表30driver 
| 参数  | 参数类型                                                                                                             | 描述                                                                                                              |
|:---|:---|:---|
| gpu | [PoolDriverStatus] object | **参数解释**：资源池GPU驱动状态。 **取值范围**：不涉及。 |
| npu | [PoolDriverStatus] object | **参数解释**：资源池NPU驱动状态。 **取值范围**：不涉及。 |
   
 表31PoolDriverStatus 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| version | String | **参数解释**：资源池当前驱动版本。 **取值范围**：不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| state   | String | **参数解释**：资源池当前驱动状态。 **取值范围**：可选值如下： - Creating：驱动安装中。   - Upgrading：驱动升级中。   - Running：驱动运行中。   - Abnormal：驱动异常。    |
   
 表32clusters 
| 参数            | 参数类型                                                                                           | 描述                                                                                                            |
|:---|:---|:---|
| name          | String                                                                                         | **参数解释**：集群名称。 **取值范围**：不涉及。     |
| clusterFlavor | String                                                                                         | **参数解释**：标准池的集群规格。 **取值范围**：不涉及。 |
| type          | String                                                                                         | **参数解释**：资源池集群的类型。 **取值范围**：不涉及。 |
| version       | String                                                                                         | **参数解释**：集群的版本号。 **取值范围**：不涉及。   |
| plugins       | [plugins] object | **参数解释**：集群支持的插件名称。                                                                                           |
   
 表33plugins 
| 参数   | 参数类型   | 描述                                                                                                             |
|:---|:---|:---|
| name | String | **参数解释**：集群支持的插件名称。 **取值范围**：不涉及。 |
   
**状态码：400**
表34响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 |
| error_msg  | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。       |
   
**状态码：404**
表35响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 |
| error_msg  | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。       |
   
#### 请求示例
资源池扩容。
```
PATCH https://{endpoint}/v2/{project_id}/pools/{pool_name}
{
  "spec" : {
    "resources" : [ {
      "flavor" : "modelarts.vm.cpu.4ud",
      "count" : 3
    } ]
  }
}
```
#### 响应示例
**状态码：200**
OK。
```
{
  "kind" : "Pool",
  "apiVersion" : "v2",
  "metadata" : {
    "name" : "auto-pool-os-86c13962597848eeb29c5861153a391f",
    "creationTimestamp" : "2022-09-16T03:10:40Z",
    "labels" : {
      "os.modelarts/name" : "auto-pool-os",
      "os.modelarts/workspace.id" : "0",
      "os.modelarts/resource.id" : "maos-auto-pool-os-72w8d"
    },
    "annotations" : {
      "os.modelarts/description" : "",
      "os.modelarts/billing.mode" : "0"
    }
  },
  "spec" : {
    "type" : "Dedicate",
    "scope" : [ "Train", "Infer" ],
    "resources" : [ {
      "flavor" : "modelarts.vm.cpu.4ud",
      "count" : 3
    } ],
    "network" : {
      "name" : "network-maos-86c13962597848eeb29c5861153a391f"
    }
  },
  "status" : {
    "phase" : "Running",
    "root" : "auto-pool-os-86c13962597848eeb29c5861153a391f",
    "scope" : [ {
      "scopeType" : "Train",
      "state" : "Enabled"
    }, {
      "scopeType" : "Infer",
      "state" : "Enabled"
    } ],
    "resources" : {
      "creating" : {
        "flavor" : "modelarts.vm.cpu.4ud",
        "count" : 1,
        "azs" : [ {
          "az" : "cn-north-7c",
          "count" : 1
        } ]
      },
      "available" : {
        "flavor" : "modelarts.vm.cpu.4ud",
        "count" : 2,
        "azs" : [ {
          "az" : "cn-north-7c",
          "count" : 2
        } ]
      }
    }
  }
}
```
**状态码：400**
Bad request
```
{
  "error_code" : "ModelArts.50004000",
  "error_msg" : "Bad request"
}
```
**状态码：404**
Not Found。
```
{
  "error_code" : "ModelArts.50015001",
  "error_msg" : "pool not found"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | OK。         |
| 400 | Bad request |
| 404 | Not Found。  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。
