Help Center/ TaurusDB/ API Reference/ APIs (Unavailable Soon)/ DB Engine Version Queries/ Querying Version Information About a DB Engine
Updated on 2024-04-01 GMT+08:00

Querying Version Information About a DB Engine

Function

This API is used to query the version information of a specified DB engine. Before calling this API:

This API will be unavailable on March 31, 2025. You are advised to switch workloads to the new API (Querying Version Information About a DB Engine) before then.

URI

  • URI format

    GET https://{endpoint}/mysql/v3/{project_id}/datastores/{database_name}

  • Example

    GET https://{endpoint}/mysql/v3/619d3e78f61b4be68bc5aa0b59edcf7b/datastores/gaussdb-mysql

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    project_id

    Yes

    Project ID of a tenant in a region.

    To obtain this value, see Obtaining a Project ID.

    database_name

    Yes

    DB engine. The following DB engine is supported (case-insensitive): gaussdb-mysql

Request

None.

Response

  • Normal response
    Table 2 Parameter description

    Name

    Type

    Description

    datastores

    Array of objects

    DB versions.

    For details, see Table 3.

    Table 3 datastores field data structure description

    Name

    Type

    Description

    id

    String

    DB version ID. Its value is unique.

    name

    String

    DB version number. Only the major version number with two digits is returned.

  • Example normal response
    {
             "datastores": [{
                       "id": "87620726-6802-46c0-9028-a8785e1f1921",
                       "name": "8.0"
             }]
    }

Status Code

For details, see Status Codes.

Error Code

For details, see Error Codes.