指定した ApsaraDB for Redis インスタンスのホットキーを照会します。
この操作を呼び出す前に、次の要件が満たされていることを確認してください。
Alibaba Cloud SDK を使用する場合は、aliyun-sdk-core のバージョンが V4.3.3 以降であることを確認してください。 最新バージョンを使用することをお勧めします。
Database Autonomy Service (DAS) SDK のバージョンは V1.0.2 以降である必要があります。
SDK を使用して DAS を呼び出す場合は、リージョンを cn-shanghai に設定する必要があります。
DescribeHotKeys 操作は、次の要件を満たす ApsaraDB for Redis インスタンスでのみ使用できます。
インスタンスは、メジャーバージョン 5.0 以降を使用するコミュニティ版インスタンス、または拡張版 (Tair) の拡張パフォーマンスインスタンスです。
インスタンスは最新のマイナーバージョンに更新されています。
リクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
Action | String | はい | DescribeHotKeys | 実行する操作。 値を DescribeHotKeys に設定します。 |
InstanceId | String | はい | r-bp18ff4a195d**** | ApsaraDB for Redis インスタンスの ID。 |
NodeId | String | いいえ | r-x****-db-0 | ApsaraDB for Redis インスタンス上のデータシャードの ID。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
Message | String | Successful | リクエストに対して返されるメッセージ。 説明 リクエストが成功した場合、Successful が返されます。 リクエストが失敗した場合、エラーコードなどの情報を含むエラーメッセージが返されます。 |
RequestId | String | B6D17591-B48B-4D31-9CD6-9B9796B2**** | リクエストの ID。 |
Data | HotKey の配列 | ホットキーの詳細。 | |
HotKey | |||
Key | String | abc:def:eng | キーの名前。 |
Db | Integer | 0 | キーが格納されているデータベース。 |
Hot | String | 5500~6000 | キーがアクセスされる頻度。キーのクエリ/秒 (QPS) を示します。 |
KeyType | String | zset | キーのタイプ。 |
Size | Long | 2 | キー内の要素の数。 |
Code | String | 200 | 返された HTTP ステータスコード。 |
Success | String | true | リクエストが成功したかどうかを示します。有効な値：
|
例
リクエストの例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<共通リクエストパラメーター>成功レスポンスの例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeHotKeysResponse>
<Message>Successful</Message>
<RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
<Data>
<Key>abc:def:eng</Key>
<Db>0</Db>
<Hot>5500~6000</Hot>
<KeyType>zset</KeyType>
<Size>2</Size>
</Data>
<Code>200</Code>
<Success>true</Success>
</DescribeHotKeysResponse>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,
"Hot" : "5500~6000",
"KeyType" : "zset",
"Size" : 2
} ],
"Code" : "200",
"Success" : "true"
}エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
400 | InvalidParams | リクエストパラメーターが無効です。 | 指定されたリクエストパラメーターが無効なために返されたエラーメッセージ。 |
エラーコードの一覧については、API エラーセンターをご覧ください。