Consulta de especificaciones de una instancia de HTAP
Función
Esta API se utiliza para consultar las especificaciones de una instancia de HTAP. 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}/htap/flavors/{engine_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. |
|
engine_name |
Sí |
String |
Nombre del motor de HTAP. Valores:
|
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
availability_zone_mode |
No |
String |
Modo de la AZ. Actualmente, solo se admite una sola AZ. |
|
spec_code |
No |
String |
Código de especificación. Si se especifica este parámetro, solo se consulta el código de especificación especificado. |
|
version_name |
No |
String |
Número de versión de la base de datos. Si este parámetro se deja en blanco, se utiliza el valor predeterminado 3.1.6.0. |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
X-Auth-Token |
Sí |
String |
Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. |
|
Content-Type |
Sí |
String |
Tipo de contenido. Valor: application/json |
|
X-Language |
No |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetros de respuesta
Código de estado: 200
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
flavors |
Array of flavors objects |
Información de especificación. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
type |
String |
Tipo de especificación. El valor puede ser arm, x86 o generalX86.
|
|
vcpus |
String |
Cantidad de vCPUs. Por ejemplo, el valor 1 indica 1 vCPU. |
|
ram |
String |
Tamaño de la memoria en GB. |
|
id |
String |
ID de especificación. El valor es único. |
|
spec_code |
String |
Código de especificación de recursos. Su valor es el mismo que el valor de flavor_ref. Ejemplo: gaussdb.sr-be.xlarge.x86.4
|
|
version_name |
String |
Número de versión de la base de datos. |
|
instance_mode |
String |
Tipo de instancia. El valor puede ser Cluster o Simple. |
|
az_status |
Map<String,String> |
Estado de la especificación en la AZ. El 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. |
Ejemplo de la solicitud
Consulta de especificaciones de StarRocks
GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/htap/flavors/star-rocks?availability_zone_mode=single
Ejemplo de la respuesta
Código de estado: 200
Operación exitosa.
{
"flavors" : [ {
"type" : "x86",
"vcpus" : "4",
"ram" : "16",
"id" : "de565db8-0a96-37ea-9388-61167624712c",
"spec_code" : "gaussdb.sr-be.xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "4",
"ram" : "16",
"id" : "afef3bfd-ac7c-32e1-ba44-c388acbb196a",
"spec_code" : "gaussdb.sr-fe.xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "8",
"ram" : "32",
"id" : "c50e8e15-f2fc-3b40-aca6-c98f07ce2ce0",
"spec_code" : "gaussdb.sr-be.2xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "8",
"ram" : "32",
"id" : "24059750-4280-3ee5-a44b-488b924633b4",
"spec_code" : "gaussdb.sr-fe.2xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "16",
"ram" : "64",
"id" : "a48c63dc-5563-3813-9e13-39d3301e56f4",
"spec_code" : "gaussdb.sr-be.4xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "16",
"ram" : "64",
"id" : "0ef44c01-f7a1-30f5-9f05-9e47094e8c1f",
"spec_code" : "gaussdb.sr-fe.4xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "32",
"ram" : "128",
"id" : "2bf6aa50-50da-3f27-91af-a8c873070537",
"spec_code" : "gaussdb.sr-fe.8xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "normal"
}
}, {
"type" : "x86",
"vcpus" : "32",
"ram" : "128",
"id" : "9f52a065-aa93-371a-9975-959fedf6e24f",
"spec_code" : "gaussdb.sr-be.8xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "normal"
}
}, {
"type" : "x86",
"vcpus" : "64",
"ram" : "256",
"id" : "709822e4-567f-3e85-b4af-cb099206c8e2",
"spec_code" : "gaussdb.sr-fe.16xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
}, {
"type" : "x86",
"vcpus" : "64",
"ram" : "256",
"id" : "4e56e208-0226-34bb-b84d-035ab0497824",
"spec_code" : "gaussdb.sr-be.16xlarge.x86.4",
"version_name" : "8.0",
"instance_mode" : "Cluster",
"az_status" : {
"az1" : "normal",
"az2" : "normal",
"az3" : "normal",
"az4" : "unsupported"
}
} ]
}
Código de estado: 400
Error de cliente.
{
"error_msg" : "Invalid specification code.",
"error_code" : "DBS.280434"
}
Código de estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.
