Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Consultas de especificación de base de datos/ Consulta de especificaciones de base de datos

Actualización más reciente 2025-03-21 GMT+08:00

Ver PDF

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:

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

URI

GET /v3/{project_id}/flavors/{database_name}

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Explicación: ID de proyecto de un tenant en una región. Para obtener este valor, vea Obtención de un ID de proyecto. Restricciones: Ninguna Rango de valor: El valor puede contener 32 caracteres. Solo se permiten letras y dígitos. Valor predeterminado: Ninguno
database_name	Sí	String	Explicación: Nombre del motor de base de datos. Restricciones: Ninguna Rango de valor: gaussdb-mysql Valor predeterminado: Ninguno

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
availability_zone_mode	Sí	String	Explicación: Tipo de zona de disponibilidad. Restricciones: Ninguna Rango de valor: single: zona de disponibilidad única multi: zonas de disponibilidad múltiples Valor predeterminado: single
version_name	No	String	Explicación: Número de versión de la base de datos. Restricciones: Actualmente, solo se soporta MySQL 8.0. Rango de valor: 8.0 Valor predeterminado: 8.0
spec_code	No	String	Explicación: Código de especificación de recurso. Ejemplo: gaussdb.mysql.xlarge.x86.4 gaussdb.mysql indica el producto. xlarge indica las especificaciones (4 vCPU). x86 indica la arquitectura x86. 4 indica que la relación entre vCPU y memoria es 1:4. Para obtener más información, consulte Especificaciones de instancia. Restricciones: Ninguna Rango de valor: Ninguno Valor predeterminado: Ninguno

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Explicación: Token de usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. Restricciones: Ninguna Rango de valor: Ninguna Valor predeterminado: Ninguna
X-Language	No	String	Explicación: Tipo de idioma de solicitud. Restricciones: Ninguna Rango de valor: en-us zh-cn Valor predeterminado: en-us

Parámetros de respuesta

Código de estado: 202

**Tabla 4** Parámetro del cuerpo de respuesta
Parámetro	Tipo	Descripción
flavors	Array of MysqlFlavorsInfo objects	Explicación: Especificaciones de instancia.

**Tabla 5** MysqlFlavorsInfo
Parámetro	Tipo	Descripción
vcpus	String	Explicación: Número de vCPUs. Por ejemplo, el valor 1 indica 1 vCPU. Rango de valor: Ninguno
ram	String	Explicación: Tamaño de la memoria en GB. Rango de valor: Ninguno
type	String	Explicación: Arquitectura de CPU. Rango de valor: arm: Arm exclusivo x86: x86 exclusivo generalX86: x86 de uso general
id	String	Explicación: ID de especificación, que identifica de forma única una especificación. Rango de valor: Ninguno
spec_code	String	Explicación: Código de especificación de recurso. Su valor es el mismo que el valor de spec_code. Ejemplo: gaussdb.mysql.xlarge.x86.4 gaussdb.mysql indica el producto. xlarge indica las especificaciones (4 vCPU). x86 indica la arquitectura x86. 4 indica que la relación entre vCPU y memoria es 1:4. Para obtener más información, consulte Especificaciones de instancia. Rango de valor: Ninguno
version_name	String	Explicación: Número de versión de la base de datos. Rango de valor: 8.0
instance_mode	String	Explicación: Tipo de instancia. Actualmente, solo se admite el tipo de clúster. Rango de valor: Cluster
az_status	Map<String,String>	Explicación: Estado de la especificación en la zona de disponibilidad. Rango de valor: normal: La especificación está disponible en la zona de disponibilidad. unsupported: La especificación no es compatible. sellout: La especificación está agotada.

Código de estado: 400

**Tabla 6** Parámetros de cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 500

**Tabla 7** Parámetros de cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Solicitud de ejemplo

Consulta de especificaciones específicas de una instancia de TaurusDB

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

Ejemplo de respuesta

Código de estado: 202

Operación exitosa.

{
  "flavors" : [ {
    "vcpus" : "4",
    "ram" : "16",
    "type" : "x86",
    "id" : "3169caaf-6c2f-41d5-aadd-c8fc3d83597e",
    "spec_code" : "gaussdb.mysql.xlarge.x86.4",
    "instance_mode" : "Cluster",
    "version_name" : "8.0",
    "az_status" : {
      "az1" : "normal",
      "az2" : "normal"
    }
  } ]
}