文档首页/ 魔坊(ModelArts)模型训推平台/ API参考/ 资源管理/ 创建资源池的订单id - CreateOrderId
更新时间:2026-06-03 GMT+08:00

创建资源池的订单id - CreateOrderId

功能介绍

创建资源池订单ID接口用于生成资源池申请的订单标识。该接口适用于以下场景:当用户需要申请新资源池时(如业务扩展、资源不足或临时资源需求),可通过此接口提交按需转包周期订单的创建请求。使用该接口的前提条件是用户需具备资源申请权限,提交的资源池配置参数(如资源类型、容量、周期等)需符合系统校验规则,且当前仅支持按需转包周期订单类型。订单创建成功后,系统将生成唯一订单ID并触发后续资源分配流程,同时记录操作日志。若用户权限不足、配置参数缺失/冲突(如容量超出配额)、订单类型不支持或系统资源不足,接口将返回对应错误码及提示信息,且不会生成订单ID或占用资源。

调试

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

授权信息

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

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

URI

POST /v2/{project_id}/pools/{name}/orderid

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:。获取方法请参见](modelarts_03_0147.xml)。

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

name

String

参数解释:资源池ID。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

actionType

String

参数解释:订单操作类型。

约束限制:不涉及。

取值范围:可选值如下:

  • toPeriod:按需转包周期,默认值

默认取值:不涉及。

workspaceId

String

参数解释:工作空间ID,默认是0。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

actionType

String

参数解释:订单类型。

约束限制:不涉及。

取值范围:不涉及。

默认取值:不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释:订单ID。

取值范围:不涉及。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

状态码:409

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

请求示例

响应示例

状态码:200

订单id。

{
  "orderId" : "0123456789"
}

状态码:400

Bad request

{
  "error_code" : "ModelArts.50004000",
  "error_msg" : "Bad request"
}

状态码:409

Already exists

{
  "error_code" : "ModelArts.50015000",
  "error_msg" : "Pool already exists."
}

状态码

状态码

描述

200

订单id。

400

Bad request

409

Already exists

错误码

请参见错误码