Consulta de registros de copia de seguridad de instancia de DCS
Función
Esta API se utiliza para consultar los registros de copia de respaldo de una instancia DCS especificada.
URI
GET /v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}
Parámetro |
Tipo |
Obligatorio |
Descripción |
|---|---|---|---|
project_id |
String |
Sí |
ID del proyecto. |
instance_id |
String |
Sí |
ID de instancia de DCS. |
start |
Integer |
No |
Número de secuencia de inicio del registro de copia de respaldo que se va a consultar. De forma predeterminada, este parámetro se establece en 1. |
limit |
Integer |
No |
Número de registros de copia de respaldo mostrados en cada página. El valor mínimo de este parámetro es 1. Si este parámetro no está definido, se muestran 10 registros de copia de respaldo en cada página de forma predeterminada. |
beginTime |
String |
No |
Hora de inicio del período que se va a consultar. Formato: aaaaMMddHHmmss, por ejemplo, 20170718235959. |
endTime |
String |
No |
Hora de finalización del período que se va a consultar. Formato: aaaaMMddHHmmss, por ejemplo, 20170718235959. |
Solicitud
Parámetros de solicitud
Ninguna.
Solicitud de ejemplo
GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}
Respuesta
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
|---|---|---|
backup_record_response |
Array |
Matriz de los registros de copia de respaldo. Para obtener más información sobre backup_record_response, consulte Tabla 3. |
total_num |
Integer |
Número de registros de copia de respaldo obtenidos. |
Parámetro |
Tipo |
Descripción |
|---|---|---|
status |
String |
Estado de respaldo. Opciones:
|
remark |
String |
Descripción de la copia de respaldo de instancia de DCS |
period |
String |
Segmento de tiempo en el que se realizó la copia de respaldo de la instancia de DCS |
progress |
String |
Progreso del respaldo |
size |
Long |
Tamaño del archivo de copia de respaldo. Unidad: byte. |
instance_id |
String |
ID de instancia de DCS |
backup_id |
String |
ID del registro de copia de respaldo |
created_at |
String |
Hora en la que se crea la tarea de copia de respaldo |
updated_at |
String |
Tiempo en el que se completa la copia de respaldo de la instancia de DCS |
execution_at |
String |
Hora en la que se inicia la copia de respaldo. |
backup_type |
String |
Tipo de copia de respaldo. Opciones:
|
backup_name |
String |
Nombre del registro de copia de respaldo |
error_code |
String |
Código de error devuelto si la copia de respaldo de la instancia de DCS falla. Para obtener más información sobre los códigos de error, consulte Tabla 4. |
is_support_restore |
String |
Un indicador de si se admite la restauración. Opciones: TRUE o FALSE. |
Código de error |
Descripción |
|---|---|
dcs.08.0001 |
Error al iniciar la herramienta de copia de respaldo y restauración. |
dcs.08.0002 |
Fin del tiempo de espera para la operación. |
dcs.08.0003 |
Error al eliminar el bucket. |
dcs.08.0004 |
Error al obtener AK/SK. |
dcs.08.0005 |
Error al crear el bucket. |
dcs.08.0006 |
Error al obtener el tamaño del archivo de copias de respaldo. |
dcs.08.0007 |
Error al sincronizar los datos durante la restauración de instancias. |
dcs.08.0008 |
La copia de respaldo automática de la instancia no se inicia porque la instancia está ejecutando otros trabajos. |
Ejemplo de respuesta
{
"backup_record_response": [
{
"status": "succeed",
"remark": "001",
"period": null,
"progress": "100.00",
"size": 880232,
"instance_id": "5560df16-cebf-4473-95c4-d1b573c16e79",
"backup_id": "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
"created_at": "2019-05-10T08:31:16.166Z",
"updated_at": "2019-05-10T08:32:30.546Z",
"execution_at": "2019-05-10T08:31:21.461Z",
"backup_type": "manual",
"backup_name": "backup_20190510163116",
"error_code": null,
"is_support_restore": "TRUE"
}
],
"total_num": 1
}
