調用DescribeTopHotKeys接口,獲取一段時間內排名前100的熱Key。
接口說明
當某個 Key 的 QPS 大于 3,000 時會被記錄為熱點 Key。
- 在使用阿里云 SDK 時,需要保證 aliyun-sdk-core 的版本大于 4.3.3,建議使用最新版本。
- 使用 DAS 的 SDK 的版本為 1.0.2 或以上。
- 在使用 SDK 調用 DAS 服務時,需要將地域指定為 cn-shanghai。
- 本接口只適用于如下 Redis 實例:
- 實例為社區版(4.0 及以上版本)或企業版(性能增強型)。
- 實例的小版本為最新。
說明
關于如何查詢小版本、升級小版本,詳情請參見 DescribeEngineVersion 、 ModifyInstanceMinorVersion 。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
hdm:DescribeTopHotKeys | get | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ConsoleContext | string | 否 | 備用參數。 | None |
InstanceId | string | 是 | Redis 實例 ID,您可以調用 DescribeInstances 接口獲取。 | r-bp18ff4a195d**** |
NodeId | string | 否 | Redis 實例的數據分片 ID,您可以調用 DescribeRoleZoneInfo 接口獲取。 | r-****-db-0 |
StartTime | string | 是 | 查詢任務開始時間,格式為 Unix 時間戳,單位為毫秒。 | 1596177993000 |
EndTime | string | 是 | 查詢任務結束時間,格式為 Unix 時間戳,單位為毫秒。 說明
| 1596177993001 |
返回參數
示例
正常返回示例
JSON
格式
{
"Message": "Successful",
"RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Data": {
"HotKey": [
{
"Db": 0,
"Key": "abc:def:eng",
"Hot": "5500~6000",
"KeyType": "zset",
"Lfu": 253,
"NodeId": "r-x****-db-0"
}
]
},
"Code": "200",
"Success": "true"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 請求參數錯誤 |
403 | NoPermission | You are not authorized to do this action. | 沒有權限執行該操作 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|
暫無變更歷史