查询数据库引擎的版本

功能介绍

获取指定数据库引擎对应的数据库版本信息。

当前页面API为历史版本API，未来可能停止维护。建议及时切换到新接口查询数据库引擎的版本。

调用方法

请参见如何调用API。

URI

GET /mysql/v3/{project_id}/datastores/{database_name}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户在某一Region下的project ID。获取方法请参见获取项目ID。
database_name	是	String	数据库引擎。支持的引擎如下，不区分大小写：gaussdb-mysql

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。
X-Language	否	String	请求语言类型。默认en-us。取值范围： en-us zh-cn

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
datastores	Array of MysqlEngineVersionInfo objects	数据库版本信息列表。

表4 MysqlEngineVersionInfo
参数	参数类型	描述
id	String	数据库版本ID，该字段不会有重复。
name	String	数据库版本号，只返回两位数的大版本号。
kernel_version	String	数据库内核版本号，返回完整的四位版本号。
version	String	兼容的开源数据库版本号，返回三位开源版本号。

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息。

状态码： 500

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息。

请求示例

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

响应示例

状态码： 200

Success.

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