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/ Listagem de registros de backup da instância do DCS

Atualizado em 2022-11-09 GMT+08:00

Ver PDF

Listagem de registros de backup da instância do DCS

Função

Essa API é usada para consultar os registros de backup de uma instância específica do DCS.

URI

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

**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 da consulta (UTC). Formato: aaaaMMddHHmmss, por exemplo, 20170718235959.
end_time	Não	String	Hora final da consulta (UTC). 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
total_num	Integer	Número de registros retornados.
backup_record_response	Array of BackupRecordResponse objects	Matriz dos detalhes do backup.

**Tabela 4** BackupRecordResponse
Parâmetro	Tipo	Descrição
backup_id	String	ID de backup.
period	String	Tempo de execução do backup.
backup_name	String	Nome do registro de backup.
instance_id	String	ID da instância.
size	Long	Tamanho do arquivo de backup (byte).
backup_type	String	Tipo de backup. manual: backup manual auto: backup automático Valores de enumeração: manual auto
created_at	String	Hora em que a tarefa de backup é criada.
updated_at	String	Hora em que o backup da instância do DCS é concluído.
progress	String	Progresso do backup.
error_code	String	Código de erro exibido para uma falha de backup. 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.
remark	String	Descrição do backup da instância DCS.
status	String	Status do backup. As opções são as seguintes: waiting: A tarefa está esperando para começar. backuping: O backup da instância do DCS está em andamento. succeed: O backup da instância do DCS foi bem-sucedido. failed: Falha no backup da instância do DCS. expired: O arquivo de backup expirou. deleted: O arquivo de backup foi excluído manualmente. Valores de enumeração: waiting backuping succeed failed expired deleted
is_support_restore	String	Se a restauração é suportada. Opções: TRUE e FALSE.

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

Código de estado: 500

**Tabela 6** 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}/backups?offset={offset}&limit={limit}&beginTime={begin_Time}&end_time={end_Time}

Exemplo de respostas

Código de estado: 200

Registros de backup da instância DCS consultados com êxito.

{
  "total_num" : 1,
  "backup_record_response" : [ {
    "period" : { },
    "backup_type" : "manual",
    "created_at" : "2019-05-10T08:31:16.166Z",
    "remark" : "001",
    "is_support_restore" : "TRUE",
    "backup_id" : "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
    "backup_name" : "backup_20190510163116",
    "instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
    "size" : 880232,
    "updated_at" : "2019-05-10T08:32:30.546Z",
    "progress" : "100.00",
    "error_code" : { },
    "status" : "succeed"
  } ]
}