更新时间：2025-10-20 GMT+08:00
查询实例引擎版本分布
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/datastore/instances
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
|
limit |
否 |
Integer |
数解释： 查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。 约束限制： 不能为负数。 取值范围： [1, 100] 默认取值： 100 |
|
offset |
否 |
Integer |
参数解释： 索引位置，偏移量。例如：该参数指定为1，limit指定为10，则只展示第2-11条数据。 约束限制： 必须为数字，不能为负数。 取值范围： 不涉及。 默认取值： 默认为0（偏移0条数据，表示从第一条数据开始查询）。 |
请求参数
无。
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
engine_instance_details |
Array of 表3 InstanceEngineDetail说明 objects |
参数解释： 实例引擎详情。 |
|
total_count |
integer |
参数解释： 总记录数。 取值范围： 不涉及。 |
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
engine_version |
String |
参数解释： 引擎版本号。 取值范围： 不涉及。 |
|
instances |
Array of 表4 InstanceDetail说明 objects |
参数解释： 实例详情。 |
请求示例
查询实例引擎版本分布。
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
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题： 引擎版本和规格
