Help Center/ Document Database Service/ API Reference (Ally Region)/ APIs V3.0 (Recommended)/ Querying Database Version Information
Updated on 2026-01-08 GMT+08:00
View PDF
Share

Querying Database Version Information

API Description

This API is used to obtain database version information about a specified type of a DB instance.

URI

  • URI format

    GET https://{Endpoint}/v3/{project_id}/datastores/{datastore_name}/versions

Request Parameters

Table 1 Request parameters

Parameter

Type

IN

Mandatory

Description

X-Auth-Token

string

header

Yes

User token obtained from IAM.

For details, see Authentication.

project_id

string

path

Yes

Project ID of a tenant in a region. Obtain the project ID by following the instructions in Obtaining a Project ID.

datastore_name

string

path

Yes

Database version type. The value is DDS-Community.

Response Parameters

Table 2 Parameter description

Parameter

Type

Mandatory

Description

versions

Array of strings

Yes

DB version. Versions 4.4, 4.2, 4.0, and 3.4 are supported. The value can be 4.4, 4.2, 4.0, or 3.4.
  • Response example 
    {
    "versions": [
        "3.2",
        "3.4",
        "4.0",
        "4.2",
        "4.4"
    ]
}

Status Code

For details, see Status Code.

Error Code

For details, see Error Code.

Parent topic: APIs V3.0 (Recommended)