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 restauração de instâncias do DCS

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

Ver PDF

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

Função

Essa API é usada para consultar os registros de restauração de uma instância do DCS especificada.

URI

GET /v1.0/{project_id}/instances/{instance_id}/restores?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	Número de sequência inicial do registro de restauração a ser consultado. Por padrão, esse parâmetro é definido como 1.
limit	Integer	Não	Número de registros de restauração exibidos em cada página. O valor mínimo deste parâmetro é 1. Se esse parâmetro não for especificado, 10 registros de restauração 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.

Solicitação

Parâmetros de solicitação

Nenhum.

Exemplo de solicitações

GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/restores?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
restore_record_response	Array	Matriz dos registros de restauração.
total_num	Integer	Número de registros de backup obtidos.

**Tabela 3** descrição do parâmetro restore_record_response
Parâmetro	Tipo	Descrição
status	String	Status da restauração waiting: A restauração da instância do DCS está aguardando o início. restoring: A restauração da instância de DCS está em andamento. succeed: A restauração da instância do DCS foi bem-sucedida. failed: Falha na restauração da instância do DCS.
progress	String	Progresso da restauração
restore_id	String	ID do registro de restauração
backup_id	String	ID do registro de backup
restore_remark	String	Descrição da restauração da instância DCS
backup_remark	String	Descrição do backup da instância DCS
created_at	String	Hora em que a tarefa de restauração é criada
updated_at	String	Hora em que a restauração da instância do DCS foi concluída
restore_name	String	Nome do registro de restauração
backup_name	String	Nome do registro de backup
error_code	String	Código de erro retornado se a restauração da instância DCS falhar. Para obter detalhes sobre códigos de erro, consulte Tabela 4.

Exemplo de resposta

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