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
} 
