Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

API / schema versioning strategy for Microsoft.Sql resource provider #1486

Closed
MWL88 opened this issue Jan 31, 2021 · 4 comments
Closed

API / schema versioning strategy for Microsoft.Sql resource provider #1486

MWL88 opened this issue Jan 31, 2021 · 4 comments

Comments

@MWL88
Copy link

MWL88 commented Jan 31, 2021

The Azure REST API Guidelines describe the use of preview APIs and states preview APIs are not subject to the same stability or lifecycle guarantees as generally available APIs. Additionally the guidelines state preview APIs should be retired within 12 months.

When deploying SQL resources via ARM tempalte from the Microsoft.Sql resource provider, the most recent stable API version is 2015-05-01 (almost 6 years ago) and all subsequent API versions have been marked as preview.

What strategy is the Microsoft.Sql resource provider team taking when versioning their API / schema?
Is there any documentation describing how customers should interpret the Microsoft.Sql API versions to identify stable and preview APIs?

@ghost
Copy link

ghost commented Feb 4, 2021

Hello @azureSQLGitHub! It looks like there is a schemas issue that needs your attention. Please investigate and confirm it is on your end. Thanks 😄

Issue Details

The Azure REST API Guidelines describe the use of preview APIs and states preview APIs are not subject to the same stability or lifecycle guarantees as generally available APIs. Additionally the guidelines state preview APIs should be retired within 12 months.

When deploying SQL resources via ARM tempalte from the Microsoft.Sql resource provider, the most recent stable API version is 2015-05-01 (almost 6 years ago) and all subsequent API versions have been marked as preview.

What strategy is the Microsoft.Sql resource provider team taking when versioning their API / schema?
Is there any documentation describing how customers should interpret the Microsoft.Sql API versions to identify stable and preview APIs?

Author: MWL88
Assignees: -
Labels:

Needs: Triage :mag_right:, RP:SQL

Milestone: -

@azcloudfarmer
Copy link
Collaborator

Hi @MWL88 this is an RP specific issue relating to their process of releasing preview api versions. We will discuss internally with the SQL team to see what can be done here.

@metaxasa
Copy link

metaxasa commented Oct 6, 2021

Hi @apclouds - is there anything you can share about the outcome of those discussions? Alternatively, should we be raising an issue elsewhere in order to get this resolved? Thanks!

@metaxasa
Copy link

metaxasa commented Oct 6, 2021

Looks like there's at least two other RPs in a similar situation:

Authorizations
Stream Analytics

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

No branches or pull requests

3 participants