Updated on 2026-09-24 GMT+08:00

Querying DB Engines

Function

This API is used to query DB engines. Before calling this API:

Learn how to authenticate this API.
Obtain the required region and endpoint.

Debugging

You can debug this API in API Explorer.

URI

GET /v3/{project_id}/datastores

**Table 1** Parameter description
Name	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range The value can contain 32 characters. Only letters and digits are allowed. Default Value N/A

Request Parameters

None

Response Parameters

**Table 2** Parameter description
Name	Type	Description
datastores	Array of objects	DB engines. For details, see Table 3.

**Table 3** dataStores field data structure description
Parameter	Type	Description
supported_versions	Array of strings	Engine versions supported by the deployment model.
instance_mode	String	Deployment model. Range: ha: centralized independent: independent

Example Request

Querying DB engines

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/datastores

Example Response

DB engines queried.

{
 "datastores": [
  {

   "supported_versions": [
    "2.0",
    "2.3",
    "2.6",
    "2.9"
   ],
                        "instance_mode": "ha"
  }
 ]
}

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Parent topic: DB Engine Versions and Specifications