文档首页/ 云数据库 TaurusDB/ API参考/ API（即将下线）/ 查询数据库引擎的版本/ 查询数据库引擎的版本
更新时间：2024-12-16 GMT+08:00
查看PDF
分享

查询数据库引擎的版本

功能介绍

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

该接口计划于2025-03-31下线，建议及时切换到新接口查询数据库引擎的版本。

调试

您可以在API Explorer中调试该接口。

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"     
  } ]
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

相关文档