文档首页/ AI开发平台ModelArts/ API参考/ 资源管理/ 更新资源池

更新时间：2024-10-23 GMT+08:00

查看PDF

更新资源池

功能介绍

更新指定的资源池。

调试

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

URI

PATCH /v2/{project_id}/pools/{pool_name}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	用户项目ID。获取方法请参见获取项目ID和名称。
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	资源池的描述信息。

表4 PoolMetadataUpdate
参数	是否必选	参数类型	描述
annotations	否	annotations object	资源池的注释信息。

表5 annotations
参数	是否必选	参数类型	描述
os.modelarts/description	否	String	资源池描述信息，用于说明资源池用于某种指定场景。不能包含特殊字符!<>=&"'。
os.modelarts/order.id	否	String	订单id，包周期创建和变更的时候需要传递该参数。

表6 PoolSpecUpdate
参数	是否必选	参数类型	描述
scope	否	Array of strings	更新启用的作业类型。可选值如下： Train：训练作业 Infer：推理作业 Notebook：Notebook作业
resources	否	Array of resources objects	更新的资源规格列表。
jobFlavors	否	Array of strings	资源池支持的作业规格信息列表。
driver	否	PoolDriver object	资源池驱动信息。

表7 resources
参数	是否必选	参数类型	描述
flavor	是	String	资源规格。
count	是	Integer	相应规格的资源数量。
azs	否	Array of PoolNodeAz objects	更新的AZ列表。

表8 PoolNodeAz
参数	是否必选	参数类型	描述
az	是	String	可用区名称。
count	是	Integer	指定可用区扩容时，指定可用区的节点数。

表9 PoolDriver
参数	是否必选	参数类型	描述
gpuVersion	否	String	GPU驱动版本，物理资源池中含有GPU规格时可填，例如："440.33"。
npuVersion	否	String	NPU驱动版本，物理资源池中含有ascend规格时可填，例如："C78"。
updateStrategy	否	String	驱动升级策略。可选值如下： force：强制升级，立即升级节点驱动，可能影响节点上正在运行的作业 idle：安全升级，待节点上没有作业运行时进行驱动升级

响应参数

状态码： 200

**表10** 响应Body参数
参数	参数类型	描述
apiVersion	String	API版本。可选值如下： v2
kind	String	资源类型。可选值如下： Pool：资源池
metadata	PoolMetadata object	资源池的metadata信息。
spec	PoolSpecModel object	资源池的期望信息。
status	PoolStatus object	资源池的状态信息。

**表11** PoolMetadata
参数	参数类型	描述
name	String	系统自动生成的pool名称，相当于pool ID。
creationTimestamp	String	时间戳，例如"2021-11-01T03:49:41Z"。
labels	PoolMetaLabels object	资源池的标签信息。
annotations	PoolMetaAnnotations object	资源池的注释信息。

**表12** PoolMetaLabels
参数	参数类型	描述
os.modelarts/workspace.id	String	工作空间ID。获取方法请参见查询工作空间列表。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。
os.modelarts/name	String	用户指定的pool名称。
os.modelarts/resource.id	String	资源池的主资源id，通常提供给cbc使用。
os.modelarts/tenant.domain.id	String	资源池的租户id，记录资源池创建在哪个租户账号下。

**表13** PoolMetaAnnotations
参数	参数类型	描述
os.modelarts/description	String	资源池的描述信息。
os.modelarts/billing.mode	String	计费模式。可选值如下： 0：按需计费 1：包周期计费
os.modelarts/period.num	String	包周期订购周期，比如2。
os.modelarts/period.type	String	包周期订购类型。可选值如下： 2：月 3：年 4：小时
os.modelarts/auto.renew	String	是否自动续费.可选值如下： 0：不自动续费，默认值 1：自动续费
os.modelarts/promotion.info	String	用户在cbc选择的折扣信息。
os.modelarts/service.console.url	String	订购订单支付完成后跳转的url地址。
os.modelarts/order.id	String	订单id，包周期资源池创建或者计费模式变更的时候该参数必需。
os.modelarts/flavor.resource.ids	String	每种规格对应的resourceId，主要和cbc交互使用。
os.modelarts/tms.tags	String	创建的时候由用户指定的TMS标签。

