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/ Consulta de registros de restauración de instancias DCS

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

Ver PDF

Consulta de registros de restauración de instancias DCS

Función

Esta API se utiliza para consultar los registros de restauración de una instancia de DCS específica.

URI

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

**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	Hora de inicio del período que se va a consultar. Formato: aaaaMMddHHmmss, por ejemplo, 20170718235959.
end_time	No	String	Hora de finalización del período que se va a consultar. 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
restore_record_response	Array of InstanceRestoreInfo objects	Matriz de los registros de restauración.
total_num	Integer	Número total.

**Tabla 4** InstanceRestoreInfo
Parámetro	Tipo	Descripción
backup_id	String	ID de copia de respaldo.
restore_id	String	ID del registro de restauración.
backup_name	String	Nombre del registro de copia de respaldo.
updated_at	String	Hora en que se completó la restauración.
restore_remark	String	Descripción de la restauración.
created_at	String	Hora en la que se creó la tarea de restauración.
progress	String	Progreso de la restauración.
error_code	String	Se muestra el código de error de un error de restauración. 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.
restore_name	String	Nombre de un registro de restauración.
backup_remark	String	Descripción de la copia de respaldo.
status	String	Estado de restauración. waiting: La tarea está esperando para comenzar. restoring: La restauración está en progreso. succeed: La restauración es exitosa. failed: Error de restauración. Valores de enumeración: waiting restoring succeed failed

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

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

Se consultaron con éxito registros de restauración de instancia de DCS.

{
  "restore_record_response" : [ {
    "backup_id" : "f4823e9e-fe9b-4ffd-be79-4e5d6de272bb",
    "restore_id" : "a6155972-800c-4170-a479-3231e907d2f6",
    "backup_name" : "backup_20170718000002",
    "updated_at" : "2017-07-18T21:41:35.182Z",
    "restore_remark" : "doctest",
    "created_at" : "2017-07-18T21:41:20.721Z",
    "progress" : "100.00",
    "error_code" : { },
    "restore_name" : "restore_20170718214120",
    "backup_remark" : { },
    "status" : "succeed"
  } ],
  "total_num" : 1
}