Consulta de especificaciones de base de datos

Función

Esta API se utiliza para consultar las especificaciones de la base de datos de una versión especificada del motor de base de datos. 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 (Consulta de especificaciones de base de datos) antes de esa fecha.

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

URI

• Formato de URI

  GET https://{endpoint}/mysql/v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}&availability_zone_mode={availability_zone_mode}

• Ejemplo

  GET https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/flavors/gaussdb-mysql?version_name=8.0&spec_code=gaussdb.mysql.xlarge.x86.4&availability_zone_mode=single

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Tipo	Descripción
  project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.
  database_name	Sí	String	Motor de base de datos. Su valor es insensible a mayúsculas y minúsculas y puede ser: gaussdb-mysql
  version_name	No	String	Número de versión de la base de datos. Para obtener este valor, consulte Consulta de información de versión acerca de un motor de base de datos. Actualmente, solo se soporta MySQL 8.0.
  availability_zone_mode	Sí	String	Modo de zona de disponibilidad. Su valor puede ser single y multi y no distingue entre mayúsculas y minúsculas.
  spec_code	No	String	Código de especificación.

Solicitud

Ninguna.

Respuesta

• Respuesta normal

  Tabla 2 Descripción de parámetro

  Nombre	Tipo	Descripción
  flavors	Array of objects	Lista de especificaciones de instancia de base de datos. Para obtener más información, consulte Tabla 3.

  Tabla 3 descripción de la estructura de datos de campo de variante

  Nombre	Tipo	Descripción
  vcpus	String	Número de vCPUs. Por ejemplo, el valor 1 indica 1 vCPU.
  ram	String	Tamaño de la memoria en GB.
  type	String	Tipo de especificación. El valor puede ser arm.
  id	String	ID de especificación. El valor debe ser único.
  spec_code	String	Código de especificación de recurso. Su valor es el mismo que el valor de flavor_ref.
  version_name	String	Número de versión de la base de datos.
  instance_mode	String	Tipo de instancia de base de datos. Actualmente, solo se admite el tipo de clúster.
  az_status	Map<String, String>	Estado de la zona de disponibilidad a la que pertenece la especificación. Su valor puede ser cualquiera de los siguientes: normal: a la venta. unsupported: no soportado sellout: agotado

• Ejemplo de respuesta normal

  {
      "flavors":[
          {
              "vcpus":"1",
              "ram":"4",
              "type":"x86",           
              "id":"3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
              "spec_code":"gaussdb.xlarge.x86.4",
              "instance_mode":"Cluster",
              "version_name": "8.0",
              "az_status":{
                  "az1":"normal",
                  "az2":"normal"
              }
          },
          {
              "vcpus":"2",
              "ram":"4",
              "type":"arm"
              "id":"cefb8fab-c9f7-482f-a97c-e8a0c8abe35b",
              "spec_code":"gaussdb.mysql.xlarge.x86.2",
              "instance_mode":"Cluster",
              "version_name": "8.0",
              "az_status":{
                  "az1":"normal",
                  "az2":"normal"
              }
          }
      ]
  }

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.