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

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

{
  "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

Tópico anterior: Tarefas

Próximo tópico: Consulta da lista de tarefas

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.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar