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 versión del motor de BD/ Consulta de información de versión acerca de un motor de base de datos

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

Ver PDF

Consulta de información de versión acerca de un motor de base de datos

Función

Esta API se utiliza para consultar la información de versión de un motor de base de datos especificado. 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}/datastores/{database_name}

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto de un tenant en un region. Para obtener este valor, vea Obtención de un ID de proyecto.
database_name	Sí	String	Motor de base de datos. Su valor es insensible a mayúsculas y minúsculas y puede ser: gaussdb-mysql.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado 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.
X-Language	No	String	Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores: en-us zh-cn

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetro del cuerpo de respuesta
Parámetro	Tipo	Descripción
datastores	Array of MysqlEngineVersionInfo objects	Versiones de base de datos.

**Tabla 4** MysqlEngineVersionInfo
Parámetro	Tipo	Descripción
id	String	ID de versión de la base de datos. Su 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.
version	String	Versión de BD de código abierto compatible. Se devuelve una versión de código abierto de tres números.
kernel_version	String	Versión del kernel de BD. Se devuelve una versión completa de cuatro números.

Código de estado: 400

**Tabla 5** 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 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.

Solicitud de ejemplo

Consulta de información de versión de una instancia de TaurusDB

GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/datastores/gaussdb-mysql

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "datastores" : [ {
    "id" : "87620726-6802-46c0-9028-a8785e1f1921",
    "name" : "8.0",
    "version" : "8.0.22",
    "kernel_version" : "2.0.28.18"
  } ]
}