Queries diagnostic reports.

Database Autonomy Service (DAS) regularly inspects all the database instances that are connected to DAS and generates health scores. This way, the running status of databases is clear at a glance.

Before you call this operation, make sure that the following conditions are met:

  • This operation is applicable to only the ApsaraDB RDS for MySQL and ApsaraDB for Redis engines.
  • When you use an Alibaba Cloud SDK, make sure that the aliyun-sdk-core version is later than V4.3.3. We recommend that you use the latest version.
  • The SDK version for DAS must be V1.0.2 or later.
  • When you use the SDK to call the DAS service, you must specify the region as cn-shanghai.

Request parameters

Parameter Type Required Example Description
Action String No DescribeDiagnosticReportList

The operation that you want to perform. Set the value to DescribeDiagnosticReportList.

Uid String No hdm_df02bbfd3bd64c7bb1982e5323a67944

A hidden parameter.

accessKey String No None

A hidden parameter.

signature String No None

A hidden parameter.

timestamp String No None

A hidden parameter.

__context String No None

A hidden parameter.

skipAuth String No None

A hidden parameter.

UserId String No None

A hidden parameter.

DBInstanceId String No r-bp18ff4a195d****

The ID of the instance.

PageNo String No 1

The number of the page to return. The value must be a positive integer that does not exceed the maximum value of the Integer data type.

PageSize String No 1

The number of entries to return on each page. Default value: 1.

StartTime String No 1596177993000

The start time of the query task. Specify the time in the UNIX timestamp format. Unit: ms.

EndTime String No 1596177993000

The end time of the query task. Specify the time in the UNIX timestamp format. Unit: ms.

Note The end time of the query task must be later than the start time of the query task.

Response parameters

Parameter Type Example Description
Code String 200

The returned status code.

Data String { "cpuUsage": 0.00029999999999999894, "maxConnection": 32532, "slowSqlCount": 0, "exceptionTableMap": { "table_space": 1, "table_row": 1 },

The list of diagnostic reports. The following list describes the parameters:

  • diagnosticTime: the time when the diagnostic report is generated.
  • startTime: the start time of the query task.
  • endTime: the end time of the query task.
  • score: the health score of the database.
  • downloadURL: the link for downloading the diagnostic report.
Message String Successful

The returned message.

Note If the request is successful, Successful is returned. If the request fails, a request exception message, such as an error code, is returned.
RequestId String ac544623-f6ad-45fd-9a74-9be3db65****

The ID of the request.

Success String true

Indicates whether the request was successful.

  • true: The request was successful.
  • false: The request failed.
Synchro String None

A hidden parameter.

Examples

Sample requests

http(s)://das.cn-shanghai.aliyuncs.com//?Action=DescribeDiagnosticReportList
&StartTime=1608888296000
&EndTime=1608888296000
&<Common request parameters>

Sample success responses

XML format

<DescribeDiagnosticReportListReponse>
  <RequestId>ac544623-f6ad-45fd-9a74-9be3db65f938</RequestId>
  <Message>None</Message>
  <Synchro>None</Synchro>
  <Data></Data>
  <Code>200</Code>
  <Success>true</Success>
</DescribeDiagnosticReportListReponse>

JSON format

{"RequestId":"ac544623-f6ad-45fd-9a74-9be3db65f938",
"Message":"None",
"Synchro":"None",
"Data":"",
"Code":"200",
"Success":"true"}

Error codes

For a list of error codes, visit the API Error Center.