调用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 |
请求是否执行成功:
|
示例
请求示例
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"}
错误码
访问错误中心查看更多错误码。