You need to enable JavaScript to run this app.
文档中心
云数据库 PostgreSQL 版

云数据库 PostgreSQL 版

复制全文
下载 pdf
V2(2022-01-01)
API 发布历史
复制全文
下载 pdf
API 发布历史
2026 年 10 月​
​
API​
发布时间​
变更记录​
关联功能​
2026-10-15​
新增接口。​
SQL 限流​
​
​
​
​
​
​
​
​
​
​
​
​
​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
修改 DescribeBackups​
​
更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
​
​
​
​
​
​
​
​
​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
​
更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
​
​
​
​
​
​
修改 公共结构体 - BasicInfoObject​
​
更新参数 DBEngineVersion 的取值范围,增加 PostgreSQL_18 。​
-​
修改 公共结构体 - InstanceInfoObject​
​
​
​
修改 公共结构体 - InstanceObject​
​
​
​
修改 公共结构体 - InstanceSpecObject​
​
​
​
​
2026 年 06 月​
​
API​
发布时间​
变更记录​
关联功能​
2026-06-03​
新增请求参数 TDEEnable 和 KMSTrn。​
实例管理​
​
新增返回参数 TDEEnable 和 KMSTrn。​
​
​
2026 年 04 月​
​
API​
发布时间​
变更记录​
关联功能​
修改 CreateAllowList​
2026-04-16​
更新请求参数 UserAllowList 和 AllowList 的描述信息,增加对同时传入时取值有效性的说明。​
数据安全​
​
2026 年 03 月​
​
API​
发布时间​
变更记录​
关联功能​
2026-03-30​
因不同规格支持的存储空间范围不同,更新请求参数 StorageSpace 的描述信息。​
实例管理​
​
​
​
​
​
​
​
​
​
​
​
备份与恢复​
修改 公共结构体 - InstanceSpecObject​
​
新增参数 StorageSpaceMax 和 StorageSpaceMin,分别用于说明当前规格支持的存储空间的最大值和最小值。​
​
2026 年 01 月​
​
API​
发布时间​
变更记录​
关联功能​
2026-01-09​
更新接口的请求类型,从“同步请求”更新为“异步请求”。​
连接管理​
​
​
参数管理​
​
新增请求参数 MaintenanceWindow。​
实例管理​
​
新增返回参数 MaintenanceWindow。​
​
​
​
​
​
新增请求参数 SwitchType、SwitchType 和 SpecifiedSwitchEndTime。​
​
​
新增请求参数 MaintenanceWindow。​
备份与恢复​
​
新增接口。​
事件管理​
新增 ModifyTask​
​
​
任务管理​
​
2025 年 12 月​
​
API​
发布时间​
变更记录​
关联功能​
2025-12-02​
新增 DescribeWALLogBackups 接口,用于获取指定实例已备份的 WAL 日志列表。​
备份与恢复​
​
新增 PrivateNetworkVpcId 参数,用于筛选使用指定私有网络的实例。​
实例管理​
​
新增返回参数 NoneKernelParameters,用于返回实例当前的参数配置(非内核参数)。​
参数管理​
​
2025 年 10 月​
​
API​
发布时间​
变更记录​
关联功能​
2025-10-13​
  • 新增返回参数 DataIncrBackupPeriods,用于描述备份方式为正常增量时的备份频率,并提示实例未开启增量备份时则不返回该字段。​
  • 新增返回参数 HourlyIncrBackupEnable,用于描述是否开启高频备份功能。​
  • 修改返回参数 IncrementBackupFrequency 的描述,新增高频增量备份频率取值 12,并说明该参数仅在 HourlyIncrBackupEnable 取值为 true 时生效。​
备份与恢复​
​
  • 在 FullBackupPeriod 参数的提示信息中新增说明:每周至少选择一天进行全量备份。​
  • 新增参数 DataIncrBackupPeriods:用于设置增量备份的方式为正常增量时的备份频率,取值不能与全量备份的周期重叠,且每周最多可选择六天进行增量备份。​
  • 新增参数 HourlyIncrBackupEnable:用于控制是否开启高频备份功能。​
  • 修改 IncrementBackupFrequency 参数的描述:新增取值 12,并说明该参数仅在 HourlyIncrBackupEnable 取值为 true 时生效。​
