DescribeTopHotKeys -

If the number of queries per second (QPS) of a key is greater than 3,000, the key is considered a hot key.

If 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 version of your Database Autonomy Service (DAS) SDK must be V1.0.2 or later.
If you use an SDK to call DAS, you must set the region to cn-shanghai.
The DescribeTopHotKeys operation is available only for ApsaraDB for Redis instances of the following versions:
- The instance is a Community Edition instance that uses a major version of 5.0 or later or a performance-enhanced instance of the Enhanced Edition (Tair).
- The instance is updated to the latest minor version.

Note For information about how to query and update the minor version of a database instance, see DescribeEngineVersion and ModifyInstanceMinorVersion.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeTopHotKeys	The operation that you want to perform. Set the value to DescribeTopHotKeys.
ConsoleContext	String	No	None	A reserved parameter.
InstanceId	String	Yes	r-bp18ff4a195d****	The ID of the ApsaraDB for Redis instance. You can call the DescribeInstances operation to query the ID.
NodeId	String	No	r-****-db-0	The ID of the data shard on the ApsaraDB for Redis instance. You can call the DescribeRoleZoneInfo operation to query the ID.
StartTime	String	Yes	1596177993000	The beginning of the time range to query. Set this parameter to a UNIX timestamp. Unit: milliseconds.
EndTime	String	Yes	1596177993001	The end of the time range to query. Set this parameter to a UNIX timestamp. Unit: milliseconds. Note The end time must be later than the start time. Only data within the last four days can be queried. The maximum interval between the time specified by StartTime and that specified by EndTime is three hours.

Response parameters


Parameter	Type	Example	Description
Message	String	Successful	The message that is returned for the request.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	The ID of the request.
Data	Array of HotKey		Details about the hot keys.
HotKey
Db	Integer	0	The database in which the key is stored.
Key	String	abc:def:eng	The name of the key.
Hot	String	5500~6000	The frequency at which the key is accessed, which indicates the QPS of the key.
KeyType	String	zset	The type of the key.
Lfu	Integer	253	The statistical value that is calculated based on the least frequently used (LFU) caching algorithm.
NodeId	String	r-x****-db-0	The ID of the data shard on the ApsaraDB for Redis instance.
Code	String	200	The returned HTTP status code.
Success	String	true	Indicates whether the request was successful. Valid values: true: The request was successful. false: The request failed.

Examples

Sample requests

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeTopHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-****-db-0
&StartTime=1596177993000
&EndTime=1596177993001
&<Common request parameters>

Sample success responses

XML format

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

<DescribeTopHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Db>0</Db>
        <Key>abc:def:eng</Key>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Lfu>253</Lfu>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopHotKeysResponse>

JSON format

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Db" : 0,
    "Key" : "abc:def:eng",
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Lfu" : 253,
    "NodeId" : "r-x****-db-0"
  } ],
  "Code" : "200",
  "Success" : "true"
}

Error codes


HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.	The error message returned because the specified request parameters are invalid.

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