调用DescribeDBMiniEngineVersions查询可用的MySQL和PostgreSQL小版本列表。
该接口用于新购、升级RDS MySQL、PostgreSQL实例前了解实例小版本详情,方便按需选择。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDBMiniEngineVersions |
系统规定参数。取值:DescribeDBMiniEngineVersions。 |
Engine | String | 否 | MySQL |
数据库引擎。取值为MySQL或PostgreSQL。 |
EngineVersion | String | 否 | 5.7 |
数据库版本。取值:
|
NodeType | String | 否 | HighAvailability |
实例系列。取值:
|
StorageType | String | 否 | local_ssd |
实例存储类型,取值:
|
DedicatedHostGroupId | String | 否 | dhg-4n***** |
专属集群ID。可调用DescribeDedicatedHostGroups接口查询。 |
MinorVersionTag | String | 否 | rds_20220731 |
实例小版本号。指定该值查询目标小版本详情。 |
DBInstanceId | String | 否 | rm-uf6wjk5******* |
实例ID。可调用DescribeDBInstances获取。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。可调用DescribeRegions获取。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBInstanceId | String | rm-uf6wjk5***** |
实例ID。 |
RequestId | String | EFB6083A-7699-489B-8278-C0CB4793A96E |
请求ID。 |
TotalCount | Integer | 2 |
总记录数。 |
PageNumbers | Integer | 1 |
当前页码。 |
MaxRecordsPerPage | Integer | 10 |
每页记录数。 |
MinorVersionItems | Array of MinorVersionItems |
小版本列表。 |
|
ReleaseNote | String | https://example.com |
小版本发布说明的URL。 |
NodeType | String | HighAvailability |
小版本对应的实例系列。返回值:
|
IsHotfixVersion | Boolean | True |
内部参数,无需关注。 |
Engine | String | MySQL |
小版本对应的数据库引擎。 |
ReleaseType | String | BETA |
发布类型。返回值:
|
StatusDesc | String | Online |
小版本的当前状态。 |
EngineVersion | String | 5.7 |
小版本对应的数据库版本。 |
MinorVersion | String | rds_20220731 |
小版本的版本号。 |
CommunityMinorVersion | String | 13.6 |
内核小版本对应的社区小版本,您可在AliPG内核小版本发布记录中查看更多详情。 说明 该参数当前仅适用于PostgreSQL。
|
Tag | String | pgsql_babelfish_image |
内核小版本对应的标签。返回值如下:
说明 当前仅PostgreSQL返回该值。
|
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeDBMiniEngineVersions
&Engine=MySQL
&EngineVersion=5.7
&NodeType=HighAvailability
&StorageType=local_ssd
&DedicatedHostGroupId=dhg-4n*****
&MinorVersionTag=key1
&DBInstanceId=rm-uf6wjk5*******
&RegionId=cn-hangzhou
&callerBid=268**
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDBMiniEngineVersionsResponse>
<DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
<RequestId>EFB6083A-7699-489B-8278-C0CB4793A96E</RequestId>
<TotalCount>2</TotalCount>
<PageNumbers>1</PageNumbers>
<MaxRecordsPerPage>10</MaxRecordsPerPage>
<MinorVersionItems>
<ReleaseNote>https://example.com</ReleaseNote>
<NodeType>HighAvailability</NodeType>
<IsHotfixVersion>true</IsHotfixVersion>
<Engine>MySQL</Engine>
<ReleaseType>BETA</ReleaseType>
<StatusDesc>Online</StatusDesc>
<EngineVersion>5.7</EngineVersion>
<MinorVersion>rds_20220731</MinorVersion>
</MinorVersionItems>
</DescribeDBMiniEngineVersionsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DBInstanceId" : "rm-uf6wjk5*****",
"RequestId" : "EFB6083A-7699-489B-8278-C0CB4793A96E",
"TotalCount" : 2,
"PageNumbers" : 1,
"MaxRecordsPerPage" : 10,
"MinorVersionItems" : [ {
"ReleaseNote" : "https://example.com",
"NodeType" : "HighAvailability",
"IsHotfixVersion" : true,
"Engine" : "MySQL",
"ReleaseType" : "BETA",
"StatusDesc" : "Online",
"EngineVersion" : "5.7",
"MinorVersion" : "rds_20220731"
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MinorVersionAttr.NotFound | Cannot find minor version attribute by given custins. | 无小版本信息。 |
400 | InvalidDBInstanceName.NotFound | The specified DB instance name does not exist. | 数据库实例名称不存在,请检查。 |
400 | EngineNotSupported | Engine specified cannot be supported the operation. | 操作失败,当前引擎不支持此操作,请升级内核小版本。 |
400 | MissingMinorVersionTag | You must specify MinorVersionTag. | MinorVersionTag参数缺失,请重新配置。 |
400 | MissingParameter.Engine | You must specify Engine. | 数据库类型参数(Engine)未设置,请重新配置。 |
400 | MissingParameter.EngineVersion | You must specify EngineVersion. | 数据库版本参数(EngineVersion)未设置,请重新配置。 |
400 | InvalidInstanceNodeType.NotFound | The specified NodeType is not found. | NodeType参数缺失,请重新配置。 |
400 | MinorVersionTag.NotFound | Minor version tags cannot be parsed by the instance. | 操作失败,根据实例无法解析小版本标签。 |
404 | InvalidInstanceStorageType.NotFound | The specified DBInstanceStorageType is not found. | 实例存储类型参数(InstanceStorageType)未配置,请重新配置。 |
404 | InvalidDBInstance.NotFound | The specified instance does not exist or is not supported. | 没有找到指定的实例,请检查实例的正确性。 |
访问错误中心查看更多错误码。