调用DescribeTopBigKeys接口，获取一段时间内排名前100的大Key。

对数据结构为List、Hash、Set、Zset的Key，按照Key中元素的数量排序并展示排名前3的Key，记录为大Key。

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeTopBigKeys

系统规定参数。取值：DescribeTopBigKeys。

ConsoleContext String 否 None

备用参数。
InstanceId String 是 r-bp18ff4a195d****

Redis实例ID，您可以调用DescribeInstances接口获取。

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

Redis实例的数据分片ID，您可以调用DescribeRoleZoneInfo接口获取。

StartTime String 是 1596177993000

查询任务开始时间，格式为Unix时间戳，单位为毫秒。
EndTime String 是 1596177993001

查询任务结束时间，格式为Unix时间戳，单位为毫秒。

说明
  • 查询任务结束时间需晚于查询任务开始时间。
  • 仅支持最大查询时间范围为4天内的数据。
  • StartTime和EndTime最大查询间隔为3小时内。

返回数据

名称 类型 示例值 描述
Message String Successful

请求返回消息。
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

请求ID。
Data Array of BigKey

大Key详细信息列表。

说明 查询时间段内没有大Key时，返回为空。
BigKey
Key String abc:def:eng

具体的Key。
Db Integer 0

Key所在的DB。
KeyType String zset

Key的类型。
Size Long 2

元素的个数。
NodeId String r-x****-db-0

Redis实例的数据分片ID。
Code String 200

返回的状态码。
Success String true

请求是否执行成功：

  • true：执行成功。
  • false：执行失败。

示例

请求示例

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
&公共请求参数

正常返回示例

XML格式 

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格式 

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"
}

错误码

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

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