Consulta de uma política de backup automatizado
Função
Essa API é usada para consultar uma política de backup automatizado. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
GET /v3/{project_id}/instances/{instance_id}/backups/policy
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
instance_id |
Sim |
String |
ID da instância, que é compatível com o formato UUID. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token. |
X-Language |
Não |
String |
Tipo de linguagem da solicitação. O valor padrão é en-us. Valor:
|
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
backup_policy |
BackupPolicy object |
Informações de política de backup. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
keep_days |
Integer |
Dias de retenção de backup. Valor: 1 a 732 |
start_time |
String |
Janela de tempo de backup. Os backups automatizados serão acionados durante a janela de tempo de backup. O valor deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC. |
period |
String |
Configuração do ciclo de backup. O backup dos dados será feito automaticamente nos dias selecionados a cada semana. o valor é um número separado por vírgulas (,), indicando os dias da semana. |
retention_num_backup_level1 |
Integer |
Número de backups de nível 1 retidos. Esse parâmetro é retornado quando o backup de nível 1 está ativado. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitação
Consulta da política de backup automatizado de uma instância de BD
GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/61a4ea66210545909d74a05c27a7179ein07/backups/policy
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "backup_policy" : { "keep_days" : "7,", "start_time" : "19:00-20:00", "period" : "1,2", "retention_num_backup_level1" : 1 } }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.