[TSP Migration][certificateregistration] TypeSpec migrated from swagger #36635

Kevin-Zhong19 · 2025-08-13T02:12:50Z

This PR migrates your latest version (identified by the tag in your readme.md) of swagger to TypeSpec. We already tried our best to make sure the TypeSpec represents same as previous swagger. Since we lack the business knowledge, please validate this PR again to make sure it's functional equivalent as before. The local validation step is at Getting started | TypeSpec Azure

Besides, TypeSpec encourages to follow ARM guidelines. Therefore, some representations in your previous swagger will be fixed to follow these guidelines. When you see differences in your local validation, please keep this note in mind.

Please reach out to TypeSpec Discussions Channel if there is any help needed.

openapi-pipeline-app · 2025-08-13T02:12:54Z

Next Steps to Merge

Next steps that must be taken to merge this PR:

❌ This PR targets either the main branch of the public specs repo or the RPSaaSMaster branch of the private specs repo. These branches are not intended for iterative development. Therefore, you must acknowledge you understand that after this PR is merged, the APIs are considered shipped to Azure customers. Any further attempts at in-place modifications to the APIs will be subject to Azure's versioning and breaking change policies. Additionally, for control plane APIs, you must acknowledge that you are following all the best practices documented by ARM at aka.ms/armapibestpractices. If you do intend to release the APIs to your customers by merging this PR, add the PublishToCustomers label to your PR in acknowledgement of the above. Otherwise, retarget this PR onto a feature branch, i.e. with prefix release- (see aka.ms/azsdk/api-versions#release--branches).
❌ This PR has at least one change violating Azure versioning policy (label: VersioningReviewRequired).
To unblock this PR, either a) introduce a new API version with these changes instead of modifying an existing API version, or b) follow the process at aka.ms/brch.
❌ The required check named TypeSpec Validation has failed. Refer to the check in the PR's 'Checks' tab for details on how to fix it and consult the aka.ms/ci-fix guide

openapi-pipeline-app · 2025-08-13T02:12:54Z

PR validation pipeline restarted successfully. If there is ApiView generated, it will be updated in this comment.

github-actions · 2025-08-13T02:17:06Z

API Change Check

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

Language	API Review for Package
TypeSpec	Microsoft.CertificateRegistration
Swagger	Microsoft.CertificateRegistration-CertificateRegistration
Go	sdk/resourcemanager/certificateregistration/armcertificateregistration
Java	com.azure.resourcemanager:azure-resourcemanager-certificateregistration
JavaScript	@azure/arm-certificateregistration
Python	azure-mgmt-certificateregistration

Kevin-Zhong19 · 2025-08-13T04:26:00Z

@microsoft-github-policy-service agree company="Microsoft"

github-actions · 2025-08-15T01:45:06Z

Next Steps to Merge

Next steps that must be taken to merge this PR:

❌ This PR is in purview of the ARM review (label: ARMReview). This PR must get ARMSignedOff label from an ARM reviewer.
This PR is not ready for ARM review (label: NotReadyForARMReview). This PR will not be reviewed by ARM until relevant problems are fixed. Consult the rest of this Next Steps to Merge comment for details.
Once the blocking problems are addressed, add to the PR a comment with contents /azp run. Automation will re-evaluate this PR and if everything looks good, it will add WaitForARMFeedback label which will put this PR on the ARM review queue.
For details of the ARM review, see aka.ms/azsdk/pr-arm-review
❌ This PR is NotReadyForARMReview because it has the BreakingChangeReviewRequired label.
❌ This PR has at least one breaking change (label: BreakingChangeReviewRequired).
To unblock this PR, follow the process at aka.ms/brch.

Important checks have failed. As of today they are not blocking this PR, but in near future they may.
Addressing the following failures is highly recommended:

⚠️ The check named Swagger BreakingChange has failed. To unblock this PR, follow the process at aka.ms/brch.

Comment generated by summarize-checks workflow run.

…Kevin-Zhong19/azure-rest-api-specs into convert/CertificateRegistration

pshao25 · 2025-11-04T03:20:16Z

...on/certificateregistration/CertificateRegistration.Management/AppServiceCertificateOrder.tsp

+/**
+ * SSL certificate purchase order.
+ */
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"


put in the right place

pshao25 · 2025-11-04T03:21:05Z

specification/certificateregistration/CertificateRegistration.Management/back-compatible.tsp

