Skip to content

Support: add new stable API version 2027-07-01#44079

Open
padminib16 wants to merge 7 commits into
Azure:mainfrom
padminib16:user/pbellamkonda/supportrp-2026-06-15
Open

Support: add new stable API version 2027-07-01#44079
padminib16 wants to merge 7 commits into
Azure:mainfrom
padminib16:user/pbellamkonda/supportrp-2026-06-15

Conversation

@padminib16

@padminib16 padminib16 commented Jun 18, 2026

Copy link
Copy Markdown

Introduces the 2026-07-01 stable API version for Microsoft.Support, including ProblemClassifications_ClassifyProblems. Follows the new-api-version pattern from PR #43591 (which introduced 2026-06-01):
Private PR: https://github.com/Azure/azure-rest-api-specs-pr/pull/29113

  • main.tsp: add 2026-07-01 to the Versions enum (armCommonTypesVersion v5)
  • examples/2026-07-01: copy of 2026-07-01 examples with api-version bumped
  • stable/2026-07-01/support.json: regenerated via tsp compile
  • readme.md: add package-2026-07-01 tag and set it as the default

Choose a PR Template

Switch to "Preview" on this description then select one of the choices below.

Click here to open a PR for a Data Plane API.

Click here to open a PR for a Control Plane (ARM) API.

Click here to open a PR for only SDK configuration.

Introduces the 2026-06-15 stable API version for Microsoft.Support,
including ProblemClassifications_ClassifyProblems. Follows the new-api-version
pattern from PR Azure#43591 (which introduced 2026-06-01):

- main.tsp: add v2026_06_15 to the Versions enum (armCommonTypesVersion v5)
- examples/2026-06-15: copy of 2026-06-01 examples with api-version bumped
- stable/2026-06-15/support.json: regenerated via tsp compile
- readme.md: add package-2026-06-15 tag and set it as the default

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown

Next Steps to Merge

✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge.

Comment generated by summarize-checks workflow run.

@github-actions github-actions Bot added ARMReview new-api-version resource-manager TypeSpec Authored with TypeSpec WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required ARMAutoSignedOff-IncrementalTSP ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review BreakingChange-Go-Sdk BreakingChange-JavaScript-Sdk and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Jun 18, 2026
@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown

API Change Check

APIView identified API level changes in this PR and created the following API reviews

Language API Review for Package
Swagger Microsoft.Support-Support
TypeSpec Microsoft.Support
Go sdk/resourcemanager/support/armsupport
JavaScript @azure/arm-support
C# Azure.ResourceManager.Support
Python azure-mgmt-support
Java com.azure.resourcemanager:azure-resourcemanager-support

Comment generated by After APIView workflow run.

padminib16 and others added 5 commits June 18, 2026 14:39
…-15)

Adds an optional, read-only string property 'articleId' to
ProblemClassificationsClassificationResult, gated with @added(Versions.v2026_06_15)
so it is the only API difference between 2026-06-15 and the prior 2026-06-01 version.

- models.tsp: add articleId?: string (@visibility Read, @added v2026_06_15)
- examples/2026-06-15: demonstrate articleId in both ClassifyProblems responses
- stable/2026-06-15/support.json (+ examples): regenerated via tsp compile

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Allow articleId to be explicitly null in addition to being optional/empty,
per requirement. Adds x-nullable to the generated schema.

- models.tsp: articleId?: string -> articleId?: string | null, with a
  #suppress for @azure-tools/typespec-azure-core/no-nullable and justification
- stable/2026-06-15/support.json: regenerated (articleId now x-nullable: true)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Note that articleId is only populated when Alchemy responds.

- models.tsp: extend articleId doc comment
- stable/2026-06-15/support.json: regenerated description

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace internal service reference with customer-observable behavior:
articleId is populated only when a related article is available.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Renames the in-progress stable API version from 2026-06-15 to 2026-07-01
across all references:

- main.tsp: Versions enum member v2026_06_15 -> v2026_07_01 (value "2026-07-01")
- models.tsp: articleId @added(Versions.v2026_07_01)
- readme.md: package-2026-07-01 tag (default) + input-file path
- examples/2026-07-01: renamed from examples/2026-06-15, api-version bumped
- stable/2026-07-01/support.json (+ examples): regenerated via tsp compile

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@padminib16 padminib16 changed the title Support: add new stable API version 2026-06-15 Support: add new stable API version 2027-07-01 Jun 19, 2026
@github-actions github-actions Bot added WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required ARMAutoSignedOff-IncrementalTSP ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review and removed ARMAutoSignedOff-IncrementalTSP ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Jun 19, 2026
Per ARM API best practices (and @azure-tools/typespec-azure-core/no-nullable),
the service omits articleId when no article is available rather than returning
an explicit null, so the property no longer needs to be nullable.

- models.tsp: articleId?: string | null -> articleId?: string; remove the
  no-nullable suppression; update description (omitted instead of null/omitted)
- stable/2026-07-01/support.json: regenerated (x-nullable removed)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@padminib16 padminib16 added the PublishToCustomers Acknowledgement the changes will be published to Azure customers. label Jun 22, 2026
@padminib16

Copy link
Copy Markdown
Author

/azp run

@azure-pipelines

Copy link
Copy Markdown
You have several pipelines (over 10) configured to build pull requests in this repository. Specify which pipelines you would like to run by using /azp run [pipelines] command. You can specify multiple pipelines using a comma separated list.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants