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
Compartilhar

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"
  } ]
}

Códigos de status

Código de status

Descrição

200

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

400

Pedido inválido.

500

Erro de serviço interno.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Backup e restauração