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

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
}