Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This page provides latest news and updates regarding the recommended API versions to be used. The API versions that are not listed here might be supported, but will be retired soon. The documentation for the latest Stable API version is available here.
API Releases
Note
Every Stable and Preview API version is cumulative. This means that it includes the previous features in addition to the features included under the Comments column.
| API Version | Stable/Preview | Comments |
|---|---|---|
| 2025-08-01 | Stable (GA) | Earlier GA features + PG 18 support PG 17 support Adds support for specifying default database name in an Elastic Cluster Adds support for table recommendations Corrects HTTP response codes to reflect what each API can return Adds example for CMK-based data encryption with automatic key version update Adds example for creation of server in Microsoft owned virtual network Renames files for better representation of their contents Renames operation IDs to improve organization, clarity, and navigation Improves metadata of local definitions Improves descriptions for consistency |
| 2025-06-01-preview | Preview | Renames files for better representation of their contents Renames operations to improve organization, clarity, and navigation Adds example for CMK-based data encryption with automatic key version update Adds example for creation of server in Microsoft owned virtual network Adds support for table recommendations Adds support for specifying default database name in an Elastic Cluster Removes support for server parameter tuning feature Improves descriptions Improves metadata of local definitions Corrects HTTP response codes to reflect what each API can return |
| 2025-01-01-preview | Preview | Adds support for server parameter tuning feature |
| 2024-11-01-preview | Preview | Index tuning Added source types for migration PG 17 support UltraSSD_LRS storage type support Elastic Clusters on flexible server instances |
| 2024-08-01 | Stable (GA) | Earlier GA features + Geo + CMK - Revive Dropped Storage auto growth IOPS scaling New location capability api Long Term Retention Backup Server Logs Migrations Migration Pre-validation Read replicas - Switchover (Site swap) Read replicas - Virtual Endpoints Private Endpoints Azure Defender / Threat Protection APIs PG 16 support PremiumV2_LRS storage type support Location capability changes for SSDv2 Migration Roles Migration Instance Resource Id to support Private endpoint Migrations On-demand backup System assigned managed identity |
| 2023-06-01-preview | Preview | Earlier GA features + Migration Prevalidation Read replicas - Switchover (Site swap) Read replicas - Virtual Endpoints Private Endpoints Azure Defender\Threat Protection APIs PG 16 support PremiumV2_LRS storage type support Location capability changes for SSDv2 Quota Usage API |
| 2023-03-01-preview | Preview | New GA version features (2022-12-01) + Geo + CMK Storage auto growth IOPS scaling New location capability API Azure Defender Server Logs Migrations |
| 2022-12-01 | Stable (GA) | Earlier GA features + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Stable (GA) | Earlier GA features + Server CRUD CheckNameAvailability Configurations (Server parameters) Database Firewall rules Private DNS zone suffix PITR Server Restart Server Start Server Stop Maintenance window Virtual network subnet usage |
Using preview versions of API from Terraform
Terraform is an infrastructure-as-code (IaC) software tool created by HashiCorp. Users define and provide data center infrastructure using a declarative configuration language known as HashiCorp Configuration Language (HCL), or optionally JSON. Terraform is a common way to perform IaC management for Azure Database for PostgreSQL based on GA Azure RM API, in addition to Azure Resource Manager (ARM) Templates Terraform community releases regular updates for Azure Resource Manager (AzureRM) Terraform provider based on Azure Resource Manager API version in General Availability (GA). If particular feature currently is in Preview API and hasn't been yet incorporated into GA API and AzureRM Terraform provider, you can use AzAPI Terraform provider to call Preview API directly from Terraform. The AzAPI provider is a thin layer on top of the Azure Resource Manager REST APIs. The AzAPI provider enables you to manage any Azure resource type using any API version. The AzAPI provider is a thin layer on top of the Azure ARM REST APIs. The AzAPI provider enables you to manage any Azure resource type using any API version. This provider complements the AzureRM provider by enabling the management of new Azure resources and properties (including private preview).
AzAPI provider features the following benefits:
- Supports all Azure services:
- Private preview services and features
- Public preview services and features
- All API versions
- Full Terraform state file fidelity
- Properties and values are saved to state
- No dependency on Swagger
- Common and consistent Azure authentication
The AzAPI2AzureRM is an open source tool that is designed to help migrate from the AzAPI provider to the AzureRM provider.
Contacts
For any questions or suggestions you might have on Azure Database for PostgreSQL, send an email to the Azure Database for PostgreSQL Team (@Ask Azure Database for PostgreSQL). Note that this email address isn't a technical support alias.
In addition, consider the following points of contact as appropriate:
- To contact Azure Support, file a ticket from the Azure portal.
- To fix an issue with your account, file a support request in the Azure portal.
- To provide feedback or to request new features, create an entry via UserVoice.