CreateCacheAnalysisJob - - Centro de documentación de Alibaba Cloud

Crea 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, se recomienda usar la versión más reciente del SDK.
Si utiliza un SDK para llamar a DAS, debe establecer el identificador de región en cn-shanghai.
Esta operación solo es compatible con instancias de ApsaraDB for Redis Community Edition y con las instancias de rendimiento mejorado de ApsaraDB for Redis Enhanced Edition (Tair).

Nota

ApsaraDB for Redis 7.0 y los módulos personalizados no son compatibles.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateCacheAnalysisJob	La operación que desea ejecutar. Establezca el valor en CreateCacheAnalysisJob.
InstanceId	String	Sí	r-bp18ff4a195d****	El identificador de la instancia de ApsaraDB for Redis.
NodeId	String	No	r-x****-db-0	El identificador del nodo de datos de la instancia. Especifique este parámetro para consultar la información de monitoreo del nodo indicado. Nota Si especifica BackupSetId, el sistema ignora el valor de NodeId. Llame a la operación DescribeLogicInstanceTopology para consultar el identificador del nodo.
BackupSetId	String	No	12345	El identificador del archivo de copia de seguridad. Llame a la operación DescribeBackups para consultar el identificador del archivo de copia de seguridad. Si necesita especificar varios identificadores de archivos de copia de seguridad, sepárelos con comas (,). Por ejemplo, establezca este parámetro en `12345,67890`. Si no especifica este parámetro, el sistema respalda los datos automáticamente y ejecuta el análisis de caché sobre el archivo de copia de seguridad.
Separators	String	No	&	Los delimitadores que se usan para identificar los prefijos de las claves. No es necesario especificar este parámetro si utiliza uno o más de los siguientes delimitadores predeterminados: `: ; , _ - + @ = \| #`

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Message	String	Successful	El mensaje devuelto. Nota Si la solicitud fue exitosa, se devuelve Successful. Si la solicitud terminó con errores, se devuelve un mensaje de error que contiene información como el código de error.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	El identificador 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: los datos se estaban respaldando. ANALYZING: los datos se estaban analizando. FINISHED: los datos ya se analizaron. FAILED: ocurrió un error.
JobId	String	sf79-sd99-sa37-****	El identificador de la tarea de análisis de caché. Nota Este parámetro sirve para consultar una tarea de análisis de caché específica. Cuando llama a la operación CreateCacheAnalysisJob, el sistema requiere tiempo para crear la tarea de análisis de caché. Por lo tanto, los resultados del análisis no se devuelven de inmediato. Especifique este parámetro al llamar a la operación DescribeCacheAnalysisJob para consultar los resultados de la tarea indicada.
Message	String	Successful	El mensaje devuelto. Nota Si la solicitud fue exitosa, se devuelve Successful. Si la solicitud terminó con errores, 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 grandes 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 de ApsaraDB for Redis.
Db	Integer	0	El nombre de la base de datos.
ExpirationTimeMillis	Long	1596256542547	La hora de expiración de la clave. Unidad: milisegundos. Un valor de 0 indica que la clave no expira.
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 identificador del nodo de datos de la instancia.
Count	Long	127	La cantidad de elementos de la clave.
InstanceId	String	r-bp18ff4a195d****	El identificador de la instancia de base de datos.
NodeId	String	r-x****-db-0	El identificador del nodo de datos de la instancia.
Code	String	200	El código de respuesta.
Success	String	true	Indica si la solicitud fue exitosa. Valores válidos: true false

Ejemplos

Solicitudes de ejemplo

http(s)://das.cn-shanghai.aliyuncs.com/?Action=CreateCacheAnalysisJob
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&BackupSetId=12345
&Separators=&
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<CreateCacheAnalysisJobResponse>
    <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>
        <InstanceId>r-bp18ff4a195d****</InstanceId>
        <NodeId>r-x****-db-0</NodeId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</CreateCacheAnalysisJobResponse>

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
    } ],
    "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.	Los parámetros de la solicitud no son válidos.
403	NoPermission	You are not authorized to do this action.	No tiene autorización para ejecutar esta operación.

Para ver la lista de códigos de error, consulte Códigos de error del servicio.