Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Cloud Backup and Recovery/ Referência de API/ APIs do CBR/ Backups/ Consulta de um backup especificado

Atualizado em 2023-04-26 GMT+08:00

Ver PDF

Consulta de um backup especificado

Função

Esta API é usada para consultar o backup de um ID específico.

URI

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

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
backup_id	Sim	String	ID do backup
project_id	Sim	String	ID do projeto

Parâmetros de solicitação

**Tabela 2** Parâmetros do cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token de usuário. O token pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros de corpo de resposta
Parâmetro	Tipo	Descrição
backup	BackupResp object	Backup

**Tabela 4** BackupResp
Parâmetro	Tipo	Descrição
checkpoint_id	String	ID do ponto de restauração
created_at	String	Tempo de criação, por exemplo, 2020-02-05T10:38:34.209782
description	String	Descrição do backup
expired_at	String	Tempo de expiração, por exemplo, 2020-02-05T10:38:34.209782
extend_info	BackupExtendInfo object	Informação ampliada
id	String	ID do backup
image_type	String	Tipo de backup, que pode ser backup ou replication.
name	String	Nome do backup
parent_id	String	ID de backup pai
project_id	String	ID do projeto
protected_at	String	Tempo de backup
resource_az	String	Zona de disponibilidade de recursos
resource_id	String	ID do recurso
resource_name	String	Nome do recurso
resource_size	Integer	Tamanho do recurso, em GB
tipo_recurso	String	Tipo de recurso, que pode ser OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo ou OS::Workspace::DesktopV2
status	String	Estado do backup. Valores de enumeração: available protecting deleting restoring error waiting_protect waiting_delete waiting_restore
updated_at	String	Tempo de atualização, por exemplo, 2020-02-05T10:38:34.209782
vault_id	String	ID do cofre
replication_records	Array of ReplicationRecordGet objects	Registro de replicação
enterprise_project_id	String	ID do projeto empresarial. O valor padrão é 0.
provider_id	String	ID do provedor de backup, que é usado para distinguir objetos de backup. O valor pode ser o seguinte: 0daac4c5-6707-4851-97ba-169e36266b66 indica que os objetos de backup são servidores em nuvem; d1603440-187d-4516-af25-121250c7cc97 indica que os objetos de backup são discos em nuvem; 3f3c3220-245c-4805-b811-758870015881 indica que os objetos de backup são sistemas de arquivos do SFS Turbo; a13639de-00be-4e94-af30-26912d75e4a2 indica que os objetos de backup são backups de VMware em nuvem híbrida.
children	Array of BackupResp objects	Lista de backup

**Tabela 5** BackupExtendInfo
Parâmetro	Tipo	Descrição
auto_trigger	Boolean	Se o backup é gerado automaticamente
bootable	Boolean	Se o backup é um backup em disco do sistema
incremental	Boolean	Se o backup é um backup incremental
snapshot_id	String	ID do snapshot do backup em disco
support_lld	Boolean	Se permitir lazyloading para restauração rápida
supported_restore_mode	String	Modo de restauração. Os valores possíveis são na, snapshot e backup. snapshot indica que o backup pode ser usado para criar uma imagem de servidor completo. backup indica que os dados são restaurados a partir de backups em discos EVS do servidor. na indica que o backup só pode ser usado para criar novos recursos, mas não pode ser usado para restauração. Padrão: na Valores de enumeração: na backup snapshot
os_images_data	Array of ImageData objects	Lista de IDs de imagens criadas usando backups
contain_system_disk	Boolean	Se os dados de backup da máquina virtual contêm dados de disco do sistema
encrypted	Boolean	Se o backup é criptografado
system_disk	Boolean	Se o disco é um disco do sistema

**Tabela 6** ImageData
Parâmetro	Tipo	Descrição
image_id	String	ID da imagem

**Tabela 7** ReplicationRecordGet
Parâmetro	Tipo	Descrição
created_at	String	Hora de início da replicação
destination_backup_id	String	ID do backup de destino usado para replicação
destination_checkpoint_id	String	ID de registro do backup de destino usado para replicação
destination_project_id	String	ID do projeto de replicação de destino
destination_region	String	Região de replicação de destino
destination_vault_id	String	ID do cofre de destino
extra_info	ReplicationRecordsExtraInfo object	Informações adicionais sobre a replicação
id	String	ID do registro de replicação
source_backup_id	String	ID do backup de origem usado para replicação
source_checkpoint_id	String	ID do registro de backup de origem usado para replicação
source_project_id	String	ID do projeto de origem de replicação
source_region	String	Região de origem de replicação
status	String	Estado da replicação Valores de enumeração: replicating success fail skip waiting_replicate
vault_id	String	ID do cofre onde reside o backup

**Tabela 8** ReplicationRecordsExtraInfo
Parâmetro	Tipo	Descrição
progress	Integer	Progresso da replicação
fail_code	String	Código de erro. Este campo estará vazio se a operação for bem-sucedida.
fail_reason	String	Causa do erro
auto_trigger	Boolean	Se a replicação é agendada automaticamente
destinatio_vault_id	String	ID do cofre de destino

Exemplo de solicitações

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

Exemplo de respostas

Código de status: 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"
  }
}

Códigos de status

Código de status	Descrição
200	OK

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Backups

Tópico anterior: Sincronização de um backup

Próximo tópico: Consulta de todos os backups

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.