调用GetDeadlockHistogram接口查询死锁数量趋势-数据库自治服务-阿里云

查询时间范围内基于错误日志全量死锁分析的死锁数量趋势。

接口说明

本接口用于查询时间范围内全量死锁分析的死锁数量。DAS 定时对错误日志进行分析，解析其中的死锁信息，并统计死锁的数量趋势。详情请参见全量死锁分析。

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

目标数据库引擎为：RDS MySQL、PolarDB MySQL 版，且已开通DAS 运维服务（原经济版）。
使用阿里云或 DAS 的 SDK 时，建议使用最新版本。
使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hdm:GetDeadlockHistogram

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	pc-bp1u5mas9exx7****
NodeId	string	否	节点 ID。说明对于 PolarDB MySQL 版实例，需要提供节点 ID。	pi-bp16v3824rt73****
StartTime	integer	是	查询开始时间，格式为 Unix 时间戳，单位为毫秒。说明查询开始时间最大不能早于结束时间 7 天。重要该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。	1731983066000
EndTime	integer	是	查询结束时间，格式为 Unix 时间戳，单位为毫秒。重要该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。	1732069466000
Status	string	否	任务的分析状态。	SUCCESS

返回参数

名称	类型	描述	示例值
	object
Code	integer	返回的状态码。	200
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）。	Successful
RequestId	string	请求 ID。	0A74B755-98B7-59DB-8724-1321B394****
Success	boolean	请求是否执行成功： true：执行成功。 false：执行失败。枚举值：执行成功 : true 执行失败 : false	true
Data	array<object>	返回数据。
	object	返回信息列表。
UserId	string	用户 ID。	108************
InstanceId	string	实例 ID。	pc-bp1u5mas9exx7****
NodeId	string	节点 ID，对 PolarDB MySQL 集群使用。	pi-bp16v3824rt73****
TaskId	string	全量死锁分析任务 ID。	B6D17591-B48B-4D31-9CD6-1321B394****
StartTime	string	分析任务范围的开始时间。	1729994400000
EndTime	string	分析任务范围的结束时间。	1729998000000
LockNumber	integer	死锁数量。	2
Status	string	任务状态： SUCCESS: 分析成功。 FAILED: 分析异常或失败。	SUCCESS

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "Successful",
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Success": true,
  "Data": [
    {
      "UserId": "108************",
      "InstanceId": "pc-bp1u5mas9exx7****",
      "NodeId": "pi-bp16v3824rt73****",
      "TaskId": "B6D17591-B48B-4D31-9CD6-1321B394****",
      "StartTime": "1729994400000",
      "EndTime": "1729998000000",
      "LockNumber": 2,
      "Status": "SUCCESS"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

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

变更历史

更多信息，参考变更详情。