Updated on 2026-07-16 GMT+08:00

Querying DB Engines

Function

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

Debugging

You can debug this API in API Explorer.

URI

GET /v3.1/{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

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token.

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

After a response is returned, the value of X-Subject-Token in the response header is the token.

Constraints

N/A

Range

N/A

Default Value

N/A

X-Language

No

String

Definition

Language.

Constraints

N/A

Range

  • zh-cn: Chinese
  • en-us: English

Default Value

en-us

Response Parameters

Table 3 Parameter description

Name

Type

Description

datastores

Array of objects

Definition

DB engines.

For details, see Table 4.

Table 4 dataStores field data structure description

Parameter

Type

Description

supported_versions

Array of strings

Definition

Engine versions supported by the deployment model.

instance_mode

String

Definition

Deployment model.

Range

  • ha: centralized
  • independent: independent

Example Request

Querying DB engines

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

Example Response

DB engines queried.
{
	"datastores": [
		{
			
			"supported_versions": [
				"V2.0-2.0",
				"V2.0-2.3",
				"V2.0-2.6",
				"V2.0-2.9"
			],
                        "instance_mode": "ha"
		}
	]
}

Status Code

Error Code

For details, see Error Codes.