DescribeTopBigKeys - - Centre de documentation Alibaba Cloud

Les clés de type list, hash, set et zset sont triées selon le nombre d'éléments qu'elles contiennent. Les trois clés comportant le plus grand nombre d'éléments sont considérées comme des grandes clés.

Si vous utilisez un SDK Alibaba Cloud, assurez-vous que la version de aliyun-sdk-core est supérieure à 4.3.3. Nous vous recommandons d'utiliser la dernière version disponible.
La version du SDK DAS doit être égale ou supérieure à 1.0.2.
Lorsque vous appelez Database Autonomy Service (DAS) via un SDK, définissez la région sur cn-shanghai.
L'opération DescribeTopBigKeys est disponible uniquement pour les instances ApsaraDB for Redis répondant aux critères suivants :
- Il s'agit d'instances ApsaraDB for Redis Community Edition utilisant une version majeure 5.0 ou ultérieure, ou d'instances optimisées pour les performances de l'édition ApsaraDB for Redis Enhanced Edition (Tair).
- L'instance ApsaraDB for Redis dispose de la dernière version mineure.

Remarque

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

ModifyInstanceMinorVersion

et

DescribeEngineVersion

.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeTopBigKeys	Nom de l'opération à exécuter. Définissez la valeur sur DescribeTopBigKeys.
ConsoleContext	String	No	None	Paramètre réservé.
InstanceId	String	Yes	r-bp18ff4a195d****	ID de l'instance ApsaraDB for Redis. Vous pouvez appeler l'opération DescribeInstances pour obtenir cet ID.
NodeId	String	No	r-x****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis. Vous pouvez appeler l'opération DescribeRoleZoneInfo pour obtenir cet ID.
StartTime	String	Yes	1596177993000	Début de la plage de temps à interroger. La valeur de ce paramètre est un horodatage UNIX exprimé en millisecondes.
EndTime	String	Yes	1596177993001	Fin de la plage de temps à interroger. La valeur de ce paramètre est un horodatage UNIX exprimé en 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 de début et l'heure de fin est de 3 heures.

Paramètres de réponse

Parameter	Type	Example	Description
Message	String	Successful	Message renvoyé pour la requête.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID de la requête.
Data	Array of BigKey		Détails concernant les grandes clés. Remarque Si aucune grande clé n'est trouvée durant la période d'interrogation, aucun résultat n'est renvoyé.
BigKey
Key	String	abc:def:eng	Nom de la clé.
Db	Integer	0	Base de données dans laquelle la clé est stockée.
KeyType	String	zset	Type de la clé.
Size	Long	2	Nombre d'éléments contenus dans la clé.
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 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=DescribeTopBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&StartTime=1596177993000
&EndTime=1596177993001
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<DescribeTopBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <KeyType>zset</KeyType>
        <Size>2</Size>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeTopBigKeysResponse>

JSON format

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Key" : "abc:def:eng",
    "Db" : 0,
    "KeyType" : "zset",
    "Size" : 2,
    "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.	Le message d'erreur indique que les paramètres de requête spécifiés ne sont pas valides.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.