Definição de uma política de backup entre regiões

Função

Esta API é usada para definir uma política de backup entre regiões na região de backup de origem.

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

Restrições

• Se a política de backup entre regiões tiver sido ativada, chame a API para definir a política de backup entre regiões. Apenas o período de retenção pode ser alterado.
• Para instâncias de banco de dados do RDS for MySQL e RDS for PostgreSQL, o período de retenção dos arquivos de backup completo automático deve ser o mesmo dos arquivos de backup incremental automático.
• Para instâncias de banco de dados do RDS for MySQL e RDS for PostgreSQL, o backup incremental automático não pode ser ativado, a menos que backup completo automático seja ativado primeiro.
• Para instâncias de banco de dados do RDS for MySQL e RDS for PostgreSQL, se você quiser desativar backup completo automático e backup incremental automático, desative primeiro backup incremental automático.

URI

• Formato de URI

  PUT /v3/{project_id}/instances/{instance_id}/backups/offsite-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
  policy_para	Sim	Array of objects	Especifica o objeto de política de backup, incluindo o tipo de backup, os dias de retenção de backup, o ID da região de destino e o ID do projeto de destino. Para mais detalhes, consulte Tabela 3.

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

  Nome	Obrigatório	Tipo	Descrição
  backup_type	Sim	String	Especifica o tipo de backup. Para o RDS for SQL Server, este parâmetro só pode ser definido como all. O valor pode ser qualquer um dos seguintes: auto: backup completo automático incremental: backup incremental automático all: todos os tipos de backup RDS for MySQL: ative backup completo automático e backup incremental automático. RDS for PostgreSQL: ative backup completo automático e backup incremental automático. RDS for SQL Server: ative backup completo automático, backup incremental automático e backup manual.
  keep_days	Sim	Integer	Especifica o número de dias para reter os arquivos de backup gerados. Intervalo de valores: 0-1825 O valor 0 indica que a política de cópia de segurança entre regiões está desativada. AVISO: Depois que a política de backup automático estiver desativada, os backups automáticos não serão mais criados e todos os backups incrementais, se houver, serão excluídos imediatamente. As operações relacionadas aos backups incrementais, incluindo downloads, replicações, restaurações e reconstruções podem falhar.
  destination_region	Sim	String	Especifica o ID da região de destino para a política de backup entre regiões.
  destination_project_id	Sim	String	Especifica o ID do projeto de destino para a política de backup entre regiões.

• Exemplo

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

• Exemplo de solicitação

  MySQL e PostgreSQL:

  Atualização de uma política de backup completo automático entre regiões:

  {
  	"policy_para": {
                  "backup_type": "auto",
  		"keep_days": 7,
  		"destination_region": "eu-de",
  		"destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c"
  	}
  }

  Desativação de uma política de backup completo automático entre regiões:

  {
  	"policy_para": {
                  "backup_type": "auto",
  		"keep_days": 0,
  		"destination_region": "eu-de",
  		"destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c"
  	}
  }

  Microsoft SQL Server:

  Atualização de uma política de backup entre regiões:

  {
  	"policy_para": {
                  "backup_type": "all",
  		"keep_days": 7,
  		"destination_region": "eu-de",
  		"destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c"
  	}
  }

  Desativação de uma política de backup entre regiões

  {
  	"policy_para": {
                  "backup_type": "all",
  		"keep_days": 0,
  		"destination_region": "eu-de",
  		"destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c"
  	}
  }

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.