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/ Copia de respaldo y restauración/ Listado de registros de copia de respaldo de instancia de DCS

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

Ver PDF

Listado de registros de copia de respaldo de instancia de DCS

Función

Esta API se utiliza para consultar los registros de copia de respaldo de una instancia de DCS específica.

URI

GET /v2/{project_id}/instances/{instance_id}/backups

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

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
begin_time	No	String	Consultar hora de inicio (UTC). Formato: aaaaMMddHHmmss, por ejemplo, 20170718235959.
end_time	No	String	Consultar hora de finalización (UTC). Formato: aaaaMMddHHmmss, por ejemplo, 20170718235959.
limit	No	Integer	Número de elementos mostrados en cada página.
offset	No	Integer	offset, que es la posición en la que comienza la consulta. El valor debe ser mayor o igual a 0.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
total_num	Integer	Número de registros devueltos.
backup_record_response	Array of BackupRecordResponse objects	Matriz de los detalles de la copia de respaldo.

**Tabla 4** BackupRecordResponse
Parámetro	Tipo	Descripción
backup_id	String	ID de copia de respaldo.
period	String	Tiempo de ejecución de copia de respaldo.
backup_name	String	Nombre del registro de copia de respaldo.
instance_id	String	ID de instancia.
size	Long	Tamaño del archivo de copia de respaldo (byte).
backup_type	String	Tipo de copia de respaldo. manual: copia de respaldo manual auto: copia de respaldo automática Valores de enumeración: manual auto
created_at	String	Hora en la que se crea la tarea de copia de respaldo.
updated_at	String	Hora en la que se completa la copia de respaldo de la instancia de DCS.
progress	String	Progreso de respaldo.
error_code	String	Se muestra el código de error de un error de copia de respaldo. dcs.08.0001 - Error al iniciar la herramienta de copia de respaldo y restauración. dcs.08.0002 - Se ha agotado el tiempo de espera de la ejecución. dcs.08.0003 - Error al eliminar el bucket. dcs.08.0004 - Error al obtener el AK/SK. dcs.08.0005 - Error al crear el bucket. dcs.08.0006 - Error al consultar el tamaño de los datos de copia de respaldo. dcs.08.0007 - Error al sincronizar los datos durante la restauración. dcs.08.0008 - La tarea de copia de respaldo programada no se está ejecutando. La instancia está ejecutando otras tareas.
remark	String	Descripción de la copia de respaldo de la instancia de DCS.
status	String	Estado de la copia de respaldo. Las opciones son las siguientes: waiting: La tarea está esperando para comenzar. backuping: la copia de respaldo de la instancia de DCS está en curso. succeed: la copia de respaldo de la instancia de DCS se ha realizado correctamente. failed: Error de copia de respaldo de instancia de DCS. expired: el archivo de copia de respaldo ha caducado. deleted: el archivo de copia de respaldo se ha eliminado manualmente. Valores de enumeración: waiting backuping succeed failed expired deleted
is_support_restore	String	Si se admite la restauración. Opciones: TRUE y FALSE.

Código de estado: 400

**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: 500

**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

Solicitudes de ejemplo

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/backups?offset={offset}&limit={limit}&beginTime={begin_Time}&end_time={end_Time}

Ejemplo de respuestas

Código de estado: 200

Se consultaron con éxito los registros de copia de respaldo de instancia de DCS.

{
  "total_num" : 1,
  "backup_record_response" : [ {
    "period" : { },
    "backup_type" : "manual",
    "created_at" : "2019-05-10T08:31:16.166Z",
    "remark" : "001",
    "is_support_restore" : "TRUE",
    "backup_id" : "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
    "backup_name" : "backup_20190510163116",
    "instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
    "size" : 880232,
    "updated_at" : "2019-05-10T08:32:30.546Z",
    "progress" : "100.00",
    "error_code" : { },
    "status" : "succeed"
  } ]
}