查询计算资源操作记录列表 - ListV2ComputeVersions

功能介绍

查询计算资源操作记录列表。此接口为同步接口。

调用方法

URI

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

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

表2 Query参数
参数	是否必选	参数类型	描述
compute_id	否	String	参数解释：计算资源ID。约束限制：不涉及。取值范围：长度为32~36的英文字符、数字和中划线的组合。默认取值：不涉及。
operation_result	否	String	参数解释：操作结果，不传则查询所有状态的操作记录。约束限制：不涉及。取值范围： SUCCESS：操作成功。 EXECUTING：执行中。 FAILED：操作失败。默认取值：不涉及。
offset	否	Integer	参数解释：分页偏移量。约束限制：不涉及。取值范围：0~10000。默认取值：0。
limit	否	Integer	参数解释：分页大小。约束限制：不涉及。取值范围：1~1000。默认取值：100。

请求参数

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

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total	Integer	参数解释：总记录数。取值范围：0~10000。
compute_versions	Array of ShowV2ComputeVersionResponseBody objects	参数解释：计算资源操作历史列表。

表5 ShowV2ComputeVersionResponseBody
参数	参数类型	描述
id	String	参数解释：计算资源记录ID。取值范围：长度为1~36的英文字符、数字和中划线的组合。
compute_id	String	参数解释：计算资源ID。取值范围：长度为1~36的英文字符、数字和中划线的组合。
name	String	参数解释：计算资源名称。取值范围：长度为1~63个字符，遵循RFC 1035规范，支持小写字母、数字、中划线，必须字母开头、字母或数字结尾。
capacity	CapacityVersion object	参数解释：计算资源容量配置。
create_time	String	参数解释：资源创建时间。取值范围：ISO 8601格式，例如2025-01-10T03:37:12.000+00:00。
update_time	String	参数解释：资源更新时间。取值范围：ISO 8601格式，例如2025-01-10T03:37:12.000+00:00。
creator	Creator object	参数解释：资源所有者信息。
error	Error object	参数解释：失败时返回的文本消息内容，包含错误码、错误描述。
operation	Operation object	参数解释：计算资源操作记录，包含操作类型、操作结果。

表6 CapacityVersion
参数	参数类型	描述
type	String	参数解释：资源类型。约束限制：不涉及。取值范围： CPU：CPU资源。 GPU：GPU资源。 NPU：NPU资源。默认取值：不涉及。
capacity	Integer	参数解释：资源数量。约束限制：不涉及。取值范围：0~48000。默认取值：不涉及。
target_capacity	Integer	参数解释：目标资源数量。约束限制：不涉及。取值范围：0~48000。默认取值：不涉及。
spec_code	String	参数解释：资源规格。约束限制：不涉及。取值范围：长度为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个字符。

表9 Operation
参数	参数类型	描述
operation_type	String	参数解释：操作类型。取值范围： CREATE：创建。 SCALEIN：缩容。 SCALEOUT：扩容。 DELETE：删除。
operation_result	String	参数解释：操作结果。取值范围： EXECUTING：执行中。 SUCCESS：操作成功。 FAILED：操作失败。

状态码：400

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

状态码：401

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

状态码：403

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

状态码：404

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

状态码：500

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

请求示例

查询指定工作空间下的计算资源操作记录。工作空间的id为“workspace_id”。

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

响应示例

状态码：200

请求成功。

{
  "total" : 1,
  "compute_versions" : [ {
    "id" : "46d2d3aa-b28d-43da-b5b8-d7c1e9f46b9b",
    "compute_id" : "61eb192a-74de-416b-88d0-66eab567fec7",
    "name" : "compute-id-test",
    "capacity" : [ {
      "type" : "CPU",
      "capacity" : 1000,
      "spec_code" : "aidatalake.cpu.x86.general.1c4g"
    } ],
    "target_capacity" : [ {
      "type" : "CPU",
      "capacity" : 500,
      "spec_code" : "aidatalake.cpu.x86.general.1c4g"
    } ],
    "create_time" : "2025-01-10T03:37:12.000+00:00",
    "update_time" : "2025-01-10T03:37:12.000+00:00",
    "creator" : {
      "domain_name" : "test_domain_id",
      "domain_id" : "test610f3a0a4c2c80c50bea7ddf18c1",
      "user_name" : "test39176",
      "user_id" : "test523342614e3e984e8b854a401ac4"
    },
    "error" : {
      "error_code" : 4632,
      "error_msg" : "task execute failed."
    },
    "operation" : {
      "operation_type" : "SCALEIN",
      "operation_result" : "FAILED"
    }
  } ]
}

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