调用GetAsyncErrorRequestStatByCode接口,异步查询数据库实例SQL洞察结果中的MySQL错误码以及每个错误码对应的SQL数量。
说明 异步调用后不会立即返回完整结果,当返回数据中isFinish取值为false时,请等待1s后重新发起调用,直到isFinish取值为true时,返回完整结果。
- 目前仅支持RDS MySQL和PolarDB MySQL版实例,请确保在使用该接口前,该实例已经开启DAS专业版,具体请参见购买DAS专业版。
- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | GetAsyncErrorRequestStatByCode | 系统规定参数。取值:GetAsyncErrorRequestStatByCode。 |
| InstanceId | String | 是 | rm-2ze8g2am97624**** | 实例ID。 |
| NodeId | String | 否 | pi-wz9s658475e58**** | 节点ID。 说明 对于PolarDB MySQL版实例,需要提供节点ID。 |
| Start | Long | 否 | 1642556990714 | 查询开始时间,格式为Unix时间戳,单位为毫秒。 说明 查询开始时间需在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。 |
| End | Long | 否 | 1642566830000 | 查询的结束时间,格式为Unix时间戳,单位为毫秒。 说明 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。 |
| DbName | String | 否 | testdb01 | 数据库名称。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | Long | 200 | 返回的状态码。 |
| Message | String | Successful | 请求返回消息。 说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。 |
| Data | Object | 返回的数据。 |
|
| fail | Boolean | false | 请求是否失败:
|
| isFinish | Boolean | true | 异步请求是否执行完成:
|
| resultId | String | async__fcd7c35788e62324622c3b4a03de**** | 异步请求ID。 |
| state | String | SUCCESS | 异步请求的执行状态:
|
| timestamp | Long | 1644560866961 | 执行时间,格式为Unix时间戳,单位为毫秒。 |
| complete | Boolean | true | 异步请求是否完成:
|
| result | Array of stat | 返回的错误码以及每个错误码对应的SQL数量列表。 |
|
| instanceId | String | rm-2ze8g2am97624**** | 实例ID。 |
| errorCode | String | 1062 | 错误码。 |
| count | Integer | 1 | 错误码对应SQL的数量。 |
| RequestId | String | 840F51F7-9C01-538D-94F6-AE712905**** | 请求的ID。 |
| Success | Boolean | true | 请求是否执行成功:
|
示例
请求示例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetAsyncErrorRequestStatByCode
&InstanceId=rm-2ze8g2am97624****
&Start=1642556990714
&End=1642566830000
&DbName=testdb01
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetAsyncErrorRequestStatByCodeResponse>
<Code>200</Code>
<Message>Successful</Message>
<Data>
<fail>false</fail>
<isFinish>true</isFinish>
<resultId>async__fcd7c35788e62324622c3b4a03de****</resultId>
<state>SUCCESS</state>
<timestamp>1644560866961</timestamp>
<complete>true</complete>
<result>
<instanceId>rm-2ze8g2am97624****</instanceId>
<errorCode>1062</errorCode>
<count>1</count>
</result>
</Data>
<RequestId>840F51F7-9C01-538D-94F6-AE712905****</RequestId>
<Success>true</Success>
</GetAsyncErrorRequestStatByCodeResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Code" : 200,
"Message" : "Successful",
"Data" : {
"fail" : false,
"isFinish" : true,
"resultId" : "async__fcd7c35788e62324622c3b4a03de****",
"state" : "SUCCESS",
"timestamp" : 1644560866961,
"complete" : true,
"result" : [ {
"instanceId" : "rm-2ze8g2am97624****",
"errorCode" : "1062",
"count" : 1
} ]
},
"RequestId" : "840F51F7-9C01-538D-94F6-AE712905****",
"Success" : true
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
访问错误中心查看更多错误码。