​
2025-10-14​
  • 在 DescribeDBInstances 接口的 Body 参数中新增了 StorageType 参数,用于指定实例存储类型,取固定值 LocalSSD(本地 SSD 盘)。​
  • 在 AddressObject 结构中新增了 CrossRegionDomain 参数,用于表示可跨地域访问的私网地址,当无此地址时则不返回该字段。​
  • 在 AddressObject 结构中新增了 DomainVisibilitySetting 参数,用于表示私网地址类型,取值为 LocalDomain(本地域域名)或 CrossRegionDomain(可跨地域访问域名)。​
实例管理​
​
  • 在 AddressObject 中新增了 CrossRegionDomain 参数,用于描述可跨地域访问的私网地址。​
  • 在 AddressObject 中新增了 DomainVisibilitySetting 参数,用于描述私网地址类型,包括本地域域名和可跨地域访问域名。​
​
2025-10-13​
  • 新增 StorageType 请求参数,用于指定实例存储类型,取固定值 LocalSSD(本地 SSD 盘)。​
  • 在返回参数 InstanceSpecObject 中新增 StorageType 字段,用于返回实例存储类型信息,取固定值 LocalSSD(本地 SSD 盘)。​
​
​
  • 新增 EstimateOnly 参数,用于发起变配评估,当取值为 true 时,会返回 EstimationResult 参数说明此次变配的影响。​
  • 在返回参数中新增 EstimationResult 字段,用于描述按照当前配置变更后预估会对实例产生的影响。​
  • 在返回参数中对 OrderId 字段添加说明,当 EstimateOnly 取值为 true 时,该字段的返回值为空。​
  • 新增 ModifyDBInstanceSpecEstimationResult 对象,包含 Plans 和 Effects 字段,分别描述变更后对实例的影响和读写连接的影响。​
​
​
新增 DescribeDBInstanceSSL 接口,用于查询指定实例的 SSL 设置。该接口支持查询以下信息:​
  • 受保护地址​
  • 强制加密状态​
  • SSL 证书有效性​
  • SSL 功能开启状态​
  • SSL 证书到期时间​
  • 支持的 TLS 版本​
数据安全​
​
新增 ModifyDBInstanceSSL 接口,用于修改指定实例的 SSL 配置。该接口支持以下功能:​
  • 开启或关闭 SSL 加密功能(通过 SSLEnable 参数)​
  • 更新 SSL 证书有效期(通过 ReloadSSLCertificate 参数)​
  • 开启或关闭 SSL 强制加密功能(通过 ForceEncryption 参数)​
注意事项​
  • 更新 SSL 证书有效期和强制加密功能仅在实例已开启 SSL 加密功能时生效​
  • 不支持同时传入 ReloadSSLCertificate 与 SSLEnable 参数​
