Help Center/ Distributed Database Middleware/ API Reference/ APIs (Recommended)/ Version Management/ Querying a DDM Kernel Version That Can Be Changed (a V3 API)
Updated on 2026-05-30 GMT+08:00

Querying a DDM Kernel Version That Can Be Changed (a V3 API)

Function

Obtain a DDM kernel version that can be changed.

Constraints

None

URI

  • URL format

    GET /v3/{project_id}/instances/{instance_id}/database-version/available-versions

  • Parameter description
    Table 1 URI parameters

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID of a tenant in a region

    To obtain this value, see Obtaining a Project ID.

    instance_id

    Yes

    String

    DDM instance ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

You can obtain the token by calling the IAM API used to obtain a user token.

Example Request

Obtain a DDM kernel version that can be changed.

GET https://{endpoint}/v3/{project_id}/instances/{instance_id}/database-version/available-versions

Response

  • Normal response
    Table 3 Response body parameters

    Parameter

    Type

    Description

    versions

    Array of strings

    Kernel version that can be changed.

    current_version

    String

    Current kernel version of the DDM instance.

    latest_version

    String

    Latest preferred kernel version, which can be changed.

    current_favored_version

    String

    Preferred version in a series, which can be changed. For example, version 3.0.8.5 is the preferred version in the 3.0.8 series.

    previous_version

    String

    Source version of the DDM instance before the latest upgrade.

  • Normal response example
    {
      "versions": [
        "3.1.0.7"
      ],
      "current_version": "3.0.8.5",
      "latest_version": "3.1.0.7",
      "current_favored_version": "3.0.8.5",
      "previous_version": "3.0.8.3"
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Codes

For details, see Error Codes.