You need to enable JavaScript to run this app.
文档中心
云数据库 MySQL 版

云数据库 MySQL 版

复制全文
下载 pdf
实例管理
DescribeDBInstanceSpecs - 查询支持的规格
复制全文
下载 pdf
DescribeDBInstanceSpecs - 查询支持的规格
调用 DescribeDBInstanceSpecs 接口查询 MySQL 支持的规格。​
请求类型​
同步请求。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
DBEngineVersion​
String​
否​
MySQL_8_0​
兼容版本。取值:​
  • MySQL_5_7:MySQL 5.7 版本。默认值。​
  • MySQL_8_0:MySQL 8.0 版本。​
  • MySQL 8.4:MySQL 8.4 版本。​
SpecCode​
String​
否​
rds.mysql.1c2g​
实例规格编码。​
ZoneId​
String​
否​
beijing-a​
可用区 ID。​
InstanceType​
String​
否​
DoubleNode​
实例类型。取值:​
  • DoubleNode,双节点类型。​
  • MultiNode,多节点类型。​
  • SingleNode,单节点类型。​
说明​
  • 如蓝色实例的实例类型为单节点,可为绿色实例选择单节点或双节点的实例类型。​
  • 如蓝色实例的实例类型为双节点,可为绿色实例选择双节点或多节点的实例类型。​
  • 如蓝色实例的实例类型为多节点,只能为绿色实例选择多节点的实例类型。​
SpecFamily​
String​
否​
General​
实例规格类型。取值:​
  • General,通用型规格。​
  • Shared:共享型规格。​
StorageType​
String​
否​
LocalSSD​
实例的存储类型。取值范围:​
  • LocalSSD:本地盘。​
  • CloudESSD_FlexPL:FlexPL 云盘。​
  • CloudESSD_PL0:PL0 云盘。​
说明​
  • 如需设定 StorageSpace 参数,StorageType 参数为必传。​
  • 当 InstanceType 取值为 SingleNode 时,StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。​
  • 在不同接口中,该参数取值范围不同。具体规则如下:​
  • 在以下接口中作为请求参数时,StorageType 的取值只能为 LocalSSD。​
  • RestoreToCrossRegionInstance​
  • RestoreToNewInstanceFromUserTos​
  • 在部分接口中作为请求参数时,该参数的取值范围与原实例的存储类型有关,具体规则如下:​
  • 原实例的存储类型为 LocalSSD 或 CloudESSD_FlexPL 时,不支持变更存储类型。​
  • 原实例的存储类型为 CloudESSD_PL0 时,可取值为 CloudESSD_PL0 或 CloudESSD_FlexPL。​
  • 涉及的接口是:​
  • RebuildDBInstance​
  • RestoreToNewInstance​
  • ModifyDBNodeSpec​
​
返回参数​
​
参数​
类型​
示例值​
描述​
InstanceSpecsInfo​
请参见返回示例。​
规格列表。​
​
InstanceSpecsInfoObject​
​
参数​
类型​
示例值​
描述​
Connection​
Integer​
2000​
最大链接数默认值。​
DBEngineVersion​
String​
MySQL_8_0​
兼容版本。取值:​
  • MySQL_5_7:MySQL 5.7 版本。​
  • MySQL_8_0:MySQL 8.0 版本。​
  • MySQL 8.4:MySQL 8.4 版本。​
IOPS​
Integer​
1000​
最大每秒 IO 数量。​
InstanceType​
String​
DoubleNode​
实例类型。取值为 DoubleNode。​
Memory​
Integer​
50​
内存大小,单位为 GiB。​
QPS​
Integer​
0​
每秒查询数量。​
SpecCode​
String​
rds.mysql.1c2g​
实例规格编码。​
RegionId​
String​
cn-beijing​
支持的地域 ID。​
SpecFamily​
String​
General​
实例规格类型。取值:​
  • General:独享规格(原“通用型”)。​
  • Shared:通用规格(原“共享型”)。​
SpecStatus​
String​
Normal​
规格所在可用区的状态,包含以下状态:​
  • Normal:在售。​
  • Soldout:售罄。​
