更新时间：2024-04-12 GMT+08:00
查询数据库规格
调试
您可以在API Explorer中调试该接口。
URI
GET https://{Endpoint}/v3.1/{project_id}/flavors?limit={limit}&offset={offset}&ha_mode={ha_mode}&version={version}&spec_code={spec_code}
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
project_id |
是 |
String |
租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 |
version |
否 |
String |
数据库版本号。查询指定版本支持的规格。例如1.4。 |
spec_code |
否 |
String |
规格编码，查询指定规格编码的具体规格信息。 |
ha_mode |
否 |
String |
实例类型，查询指定实例类型支持的规格。
|
limit |
否 |
Integer |
查询记录数。默认为100，不能为负数，最小值为1，最大值为100。例如该参数设定为10，则查询结果最多只显示10条记录。 |
offset |
否 |
Integer |
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。例如：该参数指定为1，limit指定为10，则只展示第2~11条数据。 |
请求参数
无。
响应参数
名称 |
参数类型 |
说明 |
|---|---|---|
flavors |
Array of objects |
规格详情。 详情请参见表3。 |
total |
Integer |
总记录数。 |
名称 |
参数类型 |
说明 |
|---|---|---|
vcpus |
String |
CPU个数。 |
ram |
String |
内存大小，单位为GB。 |
spec_code |
String |
资源规格编码。 |
availability_zone |
Array of strings |
支持该规格的AZ。 |
az_status |
Map<String,String> |
其中key是可用区编号，value是规格所在AZ的状态，包含以下状态：
|
version |
String |
该规格支持的数据库版本号。 |
name |
String |
数据库引擎名称。 |
group_type |
String |
性能规格，包含以下状态：
|
请求示例
- 查询主备版数据库规格
GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=centralization_standard&version=3.208&spec_code=gaussdb.opengauss.ee.km1.2xlarge.arm8.ha
- 查询分布式数据库规格
GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/flavors?offset=0&limit=10&ha_mode=enterprise&version=3.208&spec_code=gaussdb.opengauss.ee.dn.m6.2xlarge.8.in
响应示例
查询数据库规格成功。
{
"flavors": [
{
"vcpus": "2",
"ram": "16",
"availability_zone": [
"az2xahz",
"az1xahz",
"az3xahz"
],
"version": "1.4",
"name": "GaussDB",
"spec_code": "gaussdb.opengauss.ee.dn.m6.large.8.in",
"az_status": {
"az2xahz": "normal",
"az1xahz": "normal",
"az3xahz": "normal"
},
"group_type": "normal2"
}
],
"total": 1
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题： 引擎版本和规格
