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> Cloud Backup and Recovery> Referencia de la API> APIs de CBR> Copias de respaldo> Consulta de todas las copias de seguridad
Actualización más reciente 2023-02-03 GMT+08:00
Ver PDF

Consulta de todas las copias de seguridad

Función

Esta API se utiliza para consultar todas las copias de seguridad.

URI

GET /v3/{project_id}/backups

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto
Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

checkpoint_id

No

String

ID de punto de restauración

dec

No

Boolean

Dedicated cloud

end_time

No

String

Hora en que finaliza la copia de respaldo, en formato %YYYY-%mm-%ddT%HH:%MM:%SSZ. Por ejemplo, 2018-02-01T12:00:00Z.

enterprise_project_id

No

String

ID de proyecto de empresa o all_granted_eps. all_granted_eps indica consultar los IDs de todos los proyectos de empresa en los que el usuario tiene permisos.

image_type

No

String

Tipo de copia de respaldo, que es backup.

limit

No

Integer

Número de registros mostrados por página. El valor debe ser un número positivo entero.

marker

No

String

ID del último registro mostrado en la página anterior

member_status

No

String

Estado de uso compartido de copias de seguridad

Valores de enumeración:

  • pending
  • accepted
  • rejected

name

No

String

Nombre de copia de respaldo

offset

No

Integer

Valor de desplazamiento. El valor debe ser un número positivo entero.

own_type

No

String

Poseer tipo de copia de respaldo. copias de seguridad private se consultan de forma predeterminada.

Predeterminado: private

Valores de enumeración:

  • all_granted
  • private
  • shared

parent_id

No

String

ID de copia de respaldo principal

resource_az

No

String

Se admite el filtrado basado en AZ.

resource_id

No

String

ID de recurso

resource_name

No

String

Nombre de recurso

resource_type

No

String

Tipo de recurso, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo

show_replication

No

Boolean

Si se muestran los registros de replicación.

Predeterminado: false

sort

No

String

Un grupo de propiedades separadas por comas (,) y orden de direcciones. El formato de valor es de [:],[:], donde el valor de la dirección es asc (en orden ascendente) o desc (en orden descendente). Si no se especifica la dirección del parámetro, la dirección de ordenación por defecto es desc. El valor de sort contiene un máximo de 255 caracteres. El rango de valores de la clave es el siguiente: [created_at, updated_at, name, status, protected_at, id]

start_time

No

String

Hora en que se inicia la copia de respaldo, en formato %YYYY-%mm-%ddT%HH:%MM:%SSZ. Por ejemplo, 2018-02-01T12:00:00Z.

status

No

String

Estado. Cuando se llama a la API, se pueden transferir varios estados para el filtrado, por ejemplo, status=available&status=error.

Valores de enumeración:

  • available
  • protecting
  • deleting
  • restoring
  • error
  • waiting_protect
  • waiting_delete
  • waiting_restore

used_percent

No

String

Las copias de seguridad se filtran en función de la capacidad del almacén ocupado. El valor varía de 1 a 100. Por ejemplo, si used_percent se establece en 80, se muestran todas las copias de seguridad que ocuparon el 80% o más de la capacidad del almacén.

vault_id

No

String

ID de almacén

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. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

backups

Array of BackupResp objects

Lista de copias de respaldo

count

Integer

Cantidad de copias de respaldo

offset

Integer

Desplazamiento donde comienza la consulta

Mínimo: 0

Predeterminado: 0

limit

Integer

Número de registros mostrados en cada página

Mínimo: 1

Máximo: 1000

Predeterminado: 1000
Tabla 5 BackupResp

Parámetro

Tipo

Descripción

checkpoint_id

String

ID de punto de restauración

created_at

String

Tiempo de creación, por ejemplo, 2020-02-05T10:38:34.209782

description

String

Descripción de la copia de respaldo

expired_at

String

Tiempo de caducidad, por ejemplo, 2020-02-05T10:38:34.209782

extend_info

BackupExtendInfo object

Información extendida

id

String

ID de copia de respaldo

image_type

String

Tipo de copia de respaldo, que es backup.

name

String

Nombre de copia de respaldo

parent_id

String

ID de copia de respaldo principal

project_id

String

ID de proyecto

protected_at

String

Tiempo de copia de respaldo

resource_az

String

Zona de disponibilidad de recursos

resource_id

String

ID de recurso

resource_name

String

Nombre de recurso

resource_size

Integer

Tamaño del recurso, en GB

resource_type

String

Tipo de recurso, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo

status

String

Estado de la copia de respaldo

Valores de enumeración:

  • available
  • protecting
  • deleting
  • restoring
  • error
  • waiting_protect
  • waiting_delete
  • waiting_restore

updated_at

String

Tiempo de actualización, por ejemplo, 2020-02-05T10:38:34.209782

vault_id

String

ID de almacén

replication_records

Array of ReplicationRecordGet objects

Registro de replicación

enterprise_project_id

String

ID de proyecto de empresa. Su valor predeterminado es 0.

provider_id

String

ID de proveedor de copia de respaldo, que se utiliza para distinguir objetos de copia de respaldo. El valor puede ser el siguiente:

0daac4c5-6707-4851-97ba-169e36266b66 indica que los objetos de copia de respaldo son servidores en la nube; d1603440-187d-4516-af25-121250c7cc97 indica que los objetos de copia de respaldo son discos en la nube; 3f3c3220-245c-4805-b811-758870015881 indica que los objetos de copia de respaldo son sistemas de archivos SFS Turbo.

children

Array of BackupResp objects

Lista de copias de respaldo
Tabla 6 BackupExtendInfo

