创建计算资源 - CreateV2Compute

功能介绍

创建计算资源，支持传入名称、描述、容量、属性和标签，返回计算资源详情。此接口为异步接口，可通过查询计算资源操作记录列表接口获取操作结果，具体请参见查询计算资源操作记录列表。

调用方法

URI

POST /v2/workspaces/{workspace_id}/computes

表1 路径参数
参数	是否必选	参数类型	描述
workspace_id	是	String	参数解释：工作空间ID。约束限制：不涉及。取值范围：长度为32~36的英文字符、数字和中划线的组合。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。约束限制：不涉及。取值范围：长度不超过65534个字符。默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	参数解释：计算资源名称。约束限制：必填。取值范围：长度为1~63个字符，遵循RFC 1035规范，支持小写字母、数字、中划线，必须字母开头、字母或数字结尾。默认取值：不涉及。
description	否	String	参数解释：资源描述信息。约束限制：不涉及。取值范围：不允许输入感叹号、小于号、大于号、等号、与号、双引号、单引号字符。长度为0~512个字符。默认取值：不涉及。
charge_mode	否	String	参数解释：计费模式。约束限制：不涉及。取值范围： postPaid：按需计费。 prePaid：包周期计费。默认取值：postPaid。
capacity	是	Array of CapacityItem objects	参数解释：计算资源容量配置。约束限制：最少1项，最多10项。取值范围：最少1项，最多10项。默认取值：不涉及。

表4 CapacityItem
参数	是否必选	参数类型	描述
type	否	String	参数解释：资源类型。约束限制：不涉及。取值范围： CPU：CPU资源。 GPU：GPU资源。 NPU：NPU资源。默认取值：不涉及。
capacity	否	Integer	参数解释：资源数量。约束限制：不涉及。取值范围：0~48000。默认取值：不涉及。
spec_code	否	String	参数解释：资源规格。约束限制：不涉及。取值范围：长度为1~64个字符，从规格列表查询获取。默认取值：不涉及。

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
id	String	参数解释：计算资源ID。取值范围：长度为1~36的英文字母、数字和中划线的组合。
name	String	参数解释：计算资源名称。取值范围：长度为1~63个字符，遵循RFC 1035规范，支持小写字母、数字、中划线，必须字母开头、字母或数字结尾。
description	String	参数解释：资源描述信息。取值范围：字符长度为0~512个字符。
charge_mode	String	参数解释：计费模式。取值范围： postPaid：按需计费。 prePaid：包周期计费。默认取值：不涉及。
capacity	Array of ResourceCapacityItem objects	参数解释：计算资源容量配置。
update_time	String	参数解释：资源更新时间。取值范围：ISO 8601格式，例如2025-01-10T03:37:12.000+00:00。
create_time	String	参数解释：资源创建时间。取值范围：ISO 8601格式，yyyy-MM-dd'T'HH:mm:ss.SSSZ。
status	String	参数解释：资源状态。取值范围： PREPARING：创建中。 RELEASING：释放中。 RUNNING：运行中。 SCALEIN：缩容中。 SCALEOUT：扩容中。 FREEZING：冻结中。 DELETED：已删除。 DELETING：删除中。 FAILED：失败。 ORDER_PAYING：订单支付中。
creator	Creator object	参数解释：资源所有者信息。
error	Error object	参数解释：失败时返回的文本消息内容，包含错误码、错误描述。

表6 ResourceCapacityItem
参数	参数类型	描述
type	String	参数解释：资源类型。取值范围：CPU、GPU、NPU。
capacity	Integer	参数解释：资源容量数量。取值范围：0~48000。
spec_code	String	参数解释：规格编码。取值范围：长度为1~64的英文字母、数字和中划线的组合。
resource_id	String	参数解释：资源ID。取值范围：长度为1~64的英文字母、数字和中划线的组合。

表7 Creator
参数	参数类型	描述
domain_name	String	参数解释：租户名称。取值范围：长度为1~64个字符。
domain_id	String	参数解释：租户ID。取值范围：长度为1~64个字符。
user_name	String	参数解释：用户名称。取值范围：长度为1~64个字符。
user_id	String	参数解释：用户ID。取值范围：长度为1~64个字符。

表8 Error
参数	参数类型	描述
error_code	String	参数解释：失败状态时的错误编码。取值范围：长度为0~36个字符。
error_msg	String	参数解释：失败状态时的错误信息。取值范围：长度为0~1024个字符。

状态码：400

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：401

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：403

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：404

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

状态码：500

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~512个字符。
solution_msg	String	参数解释：解决方案。取值范围：长度为0~4096个字符。

请求示例

创建计算资源。名称为“compute-01”，描述为“测试计算资源”。

POST /v2/workspaces/{workspace_id}/computes

{
  "name" : "compute-01",
  "description" : "测试计算资源",
  "capacity" : [ {
    "type" : "CPU",
    "capacity" : 10,
    "spec_code" : "aidatalake.cpu.x86.general.1c4g"
  } ],
  "charge_mode" : "postPaid"
}

响应示例

状态码：200

请求下发成功。

{
  "id" : "9502db7c-f08e-4dd3-bb69-9bcbd8d3e8df",
  "name" : "compute-01",
  "description" : "测试计算资源",
  "charge_mode" : "postPaid",
  "update_time" : "2026-05-14T04:22:18.000+00:00",
  "create_time" : "2026-05-14T04:22:18.000+00:00",
  "status" : "PREPARING",
  "creator" : {
    "domain_name" : "domain_name",
    "domain_id" : "domain_id",
    "user_name" : "user_name",
    "user_id" : "user_id"
  },
  "error" : { }
}

状态码：400

请求参数错误。

{
  "error_code" : "AIDataLake.00010011",
  "error_msg" : "Invalid specification code.",
  "solution_msg" : "Enter a correct specification code."
}

状态码：401

未授权。

{
  "error_code" : "APIGW.0301",
  "error_msg" : "Incorrect IAM authentication information decrypt token fail"
}

状态码：403

禁止访问。

{
  "error_code" : "AIDataLake.00010038",
  "error_msg" : "Unauthorized requests.",
  "solution_msg" : "Check permissions {xxx} and retry after authorization."
}

状态码：404

资源未找到。

{
  "error_code" : "AIDataLake.00010004",
  "error_msg" : "Not Found",
  "solution_msg" : "Please check the resource ID and try again"
}

状态码：500

内部服务器错误。

{
  "error_code" : "AIDataLake.00010067",
  "error_msg" : "Failed to initialize the task because the number of tasks may have reached the upper limit.",
  "solution_msg" : "Try again later."
}