调用DescribeDBClusterVersion接口查看PolarDB MySQL引擎集群当前内核版本的详细信息。

说明 更多关于PolarDB MySQL引擎集群的内核版本说明和详情,请参见内核版本说明内核发布日志

调试

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

请求参数

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

系统规定参数。取值:DescribeDBClusterVersion

DBClusterId String pc-****************

集群ID。

说明 您可以通过DescribeDBClusters接口查看账号下所有集群的详细信息(如集群ID)。

返回数据

名称 类型 示例值 描述
IsLatestVersion String true

当前版本是否为最新版本,取值范围如下:

  • true
  • false
DBVersion String 8.0

数据库引擎的大版本号,取值范围如下:

  • 8.0
  • 5.7
  • 5.6
DBRevisionVersion String 8.0.1.1.7

数据库引擎的修订版本号。

说明 针对PolarDB MySQL引擎5.6版本的集群,仅发布日期在20200831之后的Revision Version信息会被返回,否则该参数为空。关于PolarDB MySQL引擎集群的内核版本详情,请参见内核发布日志
RequestId String 47921222-0D37-4133-8C0D-017DC3******

请求ID。

DBVersionStatus String Stable

当前数据库小版本状态,取值范围如下:

  • Stable:当前版本状态稳定。
  • Old:当前版本过旧,建议升级到最新版本。
  • HighRisk:当前版本有严重缺陷,请立即升级到最新的版本。
说明 关于如何升级数据库小版本,请参见版本升级
DBClusterId String pc-****************

集群ID。

DBMinorVersion String 8.0.1

数据库引擎小版本号。

  • DBVersion8.0时,取值范围如下:
    • 8.0.2
    • 8.0.1
  • DBVersion5.7时,取值为5.7.28
  • DBVersion5.6时,取值为5.6.16
ProxyRevisionVersion String 2.4.15

数据库代理的版本。

ProxyVersionStatus String Stable

数据库代理的版本状态。取值范围如下:

  • Stable:当前版本状态稳定。
  • Old:当前版本过旧,建议升级到最新版本。
  • HighRisk:当前版本有严重缺陷,请立即升级到最新的版本。
说明 关于如何升级数据库代理版本,请参见版本升级
ProxyLatestVersion String 2.4.17

数据库代理的最新版本。

DBLatestVersion String 8.0.1.1.16

数据库内核引擎的最新版本。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribeDBClusterVersion
&DBClusterId=pc-****************
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBClusterVersionResponse>
    <IsLatestVersion>true</IsLatestVersion>
    <DBVersion>8.0</DBVersion>
    <DBRevisionVersion>8.0.1.1.7</DBRevisionVersion>
    <RequestId>47921222-0D37-4133-8C0D-017DC3******</RequestId>
    <DBVersionStatus>Stable</DBVersionStatus>
    <DBClusterId>pc-****************</DBClusterId>
    <DBMinorVersion>8.0.1</DBMinorVersion>
    <ProxyRevisionVersion>2.4.15</ProxyRevisionVersion>
    <ProxyVersionStatus>Stable</ProxyVersionStatus>
    <ProxyLatestVersion>2.4.17</ProxyLatestVersion>
    <DBLatestVersion>8.0.1.1.16</DBLatestVersion>
</DescribeDBClusterVersionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "IsLatestVersion" : "true",
  "DBVersion" : "8.0",
  "DBRevisionVersion" : "8.0.1.1.7",
  "RequestId" : "47921222-0D37-4133-8C0D-017DC3******",
  "DBVersionStatus" : "Stable",
  "DBClusterId" : "pc-****************",
  "DBMinorVersion" : "8.0.1",
  "ProxyRevisionVersion" : "2.4.15",
  "ProxyVersionStatus" : "Stable",
  "ProxyLatestVersion" : "2.4.17",
  "DBLatestVersion" : "8.0.1.1.16"
}

错误码

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