文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 查询数据库引擎的版本
更新时间:2024-03-28 GMT+08:00

查询数据库引擎的版本

功能介绍

获取指定数据库引擎对应的数据库版本信息。

URI

  • URI格式

    GET /v3/{project_id}/datastores/{database_name}

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    database_name

    数据库引擎。支持的引擎如下,不区分大小写:

    • MySQL
    • PostgreSQL
    • SQLServer

请求消息

  • 请求参数

    无。

  • URI样例

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

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    dataStores

    Array of objects

    数据库版本信息列表。

    详情请参见表3

    表3 dataStores字段数据结构说明

    名称

    参数类型

    说明

    id

    String

    数据库版本ID,该字段不会有重复。

    name

    String

    数据库版本号。

    • 对于MySQL引擎可以返回小版本号,例如MySQL 5.6.51版本,将返回5.6.51。
    • 对于PostgreSQL和SQL Server引擎,只返回两位数的大版本号,例如PostgreSQL 9.6.X版本,仅返回9.6。
  • 正常响应样例
    {
    	"dataStores": [{
    		"id": "87620726-6802-46c0-9028-a8785e1f1921",
    		"name": "8.0.21"
    	}, {
    		"id": "87620726-6802-46c0-9028-a8785e1f1922",
    		"name": "5.7.33"
    	}, {
    		"id": "e8a8b8cc-63f8-4fb5-8d4a-24c502317a62",
    		"name": "5.6.51"
    	}]
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码