Tous les produits
Search
Centre de documentation

:DescribeCacheAnalysisJob

Dernière mise à jour :Aug 10, 2026

Interroge les détails d'une tâche d'analyse du cache.

Avant d'appeler cette opération, tenez compte des points suivants :

  • Si vous utilisez un SDK Alibaba Cloud ou un SDK Database Autonomy Service (DAS) pour appeler cette opération, nous vous recommandons d'utiliser la dernière version du SDK.

  • Si vous utilisez un SDK pour appeler les opérations de DAS, définissez la région sur cn-shanghai.

  • Cette opération s'applique uniquement à ApsaraDB for Redis.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeCacheAnalysisJob

Opération à effectuer. Définissez la valeur sur DescribeCacheAnalysisJob.

InstanceId

String

Oui

r-bp18ff4a195d****

ID de l'instance.

JobId

String

Oui

sf79-sd99-sa37-****

ID de la tâche d'analyse du cache. Vous pouvez obtenir l'ID de la tâche à partir des paramètres de réponse de l'opération CreateCacheAnalysisJob.

Paramètres de réponse

Paramètre Type Exemple Description
Message String Successful

Message renvoyé pour la requête.

Remarque Si la requête aboutit, Successful est renvoyé. Si la requête échoue, un message d'erreur contenant des informations telles qu'un code d'erreur est renvoyé.
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

ID de la requête.

Data Object

Détails de la tâche.

TaskState String BACKUP

État de la tâche d'analyse du cache. Valeurs valides :

  • BACKUP : Sauvegarde des données en cours.
  • ANALYZING : Analyse des données en cours.
  • FINISHED : Données analysées.
  • FAILED : Une erreur s'est produite.
JobId String sf79-sd99-sa37-****

ID de la tâche d'analyse du cache.

Message String Successful

Message renvoyé pour la requête.

Remarque Si la requête aboutit, Successful est renvoyé. Si la requête échoue, un message d'erreur contenant des informations telles qu'un code d'erreur est renvoyé.
BigKeys Array of KeyInfo

Détails des grandes clés. Les grandes clés renvoyées sont triées par ordre décroissant selon le nombre d'octets occupés.

KeyInfo
Type String hash

Type de données de l'instance.

Db Integer 0

Nom de la base de données.

ExpirationTimeMillis Long 1596256542547

Durée d'expiration de la clé. Unité : millisecondes. La valeur 0 indique que la clé n'expire pas.

Key String task_x****

Nom de la clé.

Encoding String hashtable

Type d'encodage de la clé.

Bytes Long 12345

Nombre d'octets occupés par la clé.

NodeId String r-x****-db-0

ID du nœud de données sur l'instance.

Count Long 127

Nombre d'éléments dans la clé.

KeyPrefixes Array of Prefix

Préfixes des clés.

Prefix
KeyNum Long 123

Nombre de clés contenant le préfixe.

Type String hash

Type de données de l'instance.

Bytes Long 12345

Nombre d'octets occupés par la clé.

Prefix String task_

Préfixe de la clé.

Count Long 127

Nombre d'éléments dans la clé.

BigKeysOfNum Array of KeyInfo

Détails des grandes clés. Les grandes clés renvoyées sont triées par ordre décroissant selon le nombre de clés.

KeyInfo
Type String hash

Type de données de l'instance.

Db Integer 0

Nom de la base de données.

ExpirationTimeMillis Long 1596256542547

Durée d'expiration de la clé. Unité : millisecondes. La valeur 0 indique que la clé n'expire pas.

Key String task_x****

Nom de la clé.

Encoding String hashtable

Type d'encodage de la clé.

Bytes Long 12345

Nombre d'octets occupés par la clé.

NodeId String r-x****-db-0

ID du nœud de données sur l'instance.

Count Long 127

Nombre d'éléments dans la clé.

UnexBigKeysOfBytes Array of KeyInfo

Détails des clés permanentes. Les clés renvoyées sont triées par ordre décroissant selon le nombre d'octets occupés.

KeyInfo
Type String hash

Type de données de l'instance.

Db Integer 0

Nom de la base de données.

ExpirationTimeMillis Long 1596256542547

Durée d'expiration de la clé. Unité : millisecondes. La valeur 0 indique que la clé n'expire pas.

Key String task_x****

Nom de la clé.

Encoding String hashtable

Type d'encodage de la clé.

Bytes Long 12345

Nombre d'octets occupés par la clé.

NodeId String r-x****-db-0

ID du nœud de données sur l'instance.

Count Long 127

Nombre d'éléments dans la clé.

UnexBigKeysOfNum Array of KeyInfo

Détails des clés permanentes. Les clés renvoyées sont triées par ordre décroissant selon le nombre de clés.

KeyInfo
Type String hash

Type de données de l'instance.

Db Integer 0

Nom de la base de données.

ExpirationTimeMillis Long 1596256542547

Durée d'expiration de la clé. Unité : millisecondes. La valeur 0 indique que la clé n'expire pas.

Key String task_x****

Nom de la clé.

Encoding String hashtable

Type d'encodage de la clé.

Bytes Long 12345

Nombre d'octets occupés par la clé.

NodeId String r-x****-db-0

ID du nœud de données sur l'instance.

Count Long 127

Nombre d'éléments dans la clé.

InstanceId String r-bp18ff4a195d****

ID de l'instance de base de données.

NodeId String r-x****-db-0

ID du nœud de données sur l'instance.

Code String 200

Code d'état HTTP renvoyé.

Success String true

Indique si la requête a abouti. Valeurs valides :

  • true : La requête a abouti.
  • false : La requête a échoué.

Exemples

Exemple de requêtes

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeCacheAnalysisJob
&InstanceId=r-bp18ff4a195d****
&JobId=sf79-sd99-sa37-****
&Common request parameters

Exemple de réponses réussies

XML format

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

<DescribeCacheAnalysisJobResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <TaskState>BACKUP</TaskState>
        <JobId>sf79-sd99-sa37-****</JobId>
        <Message>Successful</Message>
        <BigKeys>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </BigKeys>
        <KeyPrefixes>
            <KeyNum>123</KeyNum>
            <Type>hash</Type>
            <Bytes>12345</Bytes>
            <Prefix>task_</Prefix>
            <Count>127</Count>
        </KeyPrefixes>
        <BigKeysOfNum>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </BigKeysOfNum>
        <UnexBigKeysOfBytes>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </UnexBigKeysOfBytes>
        <UnexBigKeysOfNum>
            <Type>hash</Type>
            <Db>0</Db>
            <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
            <Key>task_x****</Key>
            <Encoding>hashtable</Encoding>
            <Bytes>12345</Bytes>
            <NodeId>r-x****-db-0</NodeId>
            <Count>127</Count>
        </UnexBigKeysOfNum>
        <InstanceId>r-bp18ff4a195d****</InstanceId>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeCacheAnalysisJobResponse>

JSON format

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "TaskState" : "BACKUP",
    "JobId" : "sf79-sd99-sa37-****",
    "Message" : "Successful",
    "BigKeys" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "KeyPrefixes" : [ {
      "KeyNum" : 123,
      "Type" : "hash",
      "Bytes" : 12345,
      "Prefix" : "task_",
      "Count" : 127
    } ],
    "BigKeysOfNum" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "UnexBigKeysOfBytes" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "UnexBigKeysOfNum" : [ {
      "Type" : "hash",
      "Db" : 0,
      "ExpirationTimeMillis" : 1596256542547,
      "Key" : "task_x****",
      "Encoding" : "hashtable",
      "Bytes" : 12345,
      "NodeId" : "r-x****-db-0",
      "Count" : 127
    } ],
    "InstanceId" : "r-bp18ff4a195d****",
    "NodeId" : "r-x****-db-0"
  },
  "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.

Le message d'erreur renvoyé indique que les paramètres de requête spécifiés ne sont pas valides.

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