Criação de um backup manual

Função

Esta API é usada para criar um backup manual.

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

Restrições

• O Microsoft SQL Server oferece suporte à chamada em lote desta API para criar backups manuais para um banco de dados.

• Réplicas de leitura não suportam a criação de backup manual.
• O nome do backup deve ser exclusivo.

URI

• Formato de URI

  POST /v3/{project_id}/backups

• 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.

Solicitação

• Descrição do parâmetro

  Tabela 2 Descrição do parâmetro

  Nome	Obrigatório	Tipo	Descrição
  instance_id	Sim	String	Especifica o ID da instância de banco de dados.
  name	Sim	String	Especifica o nome do backup. Deve ter de 4 a 64 caracteres, começar com uma letra e conter apenas letras (diferencia maiúsculas e minúsculas), dígitos, hifens (-) e sublinhados (_). O nome do backup deve ser exclusivo.
  description	Não	String	Especifica a descrição do backup. Ela contém no máximo 256 caracteres e não pode conter os seguintes caracteres especiais: >!<"&'=
  databases	Não	Array of objects	Especifica uma lista de bancos de dados autocriados do RDS for SQL Server que são parcialmente armazenados em backup. (Somente o RDS for SQL Server oferece suporte a backups parciais.) Para mais detalhes, consulte Tabela 3.

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

  Nome	Obrigatório	Tipo	Descrição
  name	Sim	String	Especifica os nomes de bancos de dados autocriados.

• Exemplo

  POST https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/backups

• Exemplo de solicitação
  Criação de um backup manual para uma instância de banco de dados do RDS for MySQL:

  {
  	"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
  	"name": "mybackup",
  	"description": "manual backup"
  }

  Criação de um backup manual para uma instância de banco de dados do RDS for PostgreSQL:

  {
  	"instance_id": "a8a5fc65b1a04ceb9d72212891ad73f8in03",
  	"name": "mybackup",
  	"description": "manual backup"
  }

  Criação de um backup manual para uma instância de banco de dados do RDS for SQL Server:

  {
  	"instance_id": "34029da944074135a3bc24c75b3bb3edin04",
  	"name": "mybackup",
  	"description": "manual backup",
  	"databases": [{
  		"name": "db1"
  	}, {
  		"name": "db2"
  	}]
  }

Resposta

• Resposta normal

  Tabela 4 Descrição do parâmetro

  Nome	Tipo	Descrição
  backup	Object	Indica as informações de backup. Para mais detalhes, consulte Tabela 5.

  Tabela 5 Descrição da estrutura de dados do campo backup

  Nome	Tipo	Descrição
  id	String	Indica o ID de backup.
  instance_id	String	Indica o ID da instância de banco de dados.
  name	String	Indica o nome do backup.
  description	String	Indica a descrição do backup.
  databases	Array of objects	Indica uma lista de bancos de dados autocriados do RDS for SQL Server que são parcialmente backed up. (Somente o RDS for SQL Server oferece suporte a backups parciais.) Para mais detalhes, consulte Tabela 3.
  begin_time	String	Indica a hora de início de backup no formato "yyyy-mm-ddThh:mm:ssZ", onde "T" indica a hora de início do campo de tempo e "Z" indica o deslocamento do fuso horário.
  status	String	Indica o status do backup. Valor: BUILDING: backup em andamento COMPLETED: backup concluído FAILED: falhou no backup. DELETING: backup sendo excluído
  type	String	Indica o tipo de backup. Valor: auto: backup completo automático manual: backup completo manual fragment: backup completo diferencial incremental: backup incremental automático

• Exemplo de resposta normal
  Criação de um backup manual para uma instância de banco de dados do RDS for MySQL:

  {
  	"backup": {
  		"id": "cb211c0075104151a748a854bc8bd87dbr01",
  		"name": "mybackup",
  		"description": "manual backup",
  		"begin_time": "2022-08-23T07:41:50Z",
  		"status": "BUILDING",
  		"type": "manual",
  		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01"
  	}
  }

  Criação de um backup manual para uma instância de banco de dados do RDS for PostgreSQL:

  {
  	"backup": {
  		"id": "104b59afd83d4fc7b2c03ad14c4be080br03",
  		"name": "mybackup",
  		"description": "manual backup",
  		"begin_time": "2022-08-23T07:20:36Z",
  		"status": "BUILDING",
  		"type": "manual",
  		"instance_id": "a8a5fc65b1a04ceb9d72212891ad73f8in03"
  	}
  }

  Criação de um backup manual para uma instância de banco de dados do RDS for SQL Server:

  {
  	"backup": {
  		"id": "6f7b5904b04043b38ad764e33daba810br04",
  		"name": "mybackup",
  		"description": "manual backup",
  		"begin_time": "2022-08-23T07:15:28Z",
  		"status": "BUILDING",
  		"type": "manual",
  		"instance_id": "34029da944074135a3bc24c75b3bb3edin04",
  		"databases": [{
  			"name": "db1"
                  }, {
  			"name": "db2"
  		}]
  	}
  }

• 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.