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/ Distributed Cache Service/ Referência de API/ API V2/ Backup e restauração/ Consulta de registros de restauração de instância do DCS
Atualizado em 2022-11-09 GMT+08:00
Ver PDF
Compartilhar

Consulta de registros de restauração de instância do DCS

Função

Essa API é usada para consultar os registros de restauração de uma instância de DCS específica.

URI

GET /v2/{project_id}/instances/{instance_id}/restores

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

instance_id

Sim

String

ID da instância.

project_id

Sim

String

ID do projeto.
Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

begin_time

Não

String

Hora de início do período a ser consultado. Formato: aaaaMMddHHmmss, por exemplo, 20170718235959.

end_time

Não

String

Hora de término do período a ser consultado. Formato: aaaaMMddHHmmss, por exemplo, 20170718235959.

limit

Não

Integer

Número de itens exibidos em cada página.

offset

Não

Integer

Deslocamento, que é a posição onde a consulta começa. O valor deve ser superior ou igual a 0.

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de estado: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

restore_record_response

Array of InstanceRestoreInfo objects

Matriz dos registros de restauração.

total_num

Integer

Número total.
Tabela 4 InstanceRestoreInfo

Parâmetro

Tipo

Descrição

backup_id

String

ID de backup.

restore_id

String

ID do registro de restauração.

backup_name

String

Nome do registro de backup.

updated_at

String

Hora em que a restauração foi concluída.

restore_remark

String

Descrição da restauração.

created_at

String

Hora em que a tarefa de restauração foi criada.

progress

String

Progresso da restauração.

error_code

String

Código de erro exibido para uma falha de restauração.

  • dcs.08.0001 - Falha ao iniciar a ferramenta de backup e restauração.
  • dcs.08.0002 - Tempo limite de execução.
  • dcs.08.0003 - Falha ao excluir o bucket.
  • dcs.08.0004 - Falha ao obter o AK/SK.
  • dcs.08.0005 - Falha ao criar o bucket.
  • dcs.08.0006 - Falha ao consultar o tamanho dos dados de backup.
  • dcs.08.0007 - Falha ao sincronizar dados durante a restauração.
  • dcs.08.0008 - A tarefa de backup agendada não está em execução. A instância está executando outras tarefas.

restore_name

String

Nome de um registro de restauração.

backup_remark

String

Descrição do backup.

status

String

Status de restauração.

  • waiting: A tarefa está esperando para começar.
  • restoring: A restauração está em andamento.
  • succeed: A restauração é bem sucedida.
  • failed: A restauração falhou.

Valores de enumeração:

  • waiting
  • restoring
  • succeed
  • failed

Código de estado: 400

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_msg

String

Mensagem de erro.

Máximo: 1024

error_code

String

Código de erro.

Máximo: 9

error_ext_msg

String

Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo.

Máximo: 1024

Exemplos de solicitações

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/restores?offset={offset}&limit={limit}&begin_Time={begin_Time}&end_Time={end_Time}

Exemplo de respostas

Código de estado: 200

Registros de restauração da instância DCS consultados com êxito.

{
  "restore_record_response" : [ {
    "backup_id" : "f4823e9e-fe9b-4ffd-be79-4e5d6de272bb",
    "restore_id" : "a6155972-800c-4170-a479-3231e907d2f6",
    "backup_name" : "backup_20170718000002",
    "updated_at" : "2017-07-18T21:41:35.182Z",
    "restore_remark" : "doctest",
    "created_at" : "2017-07-18T21:41:20.721Z",
    "progress" : "100.00",
    "error_code" : { },
    "restore_name" : "restore_20170718214120",
    "backup_remark" : { },
    "status" : "succeed"
  } ],
  "total_num" : 1
}

Códigos de status

Código de status

Descrição

200

Registros de restauração da instância DCS consultados com êxito.

400

Pedido inválido.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Backup e restauração