Todos los productos
Search
Centro de documentos

:DescribeCacheAnalysisJob

Última actualización: Sep 07, 2026

Consulta los detalles de una tarea de análisis de caché.

Antes de llamar a esta operación, tenga en cuenta lo siguiente:

  • Si utiliza un SDK de Alibaba Cloud o un SDK de Database Autonomy Service (DAS) para llamar a esta operación, le recomendamos usar la versión más reciente del SDK.

  • Si utiliza un SDK para llamar a las operaciones de DAS, establezca la región en cn-shanghai.

  • Esta operación solo aplica a ApsaraDB for Redis.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

DescribeCacheAnalysisJob

La operación que desea ejecutar. Establezca el valor en DescribeCacheAnalysisJob.

InstanceId

String

Sí

r-bp18ff4a195d****

El ID de la instancia.

JobId

String

Sí

sf79-sd99-sa37-****

El ID de la tarea de análisis de caché. Puede obtener este ID a partir de los parámetros de respuesta de la operación CreateCacheAnalysisJob.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
Message String Successful

El mensaje que devuelve la solicitud.

Nota Si la solicitud es exitosa, se devuelve Successful. Si falla, se devuelve un mensaje de error que contiene información como el código de error.
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

El ID de la solicitud.

Data Object

Los detalles de la tarea.

TaskState String BACKUP

El estado de la tarea de análisis de caché. Valores válidos:

  • BACKUP: se está creando la copia de seguridad de los datos.
  • ANALYZING: se están analizando los datos.
  • FINISHED: los datos ya se analizaron.
  • FAILED: ocurrió un error.
JobId String sf79-sd99-sa37-****

El ID de la tarea de análisis de caché.

Message String Successful

El mensaje que devuelve la solicitud.

Nota Si la solicitud es exitosa, se devuelve Successful. Si falla, se devuelve un mensaje de error que contiene información como el código de error.
BigKeys Array of KeyInfo

Los detalles de las claves grandes. Las claves devueltas se ordenan de forma descendente según la cantidad de bytes que ocupan.

KeyInfo
Type String hash

El tipo de datos de la instancia.

Db Integer 0

El nombre de la base de datos.

ExpirationTimeMillis Long 1596256542547

El periodo de caducidad de la clave, en milisegundos. Un valor de 0 indica que la clave no caduca.

Key String task_x****

El nombre de la clave.

Encoding String hashtable

El tipo de datos de la clave.

Bytes Long 12345

La cantidad de bytes que ocupa la clave.

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

El ID del nodo de datos de la instancia.

Count Long 127

La cantidad de elementos de la clave.

KeyPrefixes Array of Prefix

Los prefijos de las claves.

Prefix
KeyNum Long 123

La cantidad de claves que contienen el prefijo.

Type String hash

El tipo de datos de la instancia.

Bytes Long 12345

La cantidad de bytes que ocupa la clave.

Prefix String task_

El prefijo de la clave.

Count Long 127

La cantidad de elementos de la clave.

BigKeysOfNum Array of KeyInfo

Los detalles de las claves grandes. Las claves devueltas se ordenan de forma descendente según su cantidad.

KeyInfo
Type String hash

El tipo de datos de la instancia.

Db Integer 0

El nombre de la base de datos.

ExpirationTimeMillis Long 1596256542547

El periodo de caducidad de la clave, en milisegundos. Un valor de 0 indica que la clave no caduca.

Key String task_x****

El nombre de la clave.

Encoding String hashtable

El tipo de datos de la clave.

Bytes Long 12345

La cantidad de bytes que ocupa la clave.

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

El ID del nodo de datos de la instancia.

Count Long 127

La cantidad de elementos de la clave.

UnexBigKeysOfBytes Array of KeyInfo

Los detalles de las claves permanentes. Las claves devueltas se ordenan de forma descendente según la cantidad de bytes que ocupan.

KeyInfo
Type String hash

El tipo de datos de la instancia.

Db Integer 0

El nombre de la base de datos.

ExpirationTimeMillis Long 1596256542547

El periodo de caducidad de la clave, en milisegundos. Un valor de 0 indica que la clave no caduca.

Key String task_x****

El nombre de la clave.

Encoding String hashtable

El tipo de datos de la clave.

Bytes Long 12345

La cantidad de bytes que ocupa la clave.

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

El ID del nodo de datos de la instancia.

Count Long 127

La cantidad de elementos de la clave.

UnexBigKeysOfNum Array of KeyInfo

Los detalles de las claves permanentes. Las claves devueltas se ordenan de forma descendente según su cantidad.

KeyInfo
Type String hash

El tipo de datos de la instancia.

Db Integer 0

El nombre de la base de datos.

ExpirationTimeMillis Long 1596256542547

El periodo de caducidad de la clave, en milisegundos. Un valor de 0 indica que la clave no caduca.

Key String task_x****

El nombre de la clave.

Encoding String hashtable

El tipo de datos de la clave.

Bytes Long 12345

La cantidad de bytes que ocupa la clave.

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

El ID del nodo de datos de la instancia.

Count Long 127

La cantidad de elementos de la clave.

InstanceId String r-bp18ff4a195d****

El ID de la instancia de base de datos.

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

El ID del nodo de datos de la instancia.

Code String 200

El código de estado HTTP devuelto.

Success String true

Indica si la solicitud fue exitosa. Valores válidos:

  • true: la solicitud fue exitosa.
  • false: la solicitud terminó con errores.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

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>

Formato JSON

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

InvalidParams

The request parameters are invalid.

El mensaje de error que se devuelve porque los parámetros de solicitud especificados no son válidos.

Para consultar la lista de códigos de error, visite Códigos de error del servicio.