调用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
IsProxyLatestVersion 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

数据库引擎小版本号。

  • 当DBVersion为8.0时，取值范围如下：
    • 8.0.2
    • 8.0.1
  • 当DBVersion为5.7时，取值为5.7.28。
  • 当DBVersion为5.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>
    <IsProxyLatestVersion>true</IsProxyLatestVersion>
    <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",
  "IsProxyLatestVersion" : "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"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid. 指定的参数DBClusterId无效
404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的 DBClusterId。

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