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 una API, debe entender la API de Autenticación.

URI

• Formato de URI

  GET /v3/{project_id}/flavors/{database_name}?version_name={version_name}&spec_code={spec_code}

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Descripción
  project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  database_name	Sí	Especifica el nombre del motor de base de datos. Su valor puede ser cualquiera de los siguientes y no distingue entre mayúsculas y minúsculas: MySQL PostgreSQL SQLServer
  version_name	No	Especifica la versión de la base de datos. Para obtener más información sobre cómo obtener la versión de la base de datos, consulte la sección Consulta de información de versión acerca de un motor de base de datos. (La versión menor es compatible.)
  spec_code	No	Especifica el código de especificación.

Solicitud

• Parámetros de solicitud

  Ninguna

• Ejemplo de URI

  GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/flavors/mysql?version_name=5.7&spec_code=rds.mysql.m1.xlarge.rr

Respuesta

• Respuesta normal

  Tabla 2 Descripción de parámetro

  Nombre	Tipo	Descripción
  flavors	Array of objects	Indica la lista de información 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 variantes

  Nombre	Tipo	Descripción
  vcpus	String	Indica el tamaño de la CPU. Por ejemplo, el valor 1 indica 1 vCPU.
  ram	Integer	Indica el tamaño de la memoria en GB.
  id	String	Indica el ID de especificación, que es único.
  spec_code	String	Indica el código de especificación de recurso. Utilice rds.mysql.m1.xlarge.rr como ejemplo. Para obtener más información, consulte Clase de instancia. rds: indica el producto RDS. mysql: indica el motor DB. m1.xlarge: indica las especificaciones de alto rendimiento de la memoria. rr: indica réplicas de lectura (.ha indica instancias de base de datos primarias/en espera). rha.rr indica réplicas de lectura de HA. Ejemplo de código de especificación: rds.mysql.n1.large.4.rha.rr. Las réplicas de lectura de HA solo están disponibles para usuarios con el permiso de open beta test (OBT). Puede ponerse en contacto con el servicio de atención al cliente para solicitar el permiso. Para obtener más información sobre las réplicas de lectura de HA, consulte Introducción a las réplicas de lectura de HA.
  version_name	Array	Indica la versión de la base de datos. Ejemplo de valor para el motor de base de datos de MySQL: ["5.6"",5.7"",8.0"]
  instance_mode	String	Indica el tipo de instancia de base de datos. Su valor puede ser cualquiera de los siguientes: ha: indica instancias primarias/en espera. replica: indica réplicas de lectura. single: indica instancias de base de datos únicas.
  az_status	Map<String, String>	Indica el estado de la especificación en una zona de disponibilidad. Su valor puede ser cualquiera de los siguientes: normal: indica que las especificaciones en la zona de disponibilidad están disponibles. unsupported: indica que las especificaciones no son compatibles con la zona de disponibilidad. sellout: indica que las especificaciones en la zona de disponibilidad están agotadas.
  az_desc	Map<String, String>	Indica la descripción de la zona de disponibilidad al que pertenecen las especificaciones.
  group_type	String	Indica las especificaciones de rendimiento. Su valor puede ser cualquiera de los siguientes: normal: general-mejorado normal2: general-mejorado II armFlavors: Kunpeng general-mejorado dedicicateNormal (dedicatedNormalLocalssd): exclusivo x86 armLocalssd: standard Kunpeng normalLocalssd: standard x86 general: de uso general dedicated: Para el motor de base de datos de MySQL: dedicado Para motores de base de datos de PostgreSQL y SQL Server: dedicado, que solo es compatible con SSD en la nube rapid: Para el motor de base de datos MySQL: dedicado (fuera de línea) Para motores de base de datos PostgreSQL y SQL Server: dedicado, que solo es compatible con SSD extremos bigmem: memoria de gran capacidad highPerformancePrivilegeEdition: E/S ultraalta (avanzado)

• Ejemplo de respuesta normal

  {
  	"flavors": [{
  			"vcpus": "1",
  			"ram": 2,
                          "id":"2988b9cc-2aac-3a94-898c-14666702f129",
  			"spec_code": "rds.mysql.c2.medium.rrrds.pg.c2.medium.rr",
                          "version_name": ["5.6","5.7","8.0"],
  			"instance_mode": "ha",
  			"az_status": {
  				"az1": "normal",
  				"az2": "normal"
  			},
  			"az_desc": {
  				"az1": "az1",
  				"az2": "az2"
  			},
                          "group_type": "normal"
  		},
  		{
  			"vcpus": "1",
  			"ram": 2,
                          "id":"2988b9cc-2aac-3a94-898c-14666702f130",
  			"spec_code": "rds.mysql.c2.medium.rrrds.pg.c2.medium.rr",
                          "version_name": ["5.6","5.7","8.0"],
  			"instance_mode": "replica",
  			"az_status": {
  				"az1": "normal",
  				"az2": "normal"
  			},
  			"az_desc": {
  				"az1": "az1",
  				"az2": "az2"
  			},
                          "group_type": "normal"
  		}
  	]
  }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  200

• Anormal

  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.