调用DescribeHotKeys接口查询Redis实例的热Key。

使用该接口需满足以下前提条件：

  • 本接口只适用于Redis引擎。
  • 在使用阿里云SDK时，需要保证aliyun-sdk-core的版本大于4.3.3，建议使用最新版本。
  • 使用DAS的SDK的版本为1.0.2或以上。
  • 在使用SDK调用DAS服务时，需要将地域指定为cn-shanghai。

请求参数

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

系统规定参数，取值：DescribeHotKeys。

InstanceId String 否 r-bp18ff4a195d****

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

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

Redis的节点ID，您可以调用DescribeRoleZoneInfo接口查看返回的InsName参数。

返回数据

名称 类型 示例值 描述
Code String 200

返回的状态码。
Data Array of HotKey

详细信息列表。
HotKey
Db Integer 0

数据库实例。
Hot String 5500~6000

访问频次。
Key String BACKUP

实例分片ID。
KeyType String zset

Key类型。
Size Long 12345

Key元素的个数。
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful，请求失败时会返回请求异常信息（如错误码等）。
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

请求ID。
Success String true

请求是否执行成功：

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

示例

请求示例

http(s)://https://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<公共请求参数>

正常返回示例

XML格式 

<DescribeHotKeysReponse>
  <RequestId> B6D17591-B48B-4D31-9CD6-9B9796B2270A</RequestId>
  <Message>Successful</Message>
  <Data>
        <HotKey>
              <KeyType>zset</KeyType>
              <Hot>5500~6000</Hot>
              <Size>12345</Size>
              <Key>BACKUP</Key>
              <Db>0</Db>
        </HotKey>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</DescribeHotKeysReponse>

JSON格式 

{"RequestId":" B6D17591-B48B-4D31-9CD6-9B9796B2270A",
"Message":"Successful",
"Data":{
    "HotKey":[{
        "KeyType":"zset",
        "Hot":"5500~6000",
        "Size":"12345",
        "Key":"BACKUP",
        "Db":"0"}]},
        "Code":"200",
        "Success":"true"}

错误码

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