​
​
新增 DownloadSSLCertificate 接口,用于下载指定实例的 SSL 证书。该接口需要提供实例 ID 作为必填参数,返回结果为证书压缩包。​
​
新增 DescribeTasks​
​
新增 DescribeTasks 接口,用于查询任务信息。该接口支持通过任务 ID 或任务时间范围查询任务详情,并返回任务的执行状态、耗时、创建时间等信息。​
任务管理​
​
2025 年 08 月​
​
API​
发布时间​
变更记录​
关联功能​
2025-08-26​
- 新增返回参数 AssociatedInstanceNum。​
​
2025 年 07 月​
​
API​
发布时间​
变更记录​
关联功能​
2025-07-31​
- 新增 AllowListIds 参数,用于绑定白名单。支持绑定多个白名单,多个 ID 用英文逗号分隔,单个实例最多可绑定 100 个白名单。​
修改 DescribeBackups​
​
- 在 InstanceInfoObject 中新增了 AllowListIds 参数,用于描述备份所属实例绑定的白名单信息。​
-​
​
- 在 InstanceInfoObject 结构中新增了 AllowListIds 参数,用于描述备份所属实例绑定的白名单信息。​
​
​
- 新增 AllowListIds 参数,用于绑定白名单。支持绑定多个白名单,最多可绑定 100 个白名单。​
​
- 新增 MaxDelayTime 参数,用于表示运维事件的最晚可推迟时间,格式为 yyyy-MM-ddTHH:mm:ss.sssZ(UTC 时间)。​
​
  • 新增请求参数 AllowListCategory,用于指定白名单分类,取值包括 Ordinary(普通白名单)和 Default(默认白名单),默认值为 Ordinary。​
  • 新增请求参数 AllowListDesc,用于通过描述信息模糊搜索白名单。​
  • 新增请求参数 AllowListId,用于指定白名单 ID 进行查询。​
  • 新增请求参数 AllowListName,用于指定白名单名称进行查询。​
  • 新增请求参数 IPAddress,支持按 IP 地址查询白名单,多个 IP 地址可用英文逗号分隔。​
  • 新增请求参数 PageNumber,用于指定当前页页码,默认值为 1。​
  • 新增请求参数 PageSize,用于指定每页记录数,无默认值。​
  • 新增返回参数 Total,表示白名单的总数。​
  • 在 AllowListObject 中新增字段 AllowListCategory,表示白名单分类。​
  • 在 AllowListObject 中新增字段 SecurityGroupBindInfos,表示白名单绑定的安全组信息,包含安全组 ID、名称、IP 列表和关联模式等信息。​
  • 新增数据结构 SecurityGroupBindInfo,用于描述安全组绑定信息,包括 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 等字段。​
-​
​
  • 新增返回参数 AllowListCategory,用于标识白名单分类,取值包括 Ordinary(普通白名单)和 Default(默认白名单),默认值为 Ordinary。​
  • 新增返回参数 SecurityGroupBindInfos,用于描述该白名单绑定的安全组列表,包含安全组中的 IP、关联安全组的模式、安全组 ID 和安全组名称等信息。​
  • 新增返回参数 UserAllowList,用于描述安全组之外的、需要加入白名单的 IP 地址或 CIDR 格式的 IP 地址段。​
​
修改 CreateAllowList​
​
  • AllowList 参数由必选改为可选,并新增提示信息:该字段不能与 UserAllowList 字段同时使用。​
  • 新增 AllowListCategory 参数,用于指定白名单分类,可选值为 Ordinary(普通白名单)和 Default(默认白名单),默认值为 Ordinary。​
  • 新增 SecurityGroupBindInfos 参数,用于为白名单绑定安全组信息,包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 子参数。​
  • 新增 UserAllowList 参数,用于指定安全组之外需要加入白名单的 IP 地址,该字段不能与 AllowList 字段同时使用。​
  • 新增 SecurityGroupBindInfo 数据结构,包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。​
修改 ModifyAllowList​
​
  • 在 ModifyMode 参数描述中新增了警告信息:如需修改的白名单绑定有安全组,或需要在修改白名单时为白名单绑定安全组,则 ModifyMode 只能取值为 Cover。​
  • 新增了 AllowListCategory 参数,用于指定白名单分类,取值为 Ordinary(普通白名单)或 Default(默认白名单),默认值为 Ordinary。​
  • 新增了 SecurityGroupBindInfos 参数,用于为白名单绑定安全组的信息,包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。​
  • 新增了 UpdateSecurityGroup 参数,用于控制是否更新白名单所绑定的安全组,取值为 true(更新)或 false(不更新),默认值为 false。​
  • 新增了 UserAllowList 参数,用于指定安全组之外的、需要加入白名单的 IP 地址,支持 IP 地址或 CIDR 格式的 IP 地址段。​
  • 新增了 SecurityGroupBindInfo 结构体,用于描述安全组绑定信息,包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。​
​
2025 年 06 月​
​
API​
发布时间​
变更记录​
关联功能​
新增 CloneDatabase​
2025-06-04​
新增接口。​
​
​
​
​
新增 DeleteBackup​
​
​
​
​
​
​
​
​
-​
​
​
新增 DownloadBackup​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
修改 CreateBackup​
​
  • 新增请求参数 BackupScope、BackupMethod、BackupDescription、BackupMeta。​
  • 新增返回参数 BackupId。​
