Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Distributed Cache Service/ Referencia de la API/ API V2/ Análisis de caché/ Creación de una tarea de análisis de clave de mucho uso

Actualización más reciente 2022-11-09 GMT+08:00

Ver PDF

Creación de una tarea de análisis de clave de mucho uso

Función

Esta API se utiliza para crear una tarea de análisis de clave de mucho uso. Redis 3.0 no admite el análisis de clave de mucho uso.

Para realizar análisis de teclas de acceso rápido, el parámetro maxmemory-policy de la instancia debe establecerse en allkeys-lfu o volátil-lfu.

URI

POST /v2/{project_id}/instances/{instance_id}/hotkey-task

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto.
instance_id	Sí	String	ID de instancia.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 2** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
id	String	ID de registro de análisis de clave de mucho uso.
instance_id	String	ID de instancia.
status	String	Análisis de estado de la tarea. Valores de enumeración: waiting running success failed
scan_type	String	Modo de análisis. Valores de enumeración: manual auto
created_at	String	Hora en que se crea una tarea de análisis. El formato es "2020-06-15T02:21:18.669Z".
started_at	String	Hora en que se inició una tarea de análisis. El formato es "2020-06-15T02:21:18.669Z". (El valor es nulo y no se devuelve cuando se crea la tarea de análisis.)
finished_at	String	Hora en que terminó una tarea de análisis. El formato es "2020-06-15T02:21:18.669Z". (El valor es nulo y no se devuelve cuando se crea la tarea de análisis.)
num	Integer	Número de clave de mucho uso.
keys	Array of HotkeysBody objects	Registro de clave de mucho uso. (El valor es nulo y no se devuelve cuando se crea la tarea de análisis.)

**Tabla 3** HotkeysBody
Parámetro	Tipo	Descripción
name	String	Nombre de clave.
type	String	Tipo de clave. Valores de enumeración: string list set zset hash
shard	String	Shard donde se encuentra la clave de mucho uso. Este parámetro sólo se admite cuando el tipo de instancia es cluster. El formato es ip:port.
db	Integer	Base de datos donde se encuentra la clave de mucho uso.
size	Integer	Tamaño del valor de clave.
unit	String	Unidad del tamaño de la clave. Cuando el tipo de clave es string, la unidad es byte. Cuando el tipo de clave es list, set, zset o hash, la unidad es count.
freq	Integer	Frecuencia de acceso de una clave dentro de un período de tiempo específico. El valor es el contador de frecuencia de acceso logarítmico. El valor máximo es 255, lo que indica 1 millón de solicitudes de acceso. Después de que la frecuencia alcance 255, el valor ya no aumentará incluso si las solicitudes de acceso continúan aumentando. El valor disminuirá en 1 por cada minuto durante el cual no se acceda a la clave.

Código de estado: 400

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 401

**Tabla 5** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 403

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 404

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 500

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Solicitudes de ejemplo

POST https://dcs.cn-south-1.myhuaweicloud.com/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/hotkey-task

Ejemplo de respuestas

Código de estado: 200

Se creó con éxito la tarea de análisis de clave de mucho uso.

{
  "id" : "aa735b6f-3d70-44e3-9771-66c6fae7459a",
  "instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
  "status" : "waiting",
  "scan_type" : "manual",
  "created_at" : "2020-06-15T02:21:18.669Z",
  "num" : 0
}

Código de estado: 400

Solicitud no válida.

{
  "error_code" : "DCS.4922",
  "error_msg" : "Does not support hotkey analyze."
}

Códigos de estado

Código de estado	Descripción
200	Se creó con éxito la tarea de análisis de clave de mucho uso.
400	Solicitud no válida.
401	Información de autenticación no válida.
403	La solicitud se rechaza.
404	La página solicitada no se encuentra.
500	Error interno del servicio.