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.
- Obtener los región y punto de conexión requeridos.
URI
GET /v3/{project_id}/flavors/{database_name}
Parámetro |
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. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
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. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Token de usuario. |
X-Language |
No |
String |
Idioma. |
Parámetros de respuesta
Código de estado: 202
Parámetro |
Tipo |
Descripción |
---|---|---|
flavors |
Array of MysqlFlavorsInfo objects |
Especificaciones de instancia. |
Parámetro |
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 o x86. |
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. Por ejemplo: gaussdb.mysql.xlarge.x86.4. |
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 al que pertenecen las especificaciones de instancia de base de datos. Su valor puede ser cualquiera de los siguientes:
|
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Solicitud de ejemplo
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
Success.
{ "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" } } ] }
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.