调用DescribeDBMiniEngineVersions查询可用的MySQL和PostgreSQL小版本列表。

该接口用于新购、升级RDS MySQL、PostgreSQL实例前了解实例小版本详情,方便按需选择。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDBMiniEngineVersions

系统规定参数。取值:DescribeDBMiniEngineVersions

Engine String MySQL

数据库引擎。取值为MySQLPostgreSQL

EngineVersion String 5.7

数据库版本。取值:

  • MySQL:8.05.75.65.5
  • PostgreSQL:15.014.013.012.011.010.0
NodeType String HighAvailability

实例系列。取值:

  • Basic:基础版。
  • HighAvailability:高可用版。
  • Finance:三节点企业版。
StorageType String local_ssd

实例存储类型,取值:

  • local_ssd:本地SSD盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD PL1云盘。
  • cloud_essd2:ESSD PL2云盘。
  • cloud_essd3:ESSD PL3云盘。
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

小版本对应的实例系列。返回值:

  • Basic:基础版。
  • HighAvailability:高可用版。
  • Finance:三节点企业版。
IsHotfixVersion Boolean True

内部参数,无需关注。

Engine String MySQL

小版本对应的数据库引擎。

ReleaseType String BETA

发布类型。返回值:

  • LTS:长期支持版本。
  • BETA:预览版本。
StatusDesc String Online

小版本的当前状态。

EngineVersion String 5.7

小版本对应的数据库版本。

MinorVersion String rds_20220731

小版本的版本号。

CommunityMinorVersion String 13.6

内核小版本对应的社区小版本,您可在AliPG内核小版本发布记录中查看更多详情。

说明 该参数当前仅适用于PostgreSQL
Tag String pgsql_babelfish_image

内核小版本对应的标签。返回值如下:

  • pgsql_docker_image:通用实例标签。
  • pgsql_babelfish_image:Babelfish实例标签。
说明 当前仅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. 没有找到指定的实例,请检查实例的正确性。

访问错误中心查看更多错误码。