调用DescribeDiagnosticReportList接口查询诊断报告。

DAS会定期对您接入DAS的所有数据库实例进行巡检并给出健康评分,帮助您一目了然的确认数据库运行情况。

使用该接口需满足以下前提条件:

  • 在使用阿里云SDK时,需要保证aliyun-sdk-core的版本大于4.3.3,建议使用最新版本。
  • 使用DAS的SDK的版本为1.0.3或以上。
  • 在调用DAS服务时,需要将地域指定为cn-shanghai。
  • 本接口适用的数据库引擎为:
    • RDS MySQL
    • PolarDB MySQL
    • Redis
    • MongoDB

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDiagnosticReportList

系统规定参数。取值:DescribeDiagnosticReportList

DBInstanceId String rm-2ze8g2am97624****

实例ID。

PageNo String 1

页码,取值大于0且不超过Integer数据类型的最大值,默认值为1。

PageSize String 10

每页最大记录数,默认值为10。

StartTime String 1648605944000

查询任务开始时间,格式为Unix时间戳(UTC时间),单位为毫秒。

EndTime String 1648608644000

查询任务结束时间,格式为Unix时间戳,单位为毫秒。

说明 查询任务结束时间需晚于查询任务开始时间。

返回数据

名称 类型 示例值 描述
RequestId String ac544623-f6ad-45fd-9a74-9be3db65****

请求ID。

Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
Synchro String None

备用参数。

Data String { "total": 1, "list": [ { "score": 100, "diagnosticTime": "2022-03-30T02:35:34Z", "startTime": "2022-03-30T02:05:44Z", "endTime": "2022-03-30T02:20:44Z" } ] }

返回的数据:

  • total:数据量。
  • score:诊断分数。
  • diagnosticTime:诊断生成时间(UTC 时间)。
  • startTime:查询开始时间(UTC 时间)。
  • endTime:查询结束时间(UTC 时间)。
Code String 200

返回的状态码。

Success String true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeDiagnosticReportList
&DBInstanceId=rm-2ze8g2am97624****
&PageNo=1
&PageSize=10
&StartTime=1648605944000
&EndTime=1648608644000
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDiagnosticReportListResponse>
    <RequestId>ac544623-f6ad-45fd-9a74-9be3db65****</RequestId>
    <Message>Successful</Message>
    <Synchro>None</Synchro>
    <Data>{     "total": 1,     "list": [       {         "score": 100,         "diagnosticTime": "2022-03-30T02:35:34Z",         "startTime": "2022-03-30T02:05:44Z",         "endTime": "2022-03-30T02:20:44Z"       }     ]   }</Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeDiagnosticReportListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "ac544623-f6ad-45fd-9a74-9be3db65****",
  "Message" : "Successful",
  "Synchro" : "None",
  "Data" : "{     \"total\": 1,     \"list\": [       {         \"score\": 100,         \"diagnosticTime\": \"2022-03-30T02:35:34Z\",         \"startTime\": \"2022-03-30T02:05:44Z\",         \"endTime\": \"2022-03-30T02:20:44Z\"       }     ]   }",
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

访问错误中心查看更多错误码。