调用GetAsyncErrorRequestStatByCode接口,异步查询数据库实例SQL洞察结果中的MySQL错误码以及每个错误码对应的SQL数量。
接口说明
异步调用后不会立即返回完整结果,当返回数据中 isFinish 取值为 false 时,请等待 1s 后重新发起调用,直到 isFinish 取值为 true 时,返回完整结果。
目前仅支持 RDS MySQL 和 PolarDB MySQL 版实例,请确保在使用该接口前,该实例已经开启 DAS 企业版,具体请参见购买 DAS 企业版。
在使用 SDK 调用 DAS 服务时,需要将地域指定为 cn-shanghai。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
hdm:GetAsyncErrorRequestStatByCode |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID。 |
rm-2ze8g2am97624**** |
| NodeId |
string |
否 |
节点 ID。 说明
对于 PolarDB MySQL 版实例,需要提供节点 ID。 |
pi-wz9s658475e58**** |
| Start |
integer |
否 |
查询开始时间,格式为 Unix 时间戳,单位为毫秒。 说明
查询开始时间需在数据库实例 SQL 洞察存储时长范围内,最大不能早于当前时间 90 天。 |
1642556990714 |
| End |
integer |
否 |
查询的结束时间,格式为 Unix 时间戳,单位为毫秒。 说明
查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过 1 天。 |
1642566830000 |
| DbName |
string |
否 |
数据库名称。 |
testdb01 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Code |
integer |
返回的状态码。 |
200 |
| Message |
string |
请求返回消息。 说明
请求成功时该参数返回 Successful,请求失败时会返回请求异常信息(如错误码等)。 |
Successful |
| Data |
object |
返回的数据。 |
{ "fail": false, "data": [ { "instanceId": "rm-2ze8g2am97624****", "count": 1, "errorCode": "1062" }, { "instanceId": "rm-2ze8g2am97624****", "count": 2, "errorCode": "1064" } ], "resultId": "async__fcd7c35788e62324622c3b4a03de****", "isFinish": true, "state": "SUCCESS", "complete": true, "timestamp": 1644560866961 } |
| fail |
boolean |
请求是否失败:
|
false |
| isFinish |
boolean |
异步请求是否执行完成:
|
true |
| resultId |
string |
异步请求 ID。 |
async__fcd7c35788e62324622c3b4a03de**** |
| state |
string |
异步请求的执行状态:
|
SUCCESS |
| timestamp |
integer |
执行时间,格式为 Unix 时间戳,单位为毫秒。 |
1644560866961 |
| complete |
boolean |
异步请求是否完成:
|
true |
| result |
array<object> |
返回的错误码以及每个错误码对应的 SQL 数量列表。 |
|
|
object |
返回的错误码以及每个错误码对应的 SQL 数量列表。 |
||
| instanceId |
string |
实例 ID。 |
rm-2ze8g2am97624**** |
| errorCode |
string |
错误码。 |
1062 |
| count |
integer |
错误码对应 SQL 的数量。 |
1 |
| RequestId |
string |
请求的 ID。 |
840F51F7-9C01-538D-94F6-AE712905**** |
| Success |
boolean |
请求是否执行成功:
|
true |
示例
正常返回示例
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
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
| 403 | NoPermission | You are not authorized to do this action. | 没有权限执行该操作 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。