文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 引擎版本和规格/ 查询数据库引擎的版本
更新时间：2025-10-20 GMT+08:00
查看PDF
分享

查询数据库引擎的版本

功能介绍

查询当前支持的引擎版本。

调试

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

URI

GET /v3.2/{project_id}/datastore/versions

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

limit

否

参数解释：

查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。

约束限制：

不涉及。

取值范围：

[1, 100]

默认取值：

100

offset

否

参数解释：

索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。例如：该参数指定为1，limit指定为10，则只展示第2-11条数据。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]

默认取值：

默认为0（偏移0条数据，表示从第一条数据开始查询）。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言。

约束限制：

不涉及。

取值范围：

  • zh-cn
  • en-us

默认取值：

en-us。

响应参数

表3 响应参数说明

名称

参数类型

说明

database_versions

Array of Object

参数解释：

数据库版本列表。

详见表4。

total

Integer

参数解释：

数据库引擎版本总个数。

取值范围：

不涉及。
表4 数据库版本列表属性

名称

参数类型

说明

software_version

String

参数解释：

数据库三位引擎版本。

取值范围：

不涉及。

hotfixes

Array of Object

参数解释：

数据库三位引擎版本对应的热补丁信息。

详见表5。
表5 热补丁信息

名称

参数类型

说明

version

String

参数解释：

热补丁版本。

取值范围：

不涉及。

create_time

Long

参数解释：

热补丁的创建时间，UNIX时间戳格式，单位是毫秒。

取值范围：

不涉及。

deploy_modes

Array of Object

参数解释：

可升级热补丁的实例部署形态信息。

详见表6。
表6 热补丁的实例部署形态信息

名称

参数类型

说明

default_upgrade

String

参数解释：

补丁默认升级策略。

取值范围：

  • true：无需选择，默认升级该版本。
  • false：用户可选，选择后升级该版本。

update_time

Long

参数解释：

热补丁升级策略的修改时间，UNIX时间戳格式，单位是毫秒。

取值范围：

不涉及。

mode

String

参数解释：

可升级该补丁的实例部署形态。

取值范围：

  • distributed：包括独立部署，基础版混合部署。
  • centralization_standard：包括集中式版。

请求示例

查询数据库引擎的版本。

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3.2/0483b6b16e954cb88930a360d2c4e663/datastore/versions?offset=0&limit=10

响应示例

查询数据库引擎的版本成功。

{
    "database_versions":
    [
        {
            "software_version": "V2.0-8.210",
            "hotfixes":
            [
                {
                    "version": "V2.0-8.210.0.1",
                    "create_time": "1755475200",
                    "deploy_modes":
                    [
                        {
                            "default_upgrade": true,
                            "update_time": "1755475200",
                            "mode": "centralization_standard"
                        }
                    ]
                }
            ]
        }
    ],
    "total": 1
}

状态码

错误码

请参见错误码。

父主题： 引擎版本和规格