StorageMax​
Integer​
3000​
磁盘最大规格,单位为 GiB。​
StorageMin​
Integer​
100​
磁盘最小规格,单位为 GiB。​
StorageStep​
Integer​
100​
磁盘步长,单位为 GiB。​
VCPU​
Integer​
1​
CPU 大小。例如:1 表示 1U。​
ZoneId​
String​
cn-beijing-a​
支持的可用区 ID。​
StorageType​
String​
LocalSSD​
实例的存储类型。取值范围:​
  • LocalSSD:本地盘。​
  • CloudESSD_FlexPL:FlexPL 云盘。​
  • CloudESSD_PL0:PL0 云盘。​
说明​
  • 如需设定 StorageSpace 参数,StorageType 参数为必传。​
  • 当 InstanceType 取值为 SingleNode 时,StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。​
  • 在不同接口中,该参数取值范围不同。具体规则如下:​
  • 在以下接口中作为请求参数时,StorageType 的取值只能为 LocalSSD。​
  • RestoreToCrossRegionInstance​
  • RestoreToNewInstanceFromUserTos​
  • 在部分接口中作为请求参数时,该参数的取值范围与原实例的存储类型有关,具体规则如下:​
  • 原实例的存储类型为 LocalSSD 或 CloudESSD_FlexPL 时,不支持变更存储类型。​
  • 原实例的存储类型为 CloudESSD_PL0 时,可取值为 CloudESSD_PL0 或 CloudESSD_FlexPL。​
  • 涉及的接口是:​
  • RebuildDBInstance​
  • RestoreToNewInstance​
  • ModifyDBNodeSpec​
​
示例​
请求示例​
​
POST /?Action=DescribeDBInstanceSpecs&Version=2022-01-01 HTTP/1.1​
Accept: application/json​
Content-Type: application/json​
Host: rds-mysql.cn-beijing.volcengineapi.com​
X-Date: 20211202T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"DBEngineVersion": "MySQL_8_0"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230810141234966A39B950F7BE686AC1",​
"Action": "DescribeDBInstanceSpecs",​
"Version": "2022-01-01",​
"Service": "rds_mysql",​
"Region": "cn-beijing"​
},​
"Result": {​
"InstanceSpecsInfo": [​
{​
"Connection": 600,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 1000,​
"InstanceType": "DoubleNode",​
"Memory": 2,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.1c2g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 20,​
"StorageStep": 100,​
"VCPU": 1,​
"ZoneId": ""​
},​
{​
"Connection": 1200,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 2000,​
"InstanceType": "DoubleNode",​
"Memory": 4,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.2c4g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 20,​
"StorageStep": 100,​
"VCPU": 2,​
"ZoneId": ""​
},​
{​
"Connection": 2000,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 4000,​
"InstanceType": "DoubleNode",​
"Memory": 8,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.2c8g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 20,​
"StorageStep": 100,​
"VCPU": 2,​
"ZoneId": ""​
},​
{​
"Connection": 4000,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 6000,​
"InstanceType": "DoubleNode",​
"Memory": 16,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.2c16g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 20,​
"StorageStep": 100,​
"VCPU": 2,​
"ZoneId": ""​
},​
{​
"Connection": 2000,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 5000,​
"InstanceType": "DoubleNode",​
"Memory": 8,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.4c8g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 20,​
"StorageStep": 100,​
"VCPU": 4,​
"ZoneId": ""​
},​
{​
"Connection": 180000,​
"DBEngineVersion": "MySQL_8_0",​
"IOPS": 160000,​
"InstanceType": "DoubleNode",​
"Memory": 864,​
"QPS": 0,​
"RegionId": "cn-beijing",​
"SpecCode": "rds.mysql.108c864g",​
"SpecFamily": "General",​
"SpecStatus": "Normal",​
"StorageMax": 6000,​
"StorageMin": 900,​
"StorageStep": 100,​
"VCPU": 108,​
"ZoneId": ""​
}​
]​
}​
}​
​
错误码​
更多详情,请参见错误码。​
​
最近更新时间:2026.05.28 11:52:20
这个页面对您有帮助吗?
有用
有用
无用
无用