查询可升级到的小版本号（PostgreSQL） - ListSmallVersion

功能介绍

查询小版本号。

调用接口前，您需要了解API认证鉴权。
调用接口前，您需要了解请求Header参数说明。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
rds:instance:listDatabaseVersion	-	database	-	rds:instance:list	-

URI

URI格式
 GET https://{Endpoint}/v3/{project_id}/datastores/{database_name}/small-version

参数说明

表1 参数说明
名称	是否必选	参数类型	说明
project_id	是	String	参数解释：租户在某一region下的project ID。约束限制：非空。取值范围：获取方法请参见获取项目ID。默认取值：不涉及。
database_name	是	String	参数解释：数据库引擎名。约束限制：不涉及。取值范围： postgresql。默认取值：不涉及。

请求消息

表2 请求Body参数
参数	是否必选	参数类型	描述
version	是	String	参数解释：待升级的数据库版本号，可输入大版本号或者小版本号。约束限制：不涉及。取值范围：例如：16、16.5、16.5.21。默认取值：不涉及。
offset	否	Integer	参数解释：索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。约束限制：必须为数字，不能为负数。取值范围：大于等于0的整数。默认取值： 0
limit	否	Integer	参数解释：查询记录数。约束限制：不涉及。取值范围：默认为100，不能为负数，最小值为1，最大值为100。默认取值： 100

请求示例

查询RDS for PostgreSQL 16的小版本信息。

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/datastores/postgresql/small-version?version_name=16

响应消息

正常响应要素说明

表3 要素说明
参数	参数类型	描述
data_stores	Array of objects	参数解释：可升级到的数据库版本信息列表。详情请参见表4。
count	int	参数解释：查询总个数。取值范围：不涉及。

表4 data_stores字段说明
参数	参数类型	描述
id	String	参数解释：数据库版本ID，该字段不会有重复。取值范围：不涉及。
name	String	参数解释：可升级到的小版本号。取值范围：不涉及。
favored	Boolean	参数解释：是否优选版本。取值范围： true：是优选版本。 false：不是优选版本。

正常响应样例

{
  "data_stores": [
    {
      "id": "87620726-6802-46c0-9028-a8785e1f1921",
      "name": "16.5.21",
      "favored": true
    },
    {
      "id": "87620726-6802-46c0-9028-a8785e1f1922",
      "name": "16.8.33",
      "favored": false
    },
    {
      "id": "e8a8b8cc-63f8-4fb5-8d4a-24c502317a62",
      "name": "16.17.51",
      "favored": false
    }
  ]
}