DescribeHotKeys - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

Si vous utilisez un SDK Alibaba Cloud, assurez-vous que la version de aliyun-sdk-core est supérieure à la V4.3.3. Nous vous recommandons d'utiliser la dernière version.
La version de votre SDK Database Autonomy Service (DAS) doit être la V1.0.2 ou une version ultérieure.
Si vous utilisez un SDK pour appeler DAS, définissez la région sur cn-shanghai.
L'opération DescribeHotKeys est disponible uniquement pour les instances ApsaraDB for Redis qui répondent aux exigences suivantes :
- L'instance est une instance Community Edition utilisant une version majeure 5.0 ou ultérieure, ou une instance performance-enhanced de l'édition Enhanced Edition (Tair).
- L'instance utilise la dernière version mineure.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeHotKeys	L'opération à effectuer. Définissez la valeur sur DescribeHotKeys
InstanceId	String	Oui	r-bp18ff4a195d****	L'ID de l'instance ApsaraDB for Redis. Appelez l'opération DescribeInstances pour obtenir l'ID.
NodeId	String	Non	r-x****-db-0	L'ID du shard de données sur l'instance ApsaraDB for Redis. Appelez l'opération DescribeRoleZoneInfo pour obtenir l'ID.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Message	String	Successful	Le message renvoyé pour la requête. Remarque Si la requête aboutit, la valeur Successful est renvoyée. En cas d'échec, un message d'erreur contenant des informations telles qu'un code d'erreur est renvoyé.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	L'ID de la requête.
Data	Array of HotKey		Détails sur les clés à fort trafic.
HotKey
Key	String	abc:def:eng	Le nom de la clé.
Db	Integer	0	La base de données dans laquelle la clé est stockée.
Hot	String	5500~6000	La fréquence d'accès à la clé, qui indique le nombre de requêtes par seconde (QPS) de la clé.
KeyType	String	zset	Le type de la clé.
Size	Long	2	Le nombre d'éléments dans la clé.
Code	String	200	Le code d'état HTTP renvoyé.
Success	String	true	Indique si la requête a abouti. Valeurs possibles : true : La requête a abouti. false : La requête a échoué.

Exemples

Exemple de requête

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<Common request parameters>

Exemple de réponse réussie

Format 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>

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParams	The request parameters are invalid.	Les paramètres de requête spécifiés ne sont pas valides.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.