修改 DescribeBackups​
​
  • 新增请求参数 DownloadStatus、BackupMethod、BackupDatabaseName、BackupDescription、CreateType 和BackupScope。​
  • 新增返回参数 BackupId。​
-​
​
更新请求参数 WriteNodeHaltWriting 的描述信息。​
​
​
​
​
新增 公共结构体 - BackupMetaObject​
​
新增结构体。​
修改 公共结构体 - BackupObject​
​
  • 新增参数 BackupDataSize、BackupDescription、BackupMeta、BackupMethod、BackupScope 和 DownloadStatus。​
  • 更新参数 BackupStatus、BackupType 和 CreateType 的取值范围。​
​
2025 年 04 月​
​
API​
发布时间​
变更记录​
关联功能​
2025-04-22​
新增接口。​
​
​
-​
​
​
修改 CreateDatabase​
​
更新请求参数 Owner 的描述信息,增加不能将 Owner 指定为被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号的限制。​
​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
修改 CreateDBAccount​
​
新增可选请求参数 NotAllowPrivileges。​
修改 CreateSchema​
​
更新请求参数 Owner 的描述信息,增加不能将 Owner 指定为被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号的限制。​
​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
-​
修改 DescribeDBInstanceSpecs​
​
​
​
修改 DescribeDBInstanceParameters​
​
更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
​
​
更新请求参数 Owner 的描述信息,增加不能将 Owner 指定为被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号的限制。​
​
新增请求参数 WriteNodeHaltWriting。​
​
  • 更新请求参数 ReadOnlyNodeMaxDelayTime 和 ReadOnlyNodeDistributionType 的描述信息。​
  • 新增请求参数 ReadWriteProxyConnection 和 WriteNodeHaltWriting。​
​
​
更新请求参数 SchemaInfoObject > Owner 的描述信息,增加不能将 Owner 指定为被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号的限制。​
新增 公共结构体 - PlannedEventsObject​
​
新增公共结构体。​
修改 公共结构体 - AccountObject​
​
新增参数 NotAllowPrivileges。​
修改 公共结构体 - BasicInfoObject​
​
更新参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
修改 公共结构体 - ChargeInfoObject​
​
更新参数 Number 的取值范围。​
修改 公共结构体 - DatabaseObject​
​
更新参数 Owner 的描述信息。增加被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号不能作为数据库 Owner 的信息。​
修改 公共结构体 - EndpointObject​
​
新增参数 ReadWriteProxyConnection 和 WriteNodeHaltWriting。​
修改 公共结构体 - InstanceInfoObject​
​
  • 更新参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
  • 新增参数 Endpoints。​
修改 公共结构体 - InstanceObject​
​
更新参数 DBEngineVersion 的取值范围,增加 PostgreSQL_17 。​
修改 公共结构体 - InstanceSpecObject​
​
​
修改 公共结构体 - SchemaObject​
​
更新参数 Owner 的描述信息。增加被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号不能作为 Schema Owner 的信息。​
​
2025 年 02 月​
​
API​
发布时间​
变更记录​
关联功能​
修改 CreateDatabase​
2025-02-19​
更新请求参数 Ctype 改为 CType。​
修改 DescribeBackups​
​
更新返回参数 StorageSpace 的类型为 Integer。​
-​
​
​
​
​
  • 更新请求参数 ParameterName 的示例值。​
  • 更新接口的返回示例。​
  • 返回参数 Parameters 数据结构中新增 DescriptionZH 字段。​
​
​
移除请求参数 Parameters 数据结构中的 CheckingCode、DefaultValue、Description、ForceRestart 和 Type 字段。​
修改 DescribeSlots​
​
  • 新增请求参数 IPAddress。​
  • 返回参数 ReplicationSlots 数据结构中新增字段 IPAddress。​
修改 DeleteSlot​
​
更新接口的注意事项。​
​
2024 年 12 月​
​
API​
发布时间​
变更记录​
关联功能​
2024-12-11​
更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
​
  • 为接口增加注意事项。​
  • 更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
-​
​
更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
​
​
  • 为接口增加注意事项。​
  • 更新请求参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
