查看计算资源详情 - ShowV2Compute

功能介绍

查看指定计算资源的详细信息。此接口为同步接口。

调用方法

URI

GET /v2/workspaces/{workspace_id}/computes/{compute_id}

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

请求参数

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

响应参数

状态码：200

表3 响应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	参数解释：失败时返回的文本消息内容，包含错误码、错误描述。

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

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

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

状态码：400

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

状态码：401

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

状态码：403

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

状态码：404

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

状态码：500

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

请求示例

查询计算资源详情。计算资源id为“compute_id”。

GET /v2/workspaces/{workspace_id}/computes/{compute_id}

响应示例

状态码：200

请求成功。

{
  "id" : "03141229-84cd-4b1b-9733-dd124320c125",
  "name" : "compute-01",
  "description" : "description",
  "charge_mode" : "postPaid",
  "capacity" : [ {
    "type" : "CPU",
    "capacity" : 1000,
    "spec_code" : "aidatalake.cpu.x86.general.1c4g"
  } ],
  "update_time" : "2025-01-10T03:37:12.000+00:00",
  "create_time" : "2025-01-10T03:37:12.000+00:00",
  "status" : "RUNNING",
  "creator" : {
    "domain_name" : "domain_name",
    "domain_id" : "domain_id",
    "user_name" : "user_name",
    "user_id" : "user_id"
  }
}

状态码：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."
}