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/ Tarefas/ Consulta de uma única tarefa
Atualizado em 2023-04-26 GMT+08:00
Ver PDF
Compartilhar

Consulta de uma única tarefa

Função

Esta API é usada para consultar uma tarefa por ID de tarefa.

URI

GET /v3/{project_id}/operation-logs/{operation_log_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

operation_log_id

Sim

String

ID da tarefa

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

operation_log

OperationLog object

Informações sobre a tarefa
Tabela 4 OperationLog

Parâmetro

Tipo

Descrição

checkpoint_id

String

ID do registro de backup

created_at

String

Tempo de criação, por exemplo, 2020-02-23T01:00:32Z

ended_at

String

Hora de término da tarefa, por exemplo, 2020-02-23T01:00:32Z

error_info

OpErrorInfo object

Mensagem de erro da tarefa

extra_info

OpExtraInfo object

Informações sobre a extensão da tarefa

id

String

ID da tarefa

operation_type

String

Tipo da tarefa

Valores de enumeração:

  • backup
  • copy
  • replication
  • restore
  • delete
  • sync
  • vault_delete
  • remove_resource

policy_id

String

ID da política

project_id

String

ID do projeto

provider_id

String

ID do provedor de backup, que especifica se o objeto de backup é um servidor ou disco

started_at

String

Hora de início da tarefa, por exemplo, 2020-02-23T01:00:32Z

status

String

Status da tarefa

Valores de enumeração:

  • success
  • skipped
  • failed
  • running
  • timeout
  • waiting

updated_at

String

Tempo de modificação, por exemplo, 2020-02-23T01:00:32Z

vault_id

String

ID do cofre com o qual o recurso de destino está associado

vault_name

String

Nome do cofre com o qual o recurso de destino está associado
Tabela 5 OpErrorInfo

Parâmetro

Tipo

Descrição

code

String

Para obter detalhes, consulte Códigos de erro.

message

String

Mensagem de erro
Tabela 6 OpExtraInfo

Parâmetro

Tipo

Descrição

backup

OpExtendInfoBckup object

Parâmetros estendidos de backup

common

OpExtendInfoCommon object

Parâmetros comuns

delete

OpExtendInfoDelete object

Parâmetros estendidos de exclusão

sync

OpExtendInfoSync object

Parâmetros estendidos de sincronização

remove_resources

OpExtendInfoRemoveResources object

Parâmetros estendidos de remover recursos de um cofre

replication

OpExtendInfoReplication object

Parâmetros estendidos de replicação

resource

Resource object

Informações de recurso

restore

OpExtendInfoRestore object

Parâmetros estendidos de restauração

vault_delete

OpExtendInfoVaultDelete object

Parâmetros estendidos de exclusão de um cofre
Tabela 7 OpExtendInfoBckup

Parâmetro

Tipo

Descrição

app_consistency_error_code

String

Código de erro retornado se o backup consistente com a aplicação falhar. Para obter detalhes, consulte Códigos de erro.

app_consistency_error_message

String

Mensagem de erro retornada se o backup consistente com a aplicação falhar

app_consistency_status

String

Status do backup consistente a aplicação, que pode ser definido como 0 (backup não consistente com a aplicação) ou 1 (backup consistente com a aplicação)

Valores de enumeração:

  • 0
  • 1

backup_id

String

ID do backup

backup_name

String

Nome do backup

incremental

String

Se o backup incremental é usado

Valores de enumeração:

  • "true"
  • "false"
Tabela 8 OpExtendInfoCommon

Parâmetro

Tipo

Descrição

progress

Integer

Progresso da tarefa de consulta. O valor varia de 0 a 100.

Mínimo: 0

Máximo: 100

request_id

String

ID da solicitação

task_id

String

ID da tarefa de backup
Tabela 9 OpExtendInfoDelete

Parâmetro

Tipo

Descrição

backup_id

String

ID do backup

backup_name

String

Nome do backup
Tabela 10 OpExtendInfoSync

Parâmetro

Tipo

Descrição

sync_backup_num

Integer

Número de backups sincronizados

delete_backup_num

Inteiro

Número de backups excluídos

err_sync_backup_num

Integer

Número de backups que não conseguiram ser sincronizados
Tabela 11 OpExtendInfoRemoveResources

Parâmetro

Tipo

Descrição

fail_count

Integer

Número de recursos que falhou ao ser excluídos

total_count

Inteiro

Número de backups excluídos

resources

Array of Resource objects

Informações de recurso
Tabela 12 Recurso

Parâmetro

Tipo

Descrição

extra_info

ResourceExtraInfo object

Nome do cofre

id

String

ID do tipo de recurso do cofre

name

String

Nome do recurso a ser copiado. O valor consiste de 0 a 255 caracteres.

Mínimo: 0

Máximo: 255

Tipo

String

[Tipo do recurso a ser copiado, que pode ser OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo ou OS::Workspace::DesktopV2] (tag:hws,hws_hk)
Tabela 13 OpExtendInfoReplication

Parâmetro

Tipo

Descrição

destination_backup_id

String

ID do backup de destino

destination_checkpoint_id

String

ID do ponto de restauração de destino

destination_project_id

String

ID do projeto de destino

destination_region

String

região de destino

source_backup_id

String

ID de backup de origem

source_checkpoint_id

String

ID do ponto de restauração de origem

source_project_id

String

ID do projeto de origem

source_region

String

Região de origem

source_backup_name

String

Nome do backup de origem

destination_backup_name

String

Nome do backup de destino
Tabela 14 ResourceExtraInfo

Parâmetro

Tipo

Descrição

exclude_volumes

Array of strings

IDs dos discos dos quais não será feito backup. Este parâmetro é usado quando os servidores são adicionados a um cofre, que inclui todos os discos do servidor. Mas alguns discos não precisam ser copiados. Ou no caso de um servidor ter sido adicionado anteriormente e alguns discos neste servidor não precisarem ser copiados.
Tabela 15 OpExtendInfoRestore

Parâmetro

Tipo

Descrição

backup_id

String

ID do backup

backup_name

String

Nome do backup

target_resource_id

String

ID do recurso a ser restaurado

target_resource_name

String

Nome do recurso a ser restaurado
Tabela 16 OpExtendInfoVaultDelete

Parâmetro

Tipo

Descrição

fail_count

Integer

Número de recursos que falham ao serem excluídos nesta tarefa

total_count

Integer

Número de backups excluídos nesta tarefa

Código de status: 404

Tabela 17 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Para obter detalhes, consulte Códigos de erro.

error_msg

String

Mensagem de erro

Exemplo de solicitações

GET https://{endpoint}/v3/{project_id}/operation-logs/{operation_log_id}

Exemplo de respostas

Código de status: 200

OK

{
  "operation_log" : {
    "status" : "success",
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "checkpoint_id" : "b432511f-d889-428f-8b0e-5f47c524c6b6",
    "updated_at" : "2019-05-23T14:35:23.584418",
    "error_info" : {
      "message" : "",
      "code" : ""
    },
    "vault_id" : null,
    "started_at" : "2019-05-23T14:31:36.007230",
    "id" : "4827f2da-b008-4507-ab7d-42d0df5ed912",
    "extra_info" : {
      "resource" : {
        "type" : "OS::Nova::Server",
        "id" : "1dab32fa-ebf2-415a-ab0b-eabe6353bc86",
        "name" : "ECS-0001"
      },
      "backup" : {
        "backup_name" : "manualbk_1234",
        "backup_id" : "0e5d0ef6-7f0a-4890-b98c-cb12490e31c1"
      },
      "common" : {
        "progress" : 100,
        "request_id" : "req-cdb98cc4-e87b-4f40-9b4a-57ec036620bc"
      }
    },
    "ended_at" : "2019-05-23T14:35:23.511155",
    "created_at" : "2019-05-23T14:31:36.039365",
    "operation_type" : "backup",
    "vault_name" : null,
    "project_id" : "04f1829c788037ac2fb8c01eb2b04b95",
    "policy_id" : null
  }
}

Código de status: 404

O ID da tarefa não existe.

{
  "error_code" : "BackupService.6500",
  "error_msg" : "Operation log does not exist."
}

Códigos de status

Código de status

Descrição

200

OK

404

O ID da tarefa não existe.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Tarefas