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
Compartilhar

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
}

Código de status

Tabela 4 descreve o código de status das operações bem-sucedidas. Para obter detalhes sobre outros códigos de status, consulte Tabela 1.

Tabela 4 Código de status

Código de status

Descrição

200

Registro de restauração de instância DCS consultado com êxito.