Parámetro

Tipo

Descripción

auto_trigger

Boolean

Si la copia de respaldo se genera automáticamente

bootable

Boolean

Si la copia de respaldo es una copia de respaldo de disco del sistema

incremental

Boolean

Si la copia de respaldo es una copia de respaldo incremental

snapshot_id

String

ID de instantánea de la copia de respaldo en disco

support_lld

Boolean

Ya sea para permitir lazyloading para una restauración rápida

supported_restore_mode

String

Modo de restauración. Los valores posibles son na, snapshot, y backup. snapshot indica que la copia de respaldo se puede utilizar para crear una imagen de servidor completo. backup indica que los datos se restauran desde backups de los discos EVS del servidor. na indica que la copia de respaldo solo se puede usar para crear nuevos recursos, pero no se puede usar para la restauración.

Predeterminado: na

Valores de enumeración:

  • na
  • backup
  • snapshot

os_images_data

Array of ImageData objects

Lista de ID de imágenes creadas con copias de seguridad

contain_system_disk

Boolean

Si los datos de copia de respaldo de VM contienen datos de disco del sistema

encrypted

Boolean

Si la copia de respaldo está cifrada

system_disk

Boolean

Si el disco es un disco del sistema
Tabla 7 ImageData

Parámetro

Tipo

Descripción

image_id

String

ID de imagen
Tabla 8 ReplicationRecordGet

Parámetro

Tipo

Descripción

created_at

String

Hora de inicio de la replicación

destination_backup_id

String

ID de la copia de respaldo de destino utilizada para la replicación

destination_checkpoint_id

String

ID de registro de la copia de respaldo de destino utilizada para la replicación

destination_project_id

String

ID del proyecto de destino de replicación

destination_region

String

Región de destino de replicación

destination_vault_id

String

ID del almacén de destino

extra_info

ReplicationRecordsExtraInfo object

Información adicional de la replicación

id

String

ID de registro de replicación

source_backup_id

String

ID de la copia de respaldo de origen utilizada para la replicación

source_checkpoint_id

String

ID del registro de copia de respaldo de origen utilizado para la replicación

source_project_id

String

ID del proyecto de origen de replicación

source_region

String

Región de origen de replicación

status

String

Estado de replicación

Valores de enumeración:

  • replicating
  • success
  • fail
  • skip
  • waiting_replicate

vault_id

String

ID del almacén donde reside la copia de respaldo
Tabla 9 ReplicationRecordsExtraInfo

Parámetro

Tipo

Descripción

progress

Integer

Progreso de la replicación

fail_code

String

Código de error. Este campo está vacío si la operación se realiza correctamente.

fail_reason

String

Causa del error

auto_trigger

Boolean

Si la replicación se programa automáticamente

destinatio_vault_id

String

ID del almacén de destino

Solicitudes de ejemplo

GET  https://{endpoint}/v3/{project_id}/backups

Ejemplo de respuestas

Código de estado: 200

OK

{
  "count" : 2,
  "backups" : [ {
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "checkpoint_id" : "1fced58b-2a31-4851-bcbb-96216f83ce99",
    "updated_at" : "2020-02-21T07:07:25.113761",
    "vault_id" : "cca85ea5-00a4-418d-9222-bd83985bc515",
    "id" : "b1c4afd9-e7a6-4888-9010-c2bac3aa7910",
    "resource_az" : "br-iaas-odin1a",
    "image_type" : "backup",
    "resource_id" : "1a503932-ee8f-4dd5-8248-8dfb57e584c5",
    "resource_size" : 40,
    "children" : [ ],
    "extend_info" : {
      "auto_trigger" : true,
      "supported_restore_mode" : "backup",
      "contain_system_disk" : true,
      "support_lld" : true,
      "system_disk" : false
    },
    "project_id" : "0605767b5780d5762fc5c0118072a564",
    "status" : "available",
    "resource_name" : "test001-02",
    "description" : "",
    "expired_at" : "2020-05-21T07:00:54.060493",
    "name" : "autobk_b629",
    "created_at" : "2020-02-21T07:00:54.065135",
    "resource_type" : "OS::Nova::Server"
  }, {
    "provider_id" : "d1603440-187d-4516-af25-121250c7cc97",
    "checkpoint_id" : "f64c351f-769f-4c04-8806-fd90a59e9b12",
    "updated_at" : "2020-02-21T07:09:37.767084",
    "vault_id" : "79bd9daa-884f-4f84-b8fe-235d58cd927d",
    "id" : "5606aab5-2dc2-4498-8144-dc848d099af5",
    "resource_az" : "br-iaas-odin1a",
    "image_type" : "backup",
    "resource_id" : "54f7ccbc-072f-4ec5-a7b7-b24dabdb4539",
    "resource_size" : 40,
    "children" : [ ],
    "extend_info" : {
      "auto_trigger" : true,
      "snapshot_id" : "e3def9a8-e4b4-4c12-b132-f4ba8ce9a34f",
      "bootable" : true,
      "support_lld" : true,
      "encrypted" : false,
      "system_disk" : false
    },
    "project_id" : "0605767b5780d5762fc5c0118072a564",
    "status" : "available",
    "resource_name" : "qsy_000",
    "description" : "",
    "expired_at" : "2020-03-22T07:00:34.877896",
    "name" : "autobk_6809",
    "created_at" : "2020-02-21T07:00:34.882174",
    "resource_type" : "OS::Cinder::Volume"
  } ]
}

Códigos de estado

Código de estado

Descripción

200

OK

Códigos de error

Consulte Códigos de error.

Tema principal: Copias de respaldo