文档首页/ 云数据库 GaussDB(for MySQL)/ API参考/ API（推荐）/ 查询数据库引擎的版本/ 查询数据库引擎的版本
更新时间：2023-10-23 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询数据库引擎的版本

功能介绍

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

URI

GET /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

数据库版本号，只返回两位数的大版本号。

version

String

兼容的开源数据库版本号，返回三位开源版本号。

kernel_version

String

数据库版本号，返回完整的四位版本号。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

查询GaussDB(for MySQL)数据库的版本信息。

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

响应示例

状态码： 200

Success.

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

状态码

请参见状态码。

错误码

请参见错误码。