Definição de uma política de backup automático

Função

Esta API é usada para definir uma política de backup automático.

• Antes de chamar uma API, você precisa entender a API em Autenticação.

URI

• Formato de URI

  PUT /v3/{project_id}/instances/{instance_id}/backups/policy

• Descrição do parâmetro

  Tabela 1 Descrição do parâmetro

  Nome	Obrigatório	Descrição
  project_id	Sim	Especifica o ID do projeto de um locatário em uma região. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
  instance_id	Sim	Especifica o ID da instância de banco de dados.

Solicitação

• Descrição do parâmetro

  Tabela 2 Descrição do parâmetro

  Nome	Obrigatório	Tipo	Descrição
  backup_policy	Sim	Object	Especifica os objetos de política de backup, incluindo o período de retenção de backup (dias) e a hora de início do backup. Para mais detalhes, consulte Tabela 3.
  reserve_backups	Não	Boolean	Especifica se devem reter backups automáticos e não sincronizados. Este parâmetro só está válido quando a política de backup automático está desativada. true: indica que backups automáticos e não sincronizados são mantidos. false: indica que backups automáticos e não sincronizados são excluídos quando a política de backup está desativada.

  Tabela 3 Descrição da estrutura de dados do campo backup_policy

  Nome	Obrigatório	Tipo	Descrição
  keep_days	Sim	Integer	Especifica o número de dias para reter os arquivos de backup gerados. O intervalo de valores é de 0 a 732. O valor 0 indica que a política de backup automático está desativada. Para estender o período de retenção, entre em contato com o atendimento ao cliente. Backups automáticos podem ser mantidos por até 2.562 dias. AVISO: Depois que a política de backup automático está desativada, os backups automáticos não são mais criados e todos os backups incrementais são excluídos imediatamente. Operações relacionadas aos backups incrementais, incluindo downloads, replicações, restaurações e reconstruções podem falhar.
  start_time	Não	String	Especifica a janela de tempo de backup. Os backups automáticos serão acionados durante a janela de tempo de backup. Este parâmetro é obrigatório, exceto pelo fato de a política de backup automático estar desativada. O valor deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC. O valor de HH deve ser 1 maior que o valor de hh. Os valores de mm and MM devem ser os mesmos e devem ser definidos como: 00, 15, 30 ou 45. Valor de exemplo 08:15-09:15 23:00-00:00
  period	Não	String	Especifica a configuração do ciclo de backup. Os dados serão automaticamente copiados nos dias selecionados a cada semana. Este parâmetro é obrigatório, exceto pelo fato de a política de backup automático estar desativada. Intervalo de valores: o valor é um número separado por vírgulas (,), que indica os dias da semana. Por exemplo, o valor 1,2,3,4 indica que o período de backup é segunda-feira, terça-feira, quarta-feira e quinta-feira.

• Exemplo

  PUT https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/backups/policy

• Exemplo de solicitação

  Modificação da política de backup automático:

  {
  	"backup_policy": {
  		"keep_days": 7,
  		"start_time": "19:00-20:00",
  		"period": "1,2"
  	}
  }

  Desativação da política de backup automático:

  {
  	"backup_policy": {
  		"keep_days": 0
  	},
  	"reserve_backups": false
  }

Resposta

• Resposta normal

  Nenhuma

• Resposta anormal

  Para mais detalhes, consulte Resultados anormais da solicitação.

Código de status

• Normal

  200

• Anormal

  Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.