更新时间:2025-08-11 GMT+08:00

查询实例引擎版本分布

功能介绍

查询实例引擎版本分布。

URI

GET /v3/{project_id}/datastore/instances
表1 参数说明

名称

是否必选

参数类型

说明

project_id

String

参数解释:

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

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

约束限制:

不涉及。

取值范围:

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

默认取值

不涉及。

limit

Integer

数解释:

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

约束限制:

不能为负数。

取值范围:

[1, 100]

默认取值

100

offset

Integer

参数解释:

索引位置,偏移量。例如:该参数指定为1,limit指定为10,则只展示第2-11条数据。

约束限制:

必须为数字,不能为负数。

取值范围:

不涉及。

默认取值

默认为0(偏移0条数据,表示从第一条数据开始查询)。

请求参数

无。

响应参数

表2 要素说明

名称

参数类型

说明

engine_instance_details

Array of 表3 InstanceEngineDetail说明 objects

参数解释:

实例引擎详情。

total_count

integer

参数解释:

总记录数。

取值范围:

不涉及。

表3 InstanceEngineDetail说明

名称

参数类型

说明

engine_version

String

参数解释:

引擎版本号。

取值范围:

不涉及。

instances

Array of 表4 InstanceDetail说明 objects

参数解释:

实例详情。

表4 InstanceDetail说明

名称

参数类型

说明

instance_id

String

参数解释:

实例ID。

取值范围:

不涉及。

instance_name

String

参数解释:

实例名称。

取值范围:

不涉及。

status

String

参数解释:

实例状态。

取值范围:

不涉及。

type

String

参数解释:

实例类型。

取值范围:

不涉及。

solution

String

参数解释:

实例部署形态。

取值范围:

不涉及。

hotfix_versions

String

参数解释:

已升级热补丁版本。

取值范围:

不涉及。

请求示例

查询实例引擎版本分布。
GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/datastore/instances

响应示例

查询实例引擎版本分布成功。
{
    "engine_instance_details": [
        {
            "engine_version": "V2.0-3.220.0",
            "instances": [
                {
                    "status": "normal",
                    "type": "centralization_standard",
                    "solution": "single",
                    "instance_id": "0fd6cb8f0ffe4bba9e98af6f4b403ae8in14",
                    "instance_name": "gauss-472e",
                    "hotfix_versions": ""
                },
                {
                    "status": "normal",
                    "type": "centralization_standard",
                    "solution": "single",
                    "instance_id": "1b5022523d1749abbf2c7a1307cf4378in14",
                    "instance_name": "gauss-2ea0",
                    "hotfix_versions": "3.220.0.11"
                },
                {
                    "status": "normal",
                    "type": "centralization_standard",
                    "solution": "triset",
                    "instance_id": "da46dcee6c414a2eae89203804103981in14",
                    "instance_name": "gauss-515d",
                    "hotfix_versions": "3.220.0.11"
                }
            ]
        },
        {
            "engine_version": "V2.0-8.102.0",
            "instances": [
                {
                    "status": "normal",
                    "type": "distributed",
                    "solution": "hcs2",
                    "instance_id": "a731423300c14a8c866b2f96243ee9cbin14",
                    "instance_name": "gauss-c704",
                    "hotfix_versions": ""
                }
            ]
        }
    ],
    "total_count": 2
}

状态码

错误码

请参见错误码