DescribeHotBigKeys - 数据库自治服务 DAS

对数据结构为List、Hash、Set、Zset的Key，按照Key中元素的数量排序并展示排名前3的Key，记录为大Key；当某个Key的QPS大于3,000时会被记录为热点Key。

在使用阿里云SDK时，需要保证aliyun-sdk-core的版本大于4.3.3，建议使用最新版本。
使用DAS的SDK的版本为1.0.2或以上。
在使用SDK调用DAS服务时，需要将地域指定为cn-shanghai。
本接口只适用于如下Redis实例：
- 实例为社区版（5.0及以上版本）或企业版（性能增强型）。
- 实例的小版本为最新。

说明关于如何查询小版本、升级小版本，详情请参见ModifyInstanceMinorVersion、DescribeEngineVersion。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeHotBigKeys	系统规定参数。取值：DescribeHotBigKeys。
ConsoleContext	String	否	None	备用参数。
InstanceId	String	是	r-bp18ff4a195d****	Redis实例ID，您可以调用DescribeInstances接口获取。
NodeId	String	否	r-****-db-0	Redis实例的数据分片ID，您可以调用DescribeRoleZoneInfo接口获取。

返回数据


名称	类型	示例值	描述
Message	String	Successful	请求返回消息。
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	请求ID。
Data	Object		详情信息列表。
HotKeys	Array of HotKey		热键详细列表。
HotKey
Key	String	abc:def:eng	具体的Key。
Db	Integer	0	Key所在的DB。
Hot	String	5500~6000	Key的访问频次，即Key的每秒访问数。
KeyType	String	zset	Key的类型。
Lfu	Integer	253	LFU算法的统计值。
NodeId	String	r-x****-db-0	Redis实例的数据分片ID。
BigKeys	Array of BigKey		大Key的详细列表。
BigKey
Db	Integer	0	Key所在的DB。
Key	String	abc:def:eng	具体的Key。
KeyType	String	zset	Key类型。
Size	Long	2	元素的个数。
NodeId	String	r-x****-db-0	Redis实例的数据分片ID。
HotKeyMsg	String	current version doesn't support	获取热Key失败的原因。
BigKeyMsg	String	current version doesn't support	获取大Key失败的原因。
Code	String	200	返回的状态码。
Success	String	true	请求是否执行成功： true：执行成功。 false：执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-****-db-0
&公共请求参数

正常返回示例

XML格式

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

<DescribeHotBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <HotKeys>
            <Key>abc:def:eng</Key>
            <Db>0</Db>
            <Hot>5500~6000</Hot>
            <KeyType>zset</KeyType>
            <Lfu>253</Lfu>
            <NodeId>r-x****-db-0</NodeId>
        </HotKeys>
        <BigKeys>
            <Db>0</Db>
            <Key>abc:def:eng</Key>
            <KeyType>zset</KeyType>
            <Size>2</Size>
            <NodeId>r-x****-db-0</NodeId>
        </BigKeys>
        <HotKeyMsg>current version doesn't support</HotKeyMsg>
        <BigKeyMsg>current version doesn't support</BigKeyMsg>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotBigKeysResponse>

JSON格式

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "HotKeys" : [ {
      "Key" : "abc:def:eng",
      "Db" : 0,
      "Hot" : "5500~6000",
      "KeyType" : "zset",
      "Lfu" : 253,
      "NodeId" : "r-x****-db-0"
    } ],
    "BigKeys" : [ {
      "Db" : 0,
      "Key" : "abc:def:eng",
      "KeyType" : "zset",
      "Size" : 2,
      "NodeId" : "r-x****-db-0"
    } ],
    "HotKeyMsg" : "current version doesn't support",
    "BigKeyMsg" : "current version doesn't support"
  },
  "Code" : "200",
  "Success" : "true"
}

错误码


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

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