Criação de uma instância de BD

Função

Esta API é usada para criar uma instância do TaurusDB. Antes de chamar essa API:

Essa API estará indisponível em 31 de março de 2024.

• Saiba como autorizá-la e autenticá-la.
• Obtenha a região e o ponto de extremidade necessários.

URI

• Formato de URI

  POST https://{endpoint}/mysql/v3/{project_id}/instances

• Exemplo

  POST https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/instances

• Descrição do parâmetro

  Tabela 1 Descrição do parâmetro

  Nome	Obrigatório	Descrição
  project_id	Sim	ID do projeto de um locatário em uma região. Para obter esse valor, consulte Obtenção de um ID de projeto.

Solicitação

O valor de region no seguinte é usado como um exemplo.

• Exemplo de solicitação

  {
  "charge_info":{
          "charge_mode":"postPaid"
      },
      "region":"xxx",
      "name":"gaussdb-2d34",
      "datastore":{
          "type":"gaussdb-mysql",
          "version":"8.0"
      },
      "mode":"Cluster",
      "flavor_ref":"gaussdb.mysql.large.x86.4",
      "vpc_id":"f7ee62e2-9705-4523-ba49-a85ea1a1fa87",
      "subnet_id":"140af7bf-a9da-4dcf-8837-34199fd6d186",
      "security_group_id":"c7f69884-fe2b-4630-8114-70a11499d902",
      "configuration_id":"43570e0de32e40c5a15f831aa5ce4176pr07",
      "password":"xxxx",
      "backup_strategy":{
          "start_time":"17:00-18:00"
      },
      "time_zone":"UTC+08:00",
      "availability_zone_mode":"multi",
      "master_availability_zone":"az1pod1",
      "slave_count":1,
      "enterprise_project_id":"0",
      "lower_case_table_names":1
  }

Resposta

• Resposta normal

  Tabela 8 Descrição do parâmetro

  Nome	Tipo	Descrição
  instance	Object	Informações da instância. Para mais detalhes, consulte Tabela 9.
  job_id	String	ID da tarefa de criação da instância de BD. Esse parâmetro é retornado somente quando instâncias de BD de pagamento por uso são criadas.
  order_id	String	ID do pedido. Este parâmetro é retornado somente quando instâncias anuais/mensais são criadas.

  Tabela 9 Descrição da estrutura de dados do campo de instância

  Nome	Tipo	Descrição
  id	String	ID da instância de BD.
  name	String	Nome da instância de BD. Instâncias do mesmo tipo podem ter os mesmos nomes sob o mesmo locatário. O valor consiste de 4 a 64 caracteres e começa com uma letra. Não diferencia maiúsculas de minúsculas e contém apenas letras, dígitos, hifens (-) e sublinhados (_).
  status	String	Status da instância de BD. Esse parâmetro é retornado somente quando instâncias de BD de pagamento por uso são criadas.
  datastore	Object	Informações do banco de dados. Para mais detalhes, consulte Tabela 10.
  mode	String	Tipo de instância de BD. Atualmente, apenas o tipo de cluster é suportado.
  configuration_id	String	ID do modelo de parâmetro.
  port	String	Porta do banco de dados, que é a mesma do parâmetro de solicitação.
  backup_strategy	Object	Política de backup automatizado. Para mais detalhes, consulte Tabela 11.
  enterprise_project_id	String	ID do projeto empresarial, que é o mesmo que o parâmetro de solicitação.
  region	String	ID da região, que é o mesmo que o parâmetro de solicitação.
  availability_zone_mode	String	Tipo de AZ, que é o mesmo que o parâmetro de solicitação.
  master_ availability_zone	String	ID de AZ primária.
  vpc_id	String	ID de VPC, que é igual ao parâmetro de solicitação.
  security_group_id	String	ID do grupo de segurança, que é o mesmo que o parâmetro de solicitação.
  subnet_id	String	ID de sub-rede, que é o mesmo que o parâmetro de solicitação.
  flavor_ref	String	Código de especificação, que é o mesmo que o parâmetro de solicitação. Para mais detalhes, consulte Tabela 3.
  charge_info	Object	Modo de cobrança, que é anual/mensal ou pagamento por uso. Para mais detalhes, consulte Tabela 12.

  Tabela 10 Descrição da estrutura de dados do campo datastore

  Nome	Tipo	Descrição
  type	String	Mecanismo de BD
  version	String	Versão de BD.

  Tabela 11 Descrição da estrutura de dados do campo backup_strategy

  Nome	Tipo	Descrição
  start_time	String	Janela de tempo de backup. Os backups automatizados serão acionados durante a janela de tempo de backup.
  keep_days	Integer	Dias de retenção de backup.

  Tabela 12 Descrição da estrutura de dados do campo charge_info

  Nome	Tipo	Descrição
  charge_mode	String	Modo de cobrança, que é anual/mensal ou pagamento por uso.
  period_num	Integer	Duração da assinatura, que é calculada por mês. Este parâmetro é válido quando charge_mode é definido como prePaid (este parâmetro é válido apenas para instâncias anuais/mensais).

Os valores de region e master_availability_zone são usados como exemplos.

• Exemplo de resposta normal

  {
      "instance":{
          "id":"5eebbb4c0f9f4a99b42ed1b6334569aain07",
          "name":"gaussdb-2d34",
          "status":"BUILD",
          "datastore":{
              "type":"gaussdb-mysql",
              "version":"8.0"
          },
          "mode":"Cluster",
          "configuration_id": "",
          "port":null,
          "backup_strategy":{
              "start_time":null,
              "keep_days":"7"
          },
          "enterprise_project_id": "0",
          "region":"aaa",
          "availability_zone_mode":"multi",
          "master_availability_zone":"aaa",
          "vpc_id":"f7ee62e2-9705-4523-ba49-a85ea1a1fa87",
          "security_group_id":"c7f69884-fe2b-4630-8114-70a11499d902",
          "subnet_id":"140af7bf-a9da-4dcf-8837-34199fd6d186"
          "charge_info":{
              "charge_mode":"postPaid"
          },
          "flavor_ref":"gaussdb.mysql.large.x86.4"
      },
      "job_id":"43672fe5-56bd-47f1-8fd1-595cded08a7c"
      }

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.