Creación de una instancia de base de datos

Función

Esta API se utiliza para crear una instancia de TaurusDB. Antes de invocar a esta API:

Esta API no estará disponible el 31 de marzo de 2024. Se recomienda cambiar las cargas de trabajo a la nueva API (Creación de una instancia) antes de esa fecha.

• Aprender cómo autorizar y autenticarla.
• Obtener los región y punto de conexión requeridos.

URI

• Formato de URI

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

• Ejemplo

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

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Descripción
  project_id	Sí	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.

Solicitud

El valor de region en lo siguiente se usa como ejemplo.

• Ejemplo de solicitud

  {
  "charge_info":{
          "charge_mode":"postPaid"
      },
      "region":"cn-north-4b",
      "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":"Gauss_234",
      "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
  }

Respuesta

• Respuesta normal

  Tabla 8 Descripción de parámetro

  Nombre	Tipo	Descripción
  instance	Object	Información de la instancia. Para obtener más información, consulte Tabla 9.
  job_id	String	ID de tarea de creación de instancia de base de datos. Este parámetro sólo se devuelve cuando se crean instancias de base de datos de pago por uso.
  order_id	String	ID de pedido. Este parámetro solo se devuelve cuando se crean instancias anuales/mensuales.

  Tabla 9 descripción de la estructura de datos de campo de instancia

  Nombre	Tipo	Descripción
  id	String	ID de instancia de base de datos.
  name	String	Nombre de instancia de base de datos. Las instancias del mismo tipo pueden tener los mismos nombres bajo el mismo tenant. El valor consta de 4 a 64 caracteres y comienza con una letra. Es insensible a mayúsculas y minúsculas y contiene solo letras, dígitos, guiones (-) y guiones bajos (_).
  status	String	Estado de instancia de base de datos. Este parámetro sólo se devuelve cuando se crean instancias de base de datos de pago por uso.
  datastore	Object	Información de la base de datos. Para obtener más información, consulte Tabla 10.
  mode	String	Tipo de instancia de base de datos. Actualmente, solo se admite el tipo de clúster.
  configuration_id	String	ID de plantilla de parámetro.
  port	String	Puerto de la base de datos, que es el mismo que el parámetro de solicitud.
  backup_strategy	Object	Política de copia de respaldo automatizada. Para obtener más información, consulte Tabla 11.
  enterprise_project_id	String	ID de proyecto de empresa, que es el mismo que el parámetro de solicitud.
  region	String	ID de región, que es el mismo que el parámetro de solicitud.
  availability_zone_mode	String	Tipo de zona de disponibilidad, que es el mismo que el parámetro de solicitud.
  master_ availability_zone	String	ID de zona de disponibilidad principal.
  vpc_id	String	ID de VPC, que es el mismo que el parámetro de solicitud.
  security_group_id	String	ID del grupo de seguridad, que es el mismo que el parámetro de solicitud.
  subnet_id	String	ID de subred, que es el mismo que el parámetro de solicitud.
  flavor_ref	String	Código de especificación, que es el mismo que el parámetro de solicitud. Para obtener más información, consulte Tabla 3.
  charge_info	Object	Modo de facturación, que es anual/mensual o de pago por uso. Para obtener más información, consulte Tabla 12.

  Tabla 10 descripción de la estructura de datos del campo del almacén de datos

  Nombre	Tipo	Descripción
  type	String	Motor de base de datos
  version	String	Versión de base de datos.

  Tabla 11 descripción de la estructura de datos del campo backup_strategy

  Nombre	Tipo	Descripción
  start_time	String	Ventana de tiempo de copia de respaldo. Las copias de respaldo automatizadas se activarán durante la ventana de tiempo de copia de respaldo.
  keep_days	Integer	Días de retención de copia de respaldo.

  Tabla 12 descripción de la estructura de datos del campo de charge_info

  Nombre	Tipo	Descripción
  charge_mode	String	Modo de facturación, que es anual/mensual o de pago por uso.
  period_num	Integer	Duración de la suscripción, que se calcula por mes. Este parámetro es válido cuando charge_mode se establece en prePaid (este parámetro es válido solo para instancias anuales/mensuales).

Los valores de region y master_availability_zone se usan como ejemplos.

• Ejemplo de respuesta 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 estado

Para obtener más información, consulte Códigos de estado.

Código de error.

Para obtener más información, consulte Códigos de error.