Queries the hot keys of a specified ApsaraDB for Redis instance.

Before you call this operation, make sure that the following requirements are met:

  • 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 DescribeHotKeys operation is available only for ApsaraDB for Redis instances that meet the following requirements:
    • 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.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeHotKeys

The operation that you want to perform. Set the value to DescribeHotKeys

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-x****-db-0

The ID of the data shard on the ApsaraDB for Redis instance. You can call the DescribeRoleZoneInfo operation to query the ID.

Response parameters

Parameter Type Example Description
Message String Successful

The message that is returned for the request.

Note If the request is successful, Successful is returned. If the request fails, an error message that contains information such as an error code is returned.
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

The ID of the request.

Data Array of HotKey

Details about the hot keys.

HotKey
Key String abc:def:eng

The name of the key.

Db Integer 0

The database in which the key is stored.

Hot String 5500~6000

The frequency at which the key is accessed, which indicates the queries per second (QPS) of the key.

KeyType String zset

The type of the key.

Size Long 2

The number of elements in the key.

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=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<Common request parameters>

Sample success responses

XML format 

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

<DescribeHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Size>2</Size>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotKeysResponse>

JSON format 

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Key" : "abc:def:eng",
    "Db" : 0,
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Size" : 2
  } ],
  "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.