Configuração de uma política de backup na mesma região
Função
Essa API é usada para configurar uma política de backup da mesma região. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
PUT /v3/{project_id}/instances/{instance_id}/backups/policy/update
| 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. Para obter esse valor, chame a API do IAM para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token. |
| X-Language | Não | String | Tipo de linguagem da solicitação. O valor padrão é en-us. Valores:
|
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| backup_policy | Sim | MysqlBackupPolicy object | Política de backup de banco de dados. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| start_time | Sim | String | Janela de tempo de backup. Os backups automatizados serão acionados durante a janela de tempo de backup. O valor não pode ser vazio. Deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC.
Exemplo: 21:00–22:00 |
| keep_days | Sim | Integer | Dias de retenção de backup. Intervalo de valores: 1–732. Você também pode entrar em contato com o atendimento ao cliente para estender o período de retenção para 3.660 dias. |
| period | Sim | String | Configuração do ciclo de backup. O backup dos dados será feito automaticamente nos dias selecionados a cada semana. O valor é uma lista de números separados por vírgulas (,), onde cada número mais um representa um dia da semana para backups automatizados. Por exemplo, 1,2,3,4,5,6,7 indica que o backup dos dados é feito todos os dias, de terça a segunda-feira. |
| retention_num_backup_level1 | Não | Integer | Número de backups de nível 1 retidos. O valor pode ser 0 ou 1. O valor padrão é 0. Esse parâmetro é obrigatório somente quando a função de backup de nível 1 está ativada. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| status | String | Informações de status. Valores:
|
| instance_id | String | ID da instância, que é compatível com o formato UUID. |
| instance_name | String | Nome da instância. |
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
Modificação da política de backup automatizado da instância de BD (o backup dos dados é feito das 19:00 às 20:00 todas as segundas a sextas-feiras. Os arquivos de backup são armazenados por sete dias.)
PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/backups/policy/update
{
"backup_policy" : {
"keep_days" : 7,
"start_time" : "19:00-20:00",
"period" : "1,2,3,4,5"
}
} Exemplo de resposta
Código de status: 200
Bem-sucedido.
{
"status" : "COMPLETED",
"instance_id" : "ba62a0b83a1b42bfab275829d86ac0fdin07",
"instance_name" : "gauss-mysql"
} Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.
