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}
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
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. |
Parâmetro |
Tipo |
Descrição |
|---|---|---|
status |
String |
Status do backup. Opções:
|
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:
|
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. |
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
}
