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/ As API desatualizadas (Indisponível em breve)/ As API de backup e restauração/ Consulta de registros de backup de instâncias do DCS

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

Ver PDF

Consulta de registros de backup de instâncias do DCS

Função

Essa API é usada para consultar os registros de backup de uma instância de DCS especificada.

URI

GET /v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}

Tabela 1 descreve os parâmetros.

**Tabela 1** Descrição do parâmetro
Parâmetro	Tipo	Obrigatório	Descrição
project_id	String	Sim	ID do projeto.
instance_id	String	Sim	ID da instância do DCS.
start	Integer	Não	Iniciar o número de sequência do registo de cópia de segurança a consultar. Por padrão, esse parâmetro é definido como 1.
limit	Integer	Não	Número de registros de backup exibidos em cada página. O valor mínimo deste parâmetro é 1. Se esse parâmetro não for definido, 10 registros de backup serão exibidos em cada página por padrão.
beginTime	String	Não	Hora de início do período a ser consultado. Formato: aaaaMMddHHmmss, por exemplo, 20170718235959.
endTime	String	Não	Hora de término do período a ser consultado. Formato: aaaaMMddHHmmss, por exemplo, 20170718235959.

Solicitar

Parâmetros de solicitação

Nenhum.

Exemplo de solicitações

GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/backups?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}

Resposta

Parâmetros de resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Descrição do parâmetro
Parâmetro	Tipo	Descrição
backup_record_response	Array	Matriz dos registros de backup. Para obter detalhes sobre backup_record_response, consulte Tabela 3.
total_num	Integer	Número de registros de backup obtidos.

**Tabela 3** descrição do parâmetro backup_record_response
Parâmetro	Tipo	Descrição
status	String	Status do backup. Opções: waiting: A restauração da instância do DCS está aguardando o início. 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 expira. deleted: O arquivo de backup foi excluído manualmente.
remark	String	Descrição do backup da instância DCS
period	String	Segmento de tempo em que o backup da instância do DCS foi realizado
progress	String	Progresso do backup
size	Long	Tamanho do arquivo de backup. Unidade: byte.
instance_id	String	ID da instância do DCS
backup_id	String	ID do registro de backup
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
execution_at	String	Hora em que o backup é iniciado.
backup_type	String	Tipo de backup. Opções: manual: backup manual auto: backup automático
backup_name	String	Nome do registro de backup
error_code	String	Código de erro retornado se o backup da instância DCS falhar. Para obter detalhes sobre códigos de erro, consulte Tabela 4.
is_support_restore	String	Um indicador de se a restauração é suportada. Opções: TRUE ou FALSE.

**Tabela 4** Códigos de erro retornados em caso de falha de backup ou restauração
Código de erro	Descrição
dcs.08.0001	Falha ao iniciar a ferramenta de backup e restauração.
dcs.08.0002	A operação expirou.
dcs.08.0003	Falha ao excluir bucket.
dcs.08.0004	Falha ao obter AK/SK.
dcs.08.0005	Falha ao criar bucket.
dcs.08.0006	Falha ao obter o tamanho do arquivo de backup.
dcs.08.0007	A sincronização de dados falhou durante a restauração da instância.
dcs.08.0008	O backup automático da instância não pode ser iniciado porque a instância está executando outros trabalhos.

Exemplo de resposta

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