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 una copia de seguridad especificada

Actualización más reciente 2023-02-03 GMT+08:00

Ver PDF

Consulta de una copia de seguridad especificada

Función

Esta API se utiliza para consultar la copia de respaldo de un ID específico.

URI

GET /v3/{project_id}/backups/{backup_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
backup_id	Sí	String	ID de copia de respaldo
project_id	Sí	String	ID de proyecto

Parámetros de solicitud

**Tabla 2** 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 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
backup	BackupResp object	Copia de respaldo

**Tabla 4** 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 5** 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 6** ImageData
Parámetro	Tipo	Descripción
image_id	String	ID de imagen

**Tabla 7** 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 8** 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/{backup_id}

Ejemplo de respuestas

Código de estado: 200

{
  "backup" : {
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
    "enterprise_project_id" : "0",
    "updated_at" : null,
    "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
    "id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
    "resource_az" : "az1.dc1",
    "image_type" : "backup",
    "resource_id" : "94eba8b2-acc9-4d82-badc-127144cc5526",
    "resource_size" : 40,
    "children" : [ {
      "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
      "checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
      "updated_at" : null,
      "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
      "id" : "5d822633-2bbf-4af8-a16e-5ab1c7705235",
      "resource_az" : null,
      "image_type" : "backup",
      "resource_id" : "eccbcfdd-f843-4bbb-b2c0-a5ce861f9376",
      "resource_size" : 40,
      "children" : [ ],
      "parent_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
      "extend_info" : {
        "auto_trigger" : true,
        "supported_restore_mode" : null,
        "os_images_data" : null,
        "snapshot_id" : "5230a977-1a94-4092-8edd-519303a44cda",
        "bootable" : true,
        "support_lld" : null,
        "encrypted" : true
      },
      "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
      "status" : "available",
      "resource_name" : "ecs-1f0f-0002",
      "description" : null,
      "expired_at" : null,
      "name" : "autobk_a843_ecs-1f0f-0002",
      "created_at" : "2019-05-10T07:59:59.450700",
      "protected_at" : null,
      "resource_type" : "OS::Cinder::Volume"
    } ],
    "parent_id" : null,
    "extend_info" : {
      "auto_trigger" : true,
      "supported_restore_mode" : "backup",
      "os_images_data" : null,
      "contain_system_disk" : true,
      "snapshot_id" : null,
      "bootable" : null,
      "support_lld" : true
    },
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "status" : "available",
    "resource_name" : "ecs-1f0f-0002",
    "description" : "backup_description",
    "expired_at" : null,
    "name" : "backup_name",
    "created_at" : "2019-05-10T07:59:12.084695",
    "protected_at" : null,
    "resource_type" : "OS::Nova::Server"
  }
}