DescribeCacheAnalysisJobs - - Centro de documentación de Alibaba Cloud

Consulta las tareas 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), se recomienda usar la versión más reciente.
Si utiliza un SDK para llamar a las operaciones de DAS, debe establecer la región en cn-shanghai.
Esta operación solo es aplicable a ApsaraDB for Redis.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeCacheAnalysisJobs	La operación que desea ejecutar. Establezca el valor en DescribeCacheAnalysisJobs.
InstanceId	String	Sí	r-bp18ff4a195d****	El ID de la instancia de base de datos.
StartTime	String	Sí	1596177993000	El inicio del intervalo de tiempo por consultar. Especifique la hora en formato de marca de tiempo UNIX. Unidad: milisegundos.
EndTime	String	Sí	1596177993001	El final del intervalo de tiempo por consultar. Especifique la hora en formato de marca de tiempo UNIX. Unidad: milisegundos. Nota La hora de finalización debe ser posterior a la hora de inicio.
PageNo	String	No	1	El número de página por devolver. El valor debe ser un número entero mayor que 0. Valor predeterminado: 1.
PageSize	String	No	10	El número máximo de entradas por devolver en cada página. Valor predeterminado: 10.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Message	String	Successful	El mensaje devuelto para la solicitud. Nota Si la solicitud se realiza correctamente, se devuelve Successful. Si la solicitud falla, se devuelve un mensaje de error con 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 instancia.
List	Array of CacheAnalysisJob		Los detalles de las tareas de análisis de caché.
CacheAnalysisJob
TaskState	String	BACKUP	El estado de la tarea de análisis de caché. Valores válidos: BACKUP: Se está realizando la copia de seguridad de los datos. ANALYZING: Se están analizando los datos. FINISHED: Los datos 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 devuelto para la solicitud. Nota Si la solicitud se realiza correctamente, se devuelve Successful. Si la solicitud falla, se devuelve un mensaje de error con información como el código de error.
BigKeys	Array of KeyInfo		Los detalles sobre las claves grandes. Importante Los subparámetros de este parámetro y sus valores correspondientes no se devuelven. Si desea consultar los detalles de las tareas de análisis de caché, llame a la operación DescribeCacheAnalysisJob.
KeyInfo
Type	String	hash	El tipo de datos de la instancia.
Db	Integer	0	El nombre de la base de datos.
ExpirationTimeMillis	Long	1596256542547	La hora de caducidad de la clave. Unidad: milisegundos. El valor 0 indica que la clave no caduca.
Key	String	task_*****	El nombre de la clave.
Encoding	String	hashtable	El tipo de datos de la clave.
Bytes	Long	12345	El número de bytes que ocupa la clave.
NodeId	String	r-****-db-0	El ID del nodo de datos en la instancia.
Count	Long	127	El número de elementos en 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 en la instancia.
PageNo	Long	1	El número de página devuelta. El valor debe ser un número entero mayor que 0. Valor predeterminado: 1.
PageSize	Long	10	El número máximo de entradas devueltas en cada página. Valor predeterminado: 10.
Extra	String	None	El parámetro reservado.
Total	Long	4	El número total de tareas de análisis de caché.
Code	String	200	El código de estado HTTP devuelto.
Success	String	true	Indica si la solicitud se realizó correctamente. Valores válidos: true: La solicitud se realizó correctamente. false: La solicitud falló.

Ejemplos

Solicitudes de ejemplo

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeCacheAnalysisJobs
&InstanceId=r-bp18ff4a195d****
&StartTime=1596177993000
&EndTime=1596177993001
&PageNo=1
&PageSize=10
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeCacheAnalysisJobsResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <List>
            <TaskState>BACKUP</TaskState>
            <JobId>sf79-sd99-sa37-****</JobId>
            <Message>Successful</Message>
            <BigKeys>
                <Type>hash</Type>
                <Db>0</Db>
                <ExpirationTimeMillis>1596256542547</ExpirationTimeMillis>
                <Key>task_*****</Key>
                <Encoding>hashtable</Encoding>
                <Bytes>12345</Bytes>
                <NodeId>r-****-db-0</NodeId>
                <Count>127</Count>
            </BigKeys>
            <InstanceId>r-bp18ff4a195d****</InstanceId>
            <NodeId>r-x****-db-0</NodeId>
        </List>
        <PageNo>1</PageNo>
        <PageSize>10</PageSize>
        <Extra>None</Extra>
        <Total>4</Total>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeCacheAnalysisJobsResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "List" : [ {
      "TaskState" : "BACKUP",
      "JobId" : "sf79-sd99-sa37-****",
      "Message" : "Successful",
      "BigKeys" : [ {
        "Type" : "hash",
        "Db" : 0,
        "ExpirationTimeMillis" : 1596256542547,
        "Key" : "task_*****",
        "Encoding" : "hashtable",
        "Bytes" : 12345,
        "NodeId" : "r-****-db-0",
        "Count" : 127
      } ],
      "InstanceId" : "r-bp18ff4a195d****",
      "NodeId" : "r-x****-db-0"
    } ],
    "PageNo" : 1,
    "PageSize" : 10,
    "Extra" : "None",
    "Total" : 4
  },
  "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 devuelto porque los parámetros de solicitud especificados no son válidos.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.