+@@summary(AppServiceCertificateOrders.createOrUpdate,
+  "Create or update a certificate purchase order."
+);
+@@summary(AppServiceCertificateOrders.delete,


put in the right place

…Kevin-Zhong19/azure-rest-api-specs into pr/36635

v-jiaodi · 2025-12-05T08:58:16Z

specification/certificateregistration/CertificateRegistration.Management/back-compatible.tsp

+@@flattenProperty(RenewCertificateOrderRequest.properties);
+
+#suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+@@flattenProperty(SiteSeal.html);


@MaryGao for js, @@flattenProperty will cause html to be lost.

breaking change: Interface SiteSeal no longer has parameter html

issue track: Azure/autorest.typescript#3631

Kevin-Zhong19 added 3 commits August 11, 2025 10:48

first commit convert file

cec192b

fix error and push first version of json

2d12d29

fix some diff by diff tool

e19ce94

microsoft-github-policy-service bot added the Web Apps label Aug 13, 2025

github-actions bot added the VersioningReviewRequired <valid label in PR review process>add this label when versioning review is required label Aug 13, 2025

AzureRestAPISpecReview added resource-manager TypeSpec Authored with TypeSpec labels Aug 13, 2025

github-actions bot added the BreakingChange-JavaScript-Sdk label Aug 13, 2025

fix diff by comparing single json file

35d65ca

github-actions bot added the brownfield Brownfield services will soon be required to convert to TypeSpec. See https://aka.ms/azsdk/typespec. label Aug 13, 2025

update tspconfig.yml

7473b19

Kevin-Zhong19 added 3 commits August 18, 2025 12:39

solved warning

6292319

delete output folder

ed9f403

delete origin file

5e64f44

Kevin-Zhong19 and others added 7 commits August 19, 2025 10:54

run prettierCheck

8ec5d5d

run prettierCheck

89fe3c9

Merge branch 'main' into convert/CertificateRegistration

99ca604

update readme input-file

2c9e815

Merge remote-tracking branch 'upstream/main' into pr/36635

5965d0e

update tspconfig.yaml

c1eb3c8

Merge branch 'convert/CertificateRegistration' of https://github.com/…

427fa90

…Kevin-Zhong19/azure-rest-api-specs into convert/CertificateRegistration

Kevin-Zhong19 added 7 commits October 29, 2025 14:30

check tsmv

00d8457

solve tsmv error

a42f210

update des

7da12c4

update

f6adc01

format changes

ddd0e90

update

9442c4c

update

db3356c

pshao25 reviewed Nov 4, 2025

View reviewed changes

Kevin-Zhong19 added 4 commits November 4, 2025 14:03

update

199b7df

update identifiers

34e66e7

delete resource

5194eb2

update

48a0203

pshao25 added the typespec-conversion-w4 label Nov 6, 2025

pshao25 marked this pull request as ready for review November 6, 2025 03:41

github-actions bot added ARMReview NotReadyForARMReview labels Nov 6, 2025

fix error

6539401

tadelesh mentioned this pull request Nov 6, 2025

[EPIC] Validation for ARM packages migrating to TypeSpec Azure/autorest.go#1643

Open

11 tasks

pshao25 changed the title ~~[TSP Migration][certificate registration] TypeSpec migrated from swagger~~ [TSP Migration][certificateregistration] TypeSpec migrated from swagger Nov 11, 2025

weidongxu-microsoft mentioned this pull request Nov 13, 2025

[EPIC] Validation for for Swagger spec migration to TypeSpec Azure/autorest.java#3160

Open

9 tasks

msyyc mentioned this pull request Nov 14, 2025

[Mgmt][Epic] Validation for Python Mgmt SDK generated from typespec which is converted from swagger Azure/azure-sdk-for-python#41026

Open

71 tasks

v-jiaodi and others added 5 commits November 19, 2025 14:25

Merge branch 'main' into convert/CertificateRegistration

7ee2fd9

Merge branch 'main' into convert/CertificateRegistration

1545740

Merge branch 'main' into convert/CertificateRegistration

d101303

update client name

0a42b90

Merge branch 'convert/CertificateRegistration' of https://github.com/…

e21b3ba

…Kevin-Zhong19/azure-rest-api-specs into pr/36635

v-jiaodi reviewed Dec 5, 2025

View reviewed changes

v-jiaodi and others added 2 commits December 8, 2025 11:43

Update flattenProperty usage for SiteSeal.html

e971ec8

Update client.tsp

ecd705d

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[TSP Migration][certificateregistration] TypeSpec migrated from swagger #36635

[TSP Migration][certificateregistration] TypeSpec migrated from swagger #36635

Uh oh!

Kevin-Zhong19 commented Aug 13, 2025 •

edited

Loading

Uh oh!

openapi-pipeline-app bot commented Aug 13, 2025 •

edited

Loading

Uh oh!

openapi-pipeline-app bot commented Aug 13, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Aug 13, 2025 •

edited

Loading

Uh oh!

Kevin-Zhong19 commented Aug 13, 2025

Uh oh!

github-actions bot commented Aug 15, 2025 •

edited

Loading

Uh oh!

pshao25 Nov 4, 2025

Uh oh!

Kevin-Zhong19 Nov 4, 2025

Uh oh!

pshao25 Nov 4, 2025

Uh oh!

Kevin-Zhong19 Nov 4, 2025

Uh oh!

v-jiaodi Dec 5, 2025 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

[TSP Migration][certificateregistration] TypeSpec migrated from swagger #36635

Are you sure you want to change the base?

[TSP Migration][certificateregistration] TypeSpec migrated from swagger #36635

Uh oh!

Conversation

Kevin-Zhong19 commented Aug 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openapi-pipeline-app bot commented Aug 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Next Steps to Merge

Uh oh!

openapi-pipeline-app bot commented Aug 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Aug 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Change Check

Uh oh!

Kevin-Zhong19 commented Aug 13, 2025

Uh oh!

github-actions bot commented Aug 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Next Steps to Merge

Uh oh!

pshao25 Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

Kevin-Zhong19 Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

pshao25 Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

Kevin-Zhong19 Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

v-jiaodi Dec 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Kevin-Zhong19 commented Aug 13, 2025 •

edited

Loading

openapi-pipeline-app bot commented Aug 13, 2025 •

edited

Loading

openapi-pipeline-app bot commented Aug 13, 2025 •

edited

Loading

github-actions bot commented Aug 13, 2025 •

edited

Loading

github-actions bot commented Aug 15, 2025 •

edited

Loading

v-jiaodi Dec 5, 2025 •

edited

Loading