DescribeTopHotKeys - - Centre de documentation Alibaba Cloud

Une clé est considérée comme chaude lorsque son nombre de requêtes par seconde (QPS) dépasse 3 000.

Si vous utilisez un SDK Alibaba Cloud, assurez-vous que la version d'aliyun-sdk-core est supérieure à V4.3.3. Nous vous recommandons d'utiliser la version la plus récente.
La version de votre SDK Database Autonomy Service (DAS) doit être V1.0.2 ou ultérieure.
Pour appeler DAS via un SDK, définissez la région sur cn-shanghai.
L'opération DescribeTopHotKeys est disponible uniquement pour les instances ApsaraDB for Redis des versions suivantes :
- Instance Community Edition avec une version majeure 5.0 ou ultérieure, ou instance à performances améliorées de l'Enhanced Edition (Tair).
- Instance mise à jour vers la dernière version mineure.

Remarque

Pour plus d'informations sur la consultation et la mise à jour de la version mineure d'une instance de base de données, consultez

DescribeEngineVersion

et

ModifyInstanceMinorVersion

.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeTopHotKeys	Opération à exécuter. Définissez la valeur sur DescribeTopHotKeys.
ConsoleContext	String	No	None	Paramètre réservé.
InstanceId	String	Yes	r-bp18ff4a195d****	ID de l'instance ApsaraDB for Redis. Appelez l'opération DescribeInstances pour obtenir cet ID.
NodeId	String	No	r-****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis. Appelez l'opération DescribeRoleZoneInfo pour récupérer cet identifiant.
StartTime	String	Yes	1596177993000	Début de la plage horaire à interroger. Spécifiez ce paramètre sous forme d'horodatage UNIX. Unité : millisecondes.
EndTime	String	Yes	1596177993001	Fin de la plage horaire à interroger. Spécifiez ce paramètre sous forme d'horodatage UNIX. Unité : millisecondes. Remarque L'heure de fin doit être postérieure à l'heure de début. Seules les données des quatre derniers jours peuvent être interrogées. L'intervalle maximal entre l'heure spécifiée par StartTime et celle spécifiée par EndTime est de trois heures.

Paramètres de réponse

Parameter	Type	Example	Description
Message	String	Successful	Message retourné pour la requête.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID de la requête.
Data	Array of HotKey		Détails concernant les clés chaudes.
HotKey
Db	Integer	0	Base de données contenant la clé.
Key	String	abc:def:eng	Nom de la clé.
Hot	String	5500~6000	Fréquence d'accès à la clé, correspondant au QPS de celle-ci.
KeyType	String	zset	Type de la clé.
Lfu	Integer	253	Valeur statistique calculée selon l'algorithme de cache LFU (Least Frequently Used).
NodeId	String	r-x****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis.
Code	String	200	Code d'état HTTP retourné.
Success	String	true	Indique si la requête a réussi. Valeurs valides : true : la requête a réussi. false : la requête a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses en cas de succès

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTopHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Db>0</Db>
        <Key>abc:def:eng</Key>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Lfu>253</Lfu>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopHotKeysResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Db" : 0,
    "Key" : "abc:def:eng",
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Lfu" : 253,
    "NodeId" : "r-x****-db-0"
  } ],
  "Code" : "200",
  "Success" : "true"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.	Message d'erreur retourné lorsque 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.