​
​
更新请求参数 ApplyScope 和 CustomNodeIds 的描述信息。​
​
更新请求参数 NodeOperateType 的描述信息。​
-​
​
​
​
​
更新请求参数 Period 的描述信息。​
​
更新请求参数 All 的描述信息。​
修改 CreateDatabase​
​
更新请求参数 Owner 的描述信息。​
​
更新请求参数 DBName 的描述信息。​
-​
​
更新请求参数 AccountName 的描述信息。​
​
修改 DescribeSchemas​
​
更新请求参数 DBName 的描述信息。​
​
​
更新请求参数 EndpointName 的描述信息。​
​
更新请求参数 GlobalReadOnly 的描述信息。​
​
更新请求参数 ReadOnlyNodeDistributionType 为可选参数。​
​
更新请求参数 ReadWriteSpliting 的描述信息。​
​
​
为接口增加注意事项。​
​
  • 更新请求参数 ParameterName 的描述信息。​
  • 更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
-​
​
更新请求参数 Type 的取值范围和示例值。​
修改 DescribeBackups​
​
  • 更新请求参数 BackupId、BackupStartTime、BackupEndTime、BackupStatus、BackupType 的描述信息。​
  • 更新返回参数 DBEngineVersion 的取值范围,增加 PostgreSQL_15 和 PostgreSQL_16。​
-​
​
更新请求参数 BackupRetentionPeriod、FullBackupTime、FullBackupPeriod、IncrementBackupFrequency、WALLogSpaceLimitEnable 的描述信息。​
​
更新请求参数 InstanceId、InstanceName、BackupStartTime、BackupEndTime、ProjectName、BackupStatus、BackupType 的描述信息。​
-​
​
更新请求参数 NodeOperateType 的描述信息。​
修改 DescribeSlots​
​
更新请求参数 SlotName、SlotType、Plugin、Database、Temporary、SlotStatus 的描述信息。​
-​
修改 DeleteSlot​
​
更新请求参数 All 的描述信息。​
​
更新请求参数 QueryStartTime、QueryEndTime、Context 的描述信息。​
​
修改 CreateAllowList​
​
更新请求参数 AllowListName 和 AllowListDesc 的描述信息。​
修改 ModifyAllowList​
​
更新请求参数 AllowListName、AllowListDesc、AllowList、ModifyMode、ApplyInstanceNum 的描述信息。​
​
更新请求参数 AllowListName 和 AllowListDesc 的描述信息。​
​
2024 年 10 月​
​
API​
发布时间​
变更记录​
关联功能​
2024-10-24​
新增返回参数 WALLogSpaceLimitEnable。​
​
新增请求参数 WALLogSpaceLimitEnable。​
​
2024 年 08 月​
​
API​
发布时间​
变更记录​
关联功能​
2024-08-28​
更新参数 VpcId 和 SubnetId 的描述信息,补充对取值范围的限制。​
​
​
​
2024 年 07 月​
​
API​
发布时间​
变更记录​
关联功能​
新增 DescribeSlots​
2024-07-30​
新增接口。​
新增 DeleteSlot​
​
​
​
更新请求参数 DBEngineVersion 的取值范围。​
​
​
-​
​
​
​
​
更新返回参数 DBEngineVersion 的取值范围。​
​
​
更新参数 DBEngineVersion 的取值范围。​
​
修改 DescribeBackups​
​
​
​
​
​
​
​
2024 年 06 月​
​
API​
发布时间​
变更记录​
关联功能​
修改 ModifyDBEndpointAddress​
2024-06-20​
更新接口,增加使用限制。​
修改 RestartDBInstance​
2024-06-12​
更新接口,增加重启指定只读节点相关字段。​
​
2024 年 04 月​
​
API​
发布时间​
变更记录​
关联功能​
新增 DescribeAllowLists​
2024-04-25​
新增接口。​
新增 DescribeAllowListDetail​
​
​
​
新增 CreateAllowList​
​
​
新增 ModifyAllowList​
​
​
新增 AssociateAllowList​
​
​
新增 DisassociateAllowList​
​
​
新增 DeleteAllowList​
​
​
新增 UnifyNewAllowList​
​
​
新增 UpgradeAllowListVersion​
​
​
​
​
最近更新时间:2026.10.16 14:17:39
这个页面对您有帮助吗?
有用
有用
无用
无用