Skip to content

Add PostgreSQL@2025-01-01-preview#4931

Closed
QixiaLu wants to merge 1 commit intohashicorp:mainfrom
QixiaLu:pg-17-support
Closed

Add PostgreSQL@2025-01-01-preview#4931
QixiaLu wants to merge 1 commit intohashicorp:mainfrom
QixiaLu:pg-17-support

Conversation

@QixiaLu
Copy link
Contributor

@QixiaLu QixiaLu commented Aug 28, 2025

2025-01-01-preview API specs: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/postgresql/resource-manager/Microsoft.DBforPostgreSQL/preview/2025-01-01-preview

There's a strong feature request for PostgreSQL 17 from the community. However, the latest stable API version is still work in progress which contains lots of breaking changes, and the release has been delayed for several times.

As an interim, to unblock us, we'll use 2025-01-01-preview to support v17. The service team has confirmed that if we migrate completely from the stable API to the preview one, all existing features will continue to function as expected. And the Preview API will provide production-level quality. I have already done local tests to make sure there's no breaking change.

@hashicorp-cla-app
Copy link

hashicorp-cla-app bot commented Aug 28, 2025

CLA assistant check
All committers have signed the CLA.

@hashicorp-cla-app
Copy link

CLA assistant check

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

Have you signed the CLA already but the status is still pending? Recheck it.

@QixiaLu QixiaLu changed the title Add PostgreSQL 2025-01-01-preview version Add PostgreSQL@2025-01-01-preview Aug 28, 2025
Copy link
Contributor

@sreallymatt sreallymatt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @QixiaLu, adding and using a preview version for an enum addition is not something we want to do.

We also have some concerns with what you mentioned in the description:

However, the latest stable API version is still work in progress which contains lots of breaking changes

Presumably the new stable API is being based on the work done for the preview API, which would indicate the preview may contain similar breaking changes?

We've tested and confirmed that the stable API currently used does accept 17 as input for the version, and this is being added manually (as an exception, not something we want to do frequently) in hashicorp/terraform-provider-azurerm#30683

Based on this, I'm going to close out this PR.

@QixiaLu
Copy link
Contributor Author

QixiaLu commented Sep 24, 2025

Hi @sreallymatt , thank you so much for reviewing it and finding the alternative solution!

It would be the best if the current stable version supports v17 provision. We are also on the same page with you that it's a bit anti-commonsense to switch preview API for a single enum value change. That's why there are lots of back-and-forth confirmations with the service team internally to make sure it's intentional and no breaking change is introduced. I'll double check with the service team if there's any concern with this approach.

To clarify this sentence, the latest stable API is based on 2025-06-01-preview, not 2025-01-01-preview (https://github.com/Azure/azure-rest-api-specs/pull/36219/commits)

However, the latest stable API version is still work in progress which contains lots of breaking changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants