Consulta de recursos del motor de HTAP
Función
Esta API se utiliza para consultar los recursos del motor 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/datastores/{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á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 |
|---|---|---|
|
datastores |
Array of datastores objects |
Lista de información de la base de datos. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
ID de versión de BD. El valor es único. |
|
name |
String |
Número de versión de la base de datos. Solo se devuelve el número de versión principal con dos dígitos. |
|
kernel_version |
String |
Versión del kernel de BD. Se devuelve una versión completa de cuatro números. |
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 información de versión de BD de StarRocks
GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/htap/datastores/star-rock
Ejemplo de la respuesta
Código de estado: 200
Operación exitosa.
{
"datastores" : [ {
"id" : "38197973-8895-36ed-b853-52daeefb6d3a",
"name" : "3.1",
"kernel_version" : "3.1.6.0"
} ]
}
Código de estado: 400
Error de cliente.
{
"error_msg" : "Invalid database type.",
"error_code" : "DBS.280235"
}
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.