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 grande

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

Ver PDF

Creación de una tarea de análisis de clave grande

Función

Esta API se utiliza para crear una tarea de análisis de clave grande para una instancia de DCS en Redis.

URI

POST /v2/{project_id}/instances/{instance_id}/bigkey-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 grande.
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 claves grandes.
keys	Array of BigkeysBody objects	Registro de clave grande. (El valor es nulo y no se devuelve cuando se crea la tarea de análisis.)

**Tabla 3** BigkeysBody
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 grande. 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 grande.
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.

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/bigkey-task

Ejemplo de respuestas

Código de estado: 200

Tarea de análisis de clave grande se crea con éxito.

{
  "id" : "858ee14c-2271-4489-8b82-7bda7459ae3e",
  "instance_id" : "5f9057b5-c330-4ee2-8138-7e69896eeec3",
  "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.4919",
  "error_msg" : "Does not support bigkey analyze."
}

Códigos de estado

Código de estado	Descripción
200	Tarea de análisis de clave grande se crea con éxito.
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.