更新时间:2025-07-04 GMT+08:00
分享

查询诊断记录

功能介绍

查询当前租户下所创建的诊断任务列表。

调试

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

URI

GET /v1/diagnosis/tasks

表1 Query参数

参数

是否必选

参数类型

描述

task_id

String

参数解释:

诊断任务工单ID,为系统自动生成。

约束限制:

请选择在诊断工单中存在的工单ID。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

诊断任务支持的实例类别。

约束限制:

不涉及。

取值范围:

  • ECS

  • RDS

  • DCS

  • DMS

  • ELB

默认取值:

不涉及。

status

String

参数解释:

诊断任务执行状态。

约束限制:

不涉及。

取值范围:

  • cancel:“已取消”

  • executing:“执行中”

  • waiting:“待执行”

  • failed:“异常”

  • finish:“已完成”

默认取值:

不涉及。

region

String

参数解释:

被诊断实例所在区域。

约束限制:

请参考统一身份认证服务选择存在的区域。

取值范围:

不涉及。

默认取值:

不涉及。

creator

String

参数解释:

诊断任务工单创建人的IAM用户ID。

约束限制:

请选择在人员管理中存在的用户ID。

取值范围:

不涉及。

默认取值:

不涉及。

start_time

Long

参数解释:

诊断工单的开始执行时间。

约束限制:

不涉及。

取值范围:

毫秒级UTC时间戳。

默认取值:

不涉及。

end_time

Long

参数解释:

诊断工单的执行结束时间。

约束限制:

不涉及。

取值范围:

毫秒级的UTC时间戳。

默认取值:

不涉及。

page_index

Integer

参数解释:

分页查询页索引。

约束限制:

不涉及。

取值范围:

位于区间[1,10000]的整数。

默认取值:

不涉及。

page_size

Integer

参数解释:

分页查询页大小。

约束限制:

不涉及。

取值范围:

位于区间[1,100]的整数。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

data

DiagnosisTaskPage object

诊断记录分页对象结构体。

表3 DiagnosisTaskPage

参数

参数类型

描述

total

Integer

参数解释:

符合条件的记录总数。

取值范围:

[0,1000000]之间的整数。

data

Array of DiagnosisTask objects

诊断记录结构体。

表4 DiagnosisTask

参数

参数类型

描述

id

String

参数解释:

诊断任务节点ID。

取值范围:

不涉及。

code

String

参数解释:

步骤编码。

取值范围:

  • holmesInstall:安装holmes诊断插件。

  • dataCollection:采集数据。

  • diagnosisFault:故障诊断。

  • holmesUnInstall:卸载holmes诊断插件。

  • rdsDiagnosis: 数据库服务RDS的诊断。

  • dcsDiagnosis:分布式缓存服务DCS 的诊断。

  • dmsDiagnosis:分布式消息服务DMS的诊断。

  • elbDiagnosis:弹性负载均衡ELB的诊断。

domain_id

String

参数解释:

诊断记录所属账号ID。

取值范围:

不涉及。

project_id

String

参数解释:

被诊断实例所属项目ID。

取值范围:

不涉及。

user_id

String

参数解释:

诊断记录所属用户ID。

取值范围:

不涉及。

user_name

String

参数解释:

诊断记录所属用户名称。

取值范围:

不涉及。

progress

Integer

参数解释:

诊断任务执行进度。

取值范围:

[0-100]之间的正整数。

work_order_id

String

参数解释:

诊断任务工单ID。

取值范围:

不涉及。

instance_id

String

参数解释:

被诊断的实例ID。

取值范围:

不涉及。

instance_name

String

参数解释:

被诊断的实例名称。

取值范围:

不涉及。

type

String

参数解释:

被诊断实例的类别。

取值范围:

  • ECS

  • RDS

  • DCS

  • DMS

  • ELB

status

String

参数解释:

诊断任务执行状态。

取值范围:

  • waiting

  • executing

  • cancel

  • finish

  • failed

start_time

String

参数解释:

开始时间。

取值范围:

遵循RFC3339规范,精确到秒。

示例:2020-09-01T18:50:20Z。

end_time

String

参数解释:

结束时间。

取值范围:

遵循RFC3339规范,精确到秒。

示例:2020-09-01T18:50:20Z。

instance_num

Integer

参数解释:

诊断任务中包含的实例数量。

取值范围:

[1,200]之间的整数。

os_type

String

参数解释:

被诊断实例的操作系统类型。

取值范围:

对于ECS诊断而言,存在两种取值:

  • LINUX

  • WINDOWS

对于RDS、DCS、DMS、ELB诊断而言,该参数为null。

region

String

参数解释:

被诊断实例所在区域。

取值范围:

不涉及。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

请参考错误码章节。

error_msg

String

参数解释:

错误信息。

取值范围:

请参考错误码章节。

请求示例

按照开始时间和实例类型为查询当前租户下的诊断任务列表。

GET https://{Endpoint}/v1/diagnosis/tasks?page_index=1&page_size=10&type=ECS&start_time=1748917259000

响应示例

状态码:200

请求成功。

{
  "data" : {
    "total" : 1,
    "data" : {
      "id" : "random_id",
      "domain_id" : "domain_id1",
      "start_time" : "2025-06-27 16:30:19.124",
      "end_time" : "2025-06-27 16:35:22.325",
      "instance_id" : "instance_id1,instance_id2",
      "instance_name" : "instance_name1,instance_name2",
      "instance_num" : "2",
      "region" : "region1",
      "status" : "finish",
      "type" : "ECS",
      "user_name" : "username1"
    }
  }
}

状态码

状态码

描述

200

请求成功。

400

客户端请求错误响应。

500

服务端错误。

错误码

请参见错误码

相关文档