查询数据库引擎的版本

功能介绍

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

• 调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

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"
  	}]
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。