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/TaurusDB/Referencia de la API/Las API (recomendadas)/Gestión de copias de respaldo/Consulta de copias de respaldo incrementales
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de copias de respaldo incrementales

Función

Esta API se utiliza para consultar copias de respaldo incrementales. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/incremental-backups

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia, que es compatible con el formato UUID.

Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

offset

No

String

Desplazamiento de índice. Si offset se establece en N, la consulta de recursos comienza desde el dato N+1. El valor es 0 de forma predeterminada, lo que indica que la consulta comienza desde el primer dato. El valor no puede ser un número negativo.

limit

No

String

Número de registros que se van a consultar. Valor: 10 (valor predeterminado), 20 o 50.

begin_time

No

String

Hora de inicio de consulta. El formato es "aaaa-mm-ddThh:mm:ssZ".

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

Cuando begin_time no está vacío, end_time es obligatorio.

end_time

No

String

Hora de finalización de la consulta. El formato es "yyyy-mm-ddThh:mm:ssZ" y la hora de finalización debe ser posterior a la hora de inicio.

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

Cuando end_time no está vacío, begin_time es obligatorio.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

backups

Array of IncrementalBackups objects

Información de copia de respaldo.

total_count

Long

Número total de archivos de copia de respaldo.

Tabla 5 IncrementalBackups

Parámetro

Tipo

Descripción

id

String

ID de copia de respaldo.

name

String

Nombre de copia de respaldo.

begin_time

String

Hora de inicio de copia de respaldo en el formato "aaaa-mm-ddThh:mm:ssZ".

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

end_time

String

Hora de finalización de la copia de seguridad en el formato "aaaa-mm-ddThh:mm:ssZ".

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

size

Number

Tamaño copia de respaldo, en KB.

instance_id

String

ID de instancia.

Código de estado: 400

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Consulta de copia de respaldos generada del 6 de julio de 2022 al 16 de julio de 2022

GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/incremental-backups?offset=0&limit=10&begin_time=2022-07-06T10:41:14+0800&end_time=2022-07-16T10:41:14+0800

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "backups" : [ {
    "id" : "f0d2aea28d26t4848b8c84ed3fea1822fbr07",
    "name" : "TaurusDB--20230728181555006",
    "begin_time" : "2022-07-07T12:41:14+0800",
    "end_time" : "2022-07-08T12:45:14+0800",
    "size" : 0.109375,
    "instance_id" : "61a4ea66210545909d74a05c27a7179ein07"
  } ],
  "total_count" : 1
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.