Azure Database for PostgreSQL preview API life cycle

The Azure Database for PostgreSQL preview APIs (APIs that end in -preview) have a lifespan of ~90 days from when a new preview API is released. This means that you can expect the 2026-01-01-preview API to be deprecated somewhere around April 31st, 2026.

We love when people try our preview features and give us feedback, so we encourage you to use the preview API.

After an API version is deprecated, it will no longer function! We recommend you routinely:

  • Update your ARM/BICEP templates using preview API versions to use the latest version of the preview API.
  • Update any preview SDKs or other tools built on the preview API to - the latest version.

You should perform these updates at a minimum every 3 months. If you fail to do so, you will be notified that you are using a soon-to-be deprecated API version as deprecation approaches.

How to check what API versions you're using

If you're unsure whether you're using a specific API version, you can check the Azure Activity Log for recent Azure Database for PostgreSQL management operations that use that version.

Set the API version that you want to check. The following example searches activity from the last 30 days for operations that use the 2023-12-01-preview API version:

export API_VERSION="2023-12-01-preview"

az monitor activity-log list \
  --offset 30d \
  --max-events 10000 \
  --namespace Microsoft.DBforPostgreSQL \
  --query "[?contains(not_null(httpRequest.uri,''), '$API_VERSION')].{Time:eventTimestamp, Operation:operationName.value, URI:httpRequest.uri}" \
  --output table

Replace 2023-12-01-preview with the API version that you want to check.

How to update to a new version of the API

Upcoming API deprecations

API version Announcement date Retirement date
2025-06-01-preview October 30, 2026 January 30, 2027
2025-01-01-preview October 30, 2026 January 30, 2027
2024-11-01-preview October 30, 2026 January 30, 2027
2024-03-01-preview October 30, 2026 January 30, 2027
2023-12-01-preview October 30, 2026 January 30, 2027
2023-06-01-preview October 30, 2026 January 30, 2027
2023-03-01-preview October 30, 2026 January 30, 2027
2022-05-01-preview October 30, 2026 January 30, 2027
2022-03-08-privatepreview October 30, 2026 January 30, 2027
2022-03-08-preview October 30, 2026 January 30, 2027
2022-01-20-preview October 30, 2026 January 30, 2027
2021-06-15-privatepreview October 30, 2026 January 30, 2027
2021-06-01-preview October 30, 2026 January 30, 2027
2021-04-10-privatepreview October 30, 2026 January 30, 2027
2021-03-31-privatepreview October 30, 2026 January 30, 2027
2020-11-05-preview October 30, 2026 January 30, 2027
2020-02-14-privatepreview October 30, 2026 January 30, 2027
2020-02-14-preview October 30, 2026 January 30, 2027
2020-01-01-privatepreview October 30, 2026 January 30, 2027
2020-01-01 October 30, 2026 January 30, 2027
2018-06-01-privatepreview October 30, 2026 January 30, 2027
2018-06-01-preview October 30, 2026 January 30, 2027
2018-06-01 October 30, 2026 January 30, 2027
2017-12-01-preview October 30, 2026 January 30, 2027
2017-12-01 October 30, 2026 January 30, 2027
  • Last updated on