Queries the details of the current kernel of a PolarDB for MySQL cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No DescribeDBClusterVersion

The operation that you want to perform. Set the value to DescribeDBClusterVersion.

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

The ID of the cluster.

Note You can call the DescribeDBClusters operation to query the details of all clusters under your account, such as the cluster ID.

Response parameters

Parameter Type Example Description
DBClusterId String pc-****************

The ID of the cluster.
DBMinorVersion String 8.0.1

The minor version of the database engine.

  • If DBVersion is 8.0, the following values are available:
    • 8.0.2
    • 8.0.1
  • If DBVersion is 5.7, the value of this parameter is 5.7.28.
  • If DBVersion is 5.6, the value of this parameter is 5.6.16.
DBRevisionVersion String 8.0.1.1.7

The revision of the database engine.

Note For clusters of PolarDB for MySQL 5.6, only the Revision Version that is released after 20200831 is returned. Otherwise, this parameter is not returned. For more information about the kernel version of a PolarDB for MySQL cluster, see Release notes of the PolarDB kernel.
DBVersion String 8.0

The major version of the database engine. Valid values:

  • 8.0
  • 5.7
  • 5.6
DBVersionStatus String Stable

The status of the minor version. Valid values:

  • Stable: The current version is stable.
  • Old: The current version is outdated. We recommend that you upgrade the cluster to the latest version.
  • HighRisk: The current version has serious defects. We recommend that you immediately upgrade the cluster to the latest version.
Note For more information about how to upgrade the minor version, see Upgrade versions.
IsLatestVersion String true

Indicates whether the current version is the latest one. Valid values:

  • true
  • false
RequestId String 47921222-0D37-4133-8C0D-017DC3******

The ID of the request.

Samples

Sample requests

http(s)://polardb.aliyuncs.com/? Action=DescribeDBClusterVersion
&DBClusterId=pc-****************
&<common request parameters>

Sample responses

XML format 

<DescribeDBClusterVersionResponse>
  <LatestRevisionVersion></LatestRevisionVersion>
  <IsLatestVersion>true</IsLatestVersion>
  <DBVersion>8.0</DBVersion>
  <RequestId>47921222-0D37-4133-8C0D-017DC3******</RequestId>
  <DBRevisionVersion>8.0.1.1.7</DBRevisionVersion>
  <DBVersionStatus>Stable</DBVersionStatus>
  <DBClusterId>pc-****************</DBClusterId>
  <DBMinorVersion>8.0.1</DBMinorVersion>
</DescribeDBClusterVersionResponse>

JSON format 

{
    "LatestRevisionVersion": "",
    "IsLatestVersion": "true",
    "DBVersion": "8.0",
    "RequestId": "47921222-0D37-4133-8C0D-017DC3******",
    "DBRevisionVersion": "8.0.1.1.7",
    "DBVersionStatus": "Stable",
    "DBClusterId": "pc-****************",
    "DBMinorVersion": "8.0.1"
}

Errors

For a list of error codes, visit the API Error Center.