**表14** PoolSpecModel
参数	参数类型	描述
type	String	资源池类型。可选值如下： Dedicate：物理资源池，独立的网络，支持网络打通，定制驱动，定制作业类型。
scope	Array of strings	资源池支持的作业类型。至少选择一种，物理资源池支持全部选择。可选值如下： Train：训练作业 Infer：推理作业 Notebook：Notebook作业
resources	Array of resources objects	资源池中的资源规格信列表，包括资源规格和相应规格的资源数量。
network	network object	资源池网络参数。物理资源池时必选。
jobFlavors	Array of strings	资源池支持的作业规格信息列表，内容为作业规格名称。
driver	PoolDriver object	资源池的驱动信息。
controlMode	Integer	资源池的受限状态。可选值如下： 0：代表不受限 1：转包周期受限 2：规格变更受限 4：服务受限 8：冻结 16：公安冻结（不可退订）另外状态是可以叠加的，比如9代表转包周期受限+冻结状态。

**表15** resources
参数	参数类型	描述
flavor	String	资源规格，比如：modelarts.vm.gpu.tnt004。
count	Integer	相应规格资源数量。
azs	Array of PoolNodeAz objects	az列表信息。

**表16** PoolNodeAz
参数	参数类型	描述
az	String	可用区名称。
count	Integer	指定可用区扩容时，指定可用区的节点数。

**表17** network
参数	参数类型	描述
name	String	网络名称；用户接口通过指定网络名称创建网络，系统会自动创建子网，用户无法创建子网。默认将创建在第一个子网下。

**表18** PoolDriver
参数	参数类型	描述
gpuVersion	String	GPU驱动版本，物理资源池中含有GPU规格时可填，例如："440.33"。
npuVersion	String	NPU驱动版本，物理资源池中含有ascend规格时可填，例如："C78"。
updateStrategy	String	驱动升级策略。可选值如下： force：强制升级，立即升级节点驱动，可能影响节点上正在运行的作业 idle：安全升级，待节点上没有作业运行时进行驱动升级

**表19** PoolStatus
参数	参数类型	描述
phase	String	资源池集群状态。可选值如下： Creating：创建中 Running：运行中 Abnormal：资源池不正常 Deleting：删除中 Error：资源池错误
message	String	资源池处于当前状态的提示信息。
resources	resources object	资源池中不同状态的资源量。
scope	Array of scope objects	资源池业务状态信息。
driver	driver object	资源池驱动信息。
parent	String	资源池父节点名称，物理池为空。
root	String	资源池根节点名称，物理池为自己的名称。

**表20** resources
参数	参数类型	描述
creating	PoolResourceFlavorCount object	状态为创建中状态的资源量。
available	PoolResourceFlavorCount object	状态为可用状态的资源量。
abnormal	PoolResourceFlavorCount object	状态为非正常状态的资源量。
deleting	PoolResourceFlavorCount object	状态为删除中状态的资源量。

**表21** PoolResourceFlavorCount
参数	参数类型	描述
flavor	String	资源规格名称，比如：modelarts.vm.gpu.tnt004。
count	Integer	规格保障使用量。
maxCount	Integer	资源规格的弹性使用量，物理池该值和count相同。
azs	Array of azs objects	资源所在的AZ的数量。
nodePool	String	节点池名称。比如：nodePool-1。

**表22** azs
参数	参数类型	描述
az	String	AZ的名称。
count	Integer	AZ的资源数量。

**表23** scope
参数	参数类型	描述
scopeType	String	业务类型。可选值如下： Train：训练任务 Infer：推理任务 Notebook：Notebook作业
state	String	业务状态。可选值如下： Enabling：启动中 Enabled：已启动 Disabling：关闭中 Disabled：已关闭

**表24** driver
参数	参数类型	描述
gpu	PoolDriverStatus object	GPU驱动信息。
npu	PoolDriverStatus object	NPU驱动信息。

**表25** PoolDriverStatus
参数	参数类型	描述
version	String	当前驱动版本。
state	String	当前驱动状态。可选值如下： Creating：创建中 Upgrading：升级中 Running：运行中 Abnormal：不正常

状态码： 400

**表26** 响应Body参数
参数	参数类型	描述
error_code	String	ModelArts错误码。
error_msg	String	具体错误信息。

状态码： 404

**表27** 响应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。

错误码

请参见错误码。

父主题： 资源管理

上一篇：删除资源池

下一篇：资源池监控

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

更新资源池

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线