Help Center/ GeminiDB/ API Reference/ APIs v3 (Recommended)/ Versions and Specifications/ Querying Version Information
Updated on 2024-08-08 GMT+08:00
View PDF
Share

Querying Version Information

Function

This API is used to query version information of a specified type of instances.

Constraints

This API supports the following types of instances:

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx
  • GeminiDB Redis

URI

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

Table 1 Path 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.

datastore_name

Yes

String

Database type. The value can be:

  • cassandra, indicating that the instances are of the GeminiDB Cassandra type.
  • mongodb, indicating that the instances are of the GeminiDB Mongo type.
  • influxdb, indicating that the instances are of the GeminiDB Influx type.
  • redis, indicating that the instances are of the GeminiDB Redis type.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

versions

Array of strings

Database version. The supported versions are:

  • GeminiDB Cassandra instance 3.11
  • GeminiDB Mongo replica set 4.0
  • GeminiDB Influx instance 1.7
  • GeminiDB Redis instance 5.0

Example Requests

URI example 
GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/datastores/cassandra/versions

Example Responses

Status code: 200

Success

{
  "versions" : [ "3.11" ]
}

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.