Queries the top 20 big keys over a period of time.

If the value of the Size parameter of a key ranks among the top three, the key is considered to be a big key.

  • When 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 Database Autonomy Service (DAS) SDK must be V1.0.2 or later.
  • When you call this operation to use DAS, you must specify cn-shanghai as the region.
  • This operation is applicable only to ApsaraDB for Redis instances that meet the following requirements:
    • Community Edition, ApsaraDB for Redis V4.0 or V5.0, minor version 0.4.0 or later
    • Enhanced Edition, ApsaraDB for Redis V5.0, minor version 1.5.1 or later
Note For information about how to query and update the minor version of an instance, see ModifyInstanceMinorVersion and DescribeEngineVersion.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeTopBigKeys

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

ConsoleContext String No None

A hidden 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-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.

StartTime String Yes 1596177993000

The beginning of the time range to query. Specify the time in the UNIX timestamp format. Unit: milliseconds.

EndTime String Yes 1596177993001

The end of the time range to query. Specify the time in the UNIX timestamp format. Unit: milliseconds.

Note
  • The end time must be later than the start time.
  • You can query only the data within the last four days.
  • The maximum interval between the start time and the end time is 3 hours.

Response parameters

Parameter Type Example Description
Message String Successful

The message returned for the request.

RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

The ID of the request.

Data Array of BigKey

The details about the big keys.

BigKey
Key String abc:def:eng

The name of the key.

Db Integer 0

The database in which the key is stored.

KeyType String zset

The type of the key.

Size Long 2

The number of elements in the key.

NodeId String r-x****-db-0

The ID of the data shard on the ApsaraDB for Redis instance.

Code String 200

The returned status code.

Success String true

Indicates whether the request is successful. Valid values:

  • true: The request is successful.
  • false: The request failed.

Examples

Sample requests

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeTopBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&StartTime=1596177993000
&EndTime=1596177993001
&<Common request parameters>

Sample success responses

XML format

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

<DescribeTopBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <KeyType>zset</KeyType>
        <Size>2</Size>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopBigKeysResponse>

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,
    "KeyType" : "zset",
    "Size" : 2,
    "NodeId" : "r-x****-db-0"
  } ],
  "Code" : "200",
  "Success" : "true"
}

Error codes

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