Skip to content

Conversation

FumingZhang
Copy link
Member

ARM (Control Plane) API Specification Update Pull Request

Tip

Overwhelmed by all this guidance? See the Getting help section at the bottom of this PR description.

PR review workflow diagram

Please understand this diagram before proceeding. It explains how to get your PR approved & merged.

spec_pr_review_workflow_diagram

Purpose of this PR

What's the purpose of this PR? Check the specific option that applies. This is mandatory!

  • New resource provider.
  • New API version for an existing resource provider. (If API spec is not defined in TypeSpec, the PR should have been created in adherence to OpenAPI specs PR creation guidance).
  • Update existing version for a new feature. (This is applicable only when you are revising a private preview API version.)
  • Update existing version to fix OpenAPI spec quality issues in S360.
  • Convert existing OpenAPI spec to TypeSpec spec (do not combine this with implementing changes for a new API version).
  • Other, please clarify:
    • edit this with your clarification

Due diligence checklist

To merge this PR, you must go through the following checklist and confirm you understood
and followed the instructions by checking all the boxes:

  • I confirm this PR is modifying Azure Resource Manager (ARM) related specifications, and not data plane related specifications.
  • I have reviewed following Resource Provider guidelines, including
    ARM resource provider contract and
    REST guidelines (estimated time: 4 hours).
    I understand this is required before I can proceed to the diagram Step 2, "ARM API changes review", for this PR.
  • A release plan has been created. If not, please create one as it will help guide you through the REST API and SDK creation process.

Additional information

Viewing API changes

For convenient view of the API changes made by this PR, refer to the URLs provided in the table
in the Generated ApiView comment added to this PR. You can use ApiView to show API versions diff.

Suppressing failures

If one or multiple validation error/warning suppression(s) is detected in your PR, please follow the
suppressions guide to get approval.

Getting help

  • First, please carefully read through this PR description, from top to bottom. Please fill out the Purpose of this PR and Due diligence checklist.
  • If you don't have permissions to remove or add labels to the PR, request write access per aka.ms/azsdk/access#request-access-to-rest-api-or-sdk-repositories
  • To understand what you must do next to merge this PR, see the Next Steps to Merge comment. It will appear within few minutes of submitting this PR and will continue to be up-to-date with current PR state.
  • For guidance on fixing this PR CI check failures, see the hyperlinks provided in given failure
    and https://aka.ms/ci-fix.
  • For help with ARM review (PR workflow diagram Step 2), see https://aka.ms/azsdk/pr-arm-review.
  • If the PR CI checks appear to be stuck in queued state, please add a comment with contents /azp run.
    This should result in a new comment denoting a PR validation pipeline has started and the checks should be updated after few minutes.
  • If the help provided by the previous points is not enough, post to https://aka.ms/azsdk/support/specreview-channel and link to this PR.
  • For guidance on SDK breaking change review, refer to https://aka.ms/ci-fix.

Copy link

openapi-pipeline-app bot commented Jul 3, 2025

Next Steps to Merge

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

Copy link

openapi-pipeline-app bot commented Jul 3, 2025

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

@FumingZhang FumingZhang marked this pull request as ready for review July 3, 2025 14:11
@github-actions github-actions bot added the brownfield Brownfield services will soon be required to convert to TypeSpec. See https://aka.ms/azsdk/typespec. label Jul 3, 2025
Copy link

github-actions bot commented Jul 3, 2025

API Change Check

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

Language API Review for Package
Swagger Microsoft.ContainerService-aks
Go sdk/resourcemanager/containerservice/armcontainerservice
JavaScript @azure/arm-containerservice
Java com.azure.resourcemanager:azure-resourcemanager-containerserviceaks-generated

@FumingZhang
Copy link
Member Author

/azp run

Copy link

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.

bcho added 2 commits July 22, 2025 15:40
…ainerService/aks/preview/2025-06-02-preview/managedClusters.json
…ainerService/aks/preview/2025-06-02-preview/managedClusters.json
@FumingZhang FumingZhang force-pushed the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch from 8fd319c to faca549 Compare July 22, 2025 05:40
@FumingZhang
Copy link
Member Author

/azp run

Copy link

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.

@tadelesh
Copy link
Member

/azp run SDK Validation - Go

Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@FumingZhang FumingZhang added the PublishToCustomers Acknowledgement the changes will be published to Azure customers. label Jul 28, 2025
@FumingZhang FumingZhang enabled auto-merge (squash) July 28, 2025 04:41
@FumingZhang FumingZhang merged commit 2461457 into main Jul 28, 2025
170 of 172 checks passed
@FumingZhang FumingZhang deleted the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch July 28, 2025 16:19
@FumingZhang FumingZhang restored the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch July 31, 2025 01:00
@FumingZhang FumingZhang deleted the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch July 31, 2025 01:48
fmabroukmsft pushed a commit that referenced this pull request Aug 14, 2025
* [watch] Add actions:read to watch workflows (#36163)

* [watch] add statuses:read permission (#36166)

* [Language] Remove old preview API versions (#31781)

* [Language] Remove old preview API versions

* Remove 2023-04-15-preview from authoring

* update the api version

* tsv compile

---------

Co-authored-by: Bidisha Chakraborty <bidishac@microsoft.com>

* Migrate API Doc Preview (#35018)

* Add package.json

* Enable eng/tools in JS

* First cut at direct port

* Wire up command, move some functions into changed-files.js

* Move, pipeline, refactor

* Trivial test change to a spec file

* Usage, logging, add pathExists to changed-files.js, types in doc-preview.js, coverage for doc-preview.js

* Prettier

* SkipCheckoutNone

* Git token auth

* --

* ../

* Pool

* fetchDepth: 2

* Get-ChildItem

* More logging

* Directory

* BaseRepoOwner

* Cleanup

* 02

* Comment

* Test a change that should break the docs build

* Queue docs build

* 02

* Tab

* Add wait and result output

* Log files

* Direct invocation with valid path

* Output buildstart.json

* Fixes

* Remove BOM

* PR Number

* Test changes that won't break the build

* encodeURIComponent

* -pwsh

* Revert BatchService.json testing

* Test from another PR

* Test timeouts

* Test timeout in script

* >

* Remove test exception

* Show token scope

* Set status on PR

* git rev-parse HEAD

* SourceCommitId

* -Azure/

* Set check state in DevOps pipeline

* set-pr-check.yml

* -description

* Can't enforce values for macro (defined at runtime) syntax at template expansion time

* .mjs -> .js

* .js, other documentation

* vso

* displayName

* Add package.json to eng/scripts, wire up to github-test.yaml (might need a rename)

* sparse checkout eng/scripts

* eng/scripts/package-lock.json

* package.json

* npm i

* prettier -> format

* package-lock.json

* --output

* Path

* Revert test changes in specification/

* Revert "Test from another PR"

This reverts commit 04aeecce042d8de6df064596339aa8e57687d534.

* Architecture feedback

* Paths

* Docs preview

* pscore

* `

* copy

* $buildStart

* Test: timeout

* (

* Remove test timeout

* Test orchestration build failure

* Revert contrived orchestration failure

* Contrive a docs build failure

* Test success case

* Revert spec change

* Add support for filtering quickstart templates

* Use aka.ms link for docs support teams channel

* Sparse checkout might work but that can be investigated elsewhere

* Improve param validation

* Test api-doc-preview param validation in practice

* Revert github-test.yaml

* Revert .gitignore

* Remove unnecessary files

* More status update messages

* Revert "Test api-doc-preview param validation in practice"

This reverts commit 929d33c7d4ad66a1864d65c3c42d83b6e19aebf4.

* Fix package.json/package-lock.json

* package-lock.json

* npm i

* Format

* Apply suggestions from code review

Co-authored-by: Mike Harder <mharder@microsoft.com>

* inline, fix ts-check errors

* Use getChangedFilesStatuses to exclude deleted files instead of querying the filesystem directly

* Comments

* Named typedefs, more exceptions, expand "key" to a couple variables

* Adjust PR triggers

* Remove fs/promises/access

* Add WorkingDirectory to npm-install.yml, use shebang invocation

* Remove infinite loop condition

* pathExists

* .js

* (

* Only run docs build if there are changes to push

* DisplayName

* Final TODOs

* Format

* Update eng/pipelines/swagger-api-doc-preview.yml

Co-authored-by: Mike Harder <mharder@microsoft.com>

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* [.github] Add typescript-eslint (#36181)

* [chore] npm update (#36182)

* Azure Maps Weather Service: ordered the enum tables how they should appear in the docs. (#35646)

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* minor updates

* removed blank line.

* Removed word 'inhalable'

---------

Co-authored-by: Faraz Siddiqui <124096851+FarazGIS@users.noreply.github.com>

* Update `summarize-checks` output - add graceful exit (#36186)

* format, update output

* Ensure typespec project is valid before generating typespec apiview (#36183)

* [Monitor Metrics Query] Update TypeSpec Python config (#36052)

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>

* Add Microsoft.Mission spec to public repo (#32359)

* Moving specs from private to public

The files are the same as the one in https://github.com/Azure/azure-rest-api-specs-pr/pull/20074/files#diff-4764111bf455581c775da5c4711ccd11e820292fc9c84957532fc5d278b3ea2d

* Added missing files

* Add only version 2024-01-01 preview

* Remove old versions

* add back the old versions

* Removing old versions

* Added older version of the API

* Added older version of API to Readme

* Update version.tsp

* remove 2022 versions

* Delete versions prior 2024-06-01-preview

* remove status 200 of delete operations

* remove status 200 from openapi.json

* remove status 200 from example files

* remove status 200 from EnclaveEndpoints_Delete.json

* remove the status 200 when compiling

* change ArmResourcePatchAsync to ArnCustomPatch

* compile file with ArmCustomPatch

* rollback to ArmResourcePatch

* added version 2024-12-01

* remove status 200 from ver 2024-12-01

* change ARMResourcePatch for ARMResourcePatch

* add @parameterVisibility to all ocurrences of ArmCustomPatchAsync

* minor fix on ArmCustomPatchAsync

* compile the model

* added location to Community Update

* location to community_update

* Update Community_Update.json

* added location to CommunityEndpoints

* Added location on all update example files

* added location to virtualEnclave_update

* made rulecollection optional

* change propertires to optional

* change properties to optional

* Added suppression

* add suppression

* rollback suppressions

* made properties optional

* update openapi file

* Update for tsp update

* Update formatting

* Use latest version v6 of types.json

* Use latest version v6 of types.json

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Revert location addition in examples

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Fix location in examples.

* Update patch model. Fix location in examples.

* Format update

* Format update. Use Azure.Core.azureLocation for location def in mrg

* Fix visibility for mrg location

* Remove 2024_10 and 2024_11

* Remove 2024_10 and 2024_11 examples

* Remove 2024_10 and 2024_11 from readme.md

* Remove 2024_10 and 2024_11 from resource-manager

* Use Update<T> instead of separately defining the patchable props

* Use Update<T> on patchResources

* Revert optional/required params to match ve-common and hope the Update<T> model handles it correctly.

* Re-Enable PATCH optionality.

* Add types for ARM resources

* Fix examples

* Add suppressions for AvoidAnonymousTypes

* Fix examples for type updates. Add uuid type to uuid fields.

* Fix examples for type updates.

* Remove uuid type

* Remove uuid type

* Prettier

* Prettier

* Update suppressions

* Move routes to routes.tsp

* Feedback from engineering -- remove Endpoint, InternalConnection, ExternalConnection models and interfaces. Update Community to include _ as part of name validation.

* Fix examples

* Remove examples for deprecated resources

* Remove examples for deprecated resources

* Remove examples for deprecated resources

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@users.noreply.github.com>

* [applicationinsights][python] Convert applicationinsights readme.python.md to singleapi package format (#36026)

* Initial plan

* Convert applicationinsights readme.python.md to singleapi package format

Co-authored-by: msyyc <70930885+msyyc@users.noreply.github.com>

* Update readme.java.md

* Update readme.java.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Weidong Xu <weidxu@microsoft.com>

* Sync eng/common directory with azure-sdk-tools for PR 11336 (#36190)

* Install .NET from tools repo global.json

* Set workingDirectory to tools root

* use exact same install steps as tools repo

* revert formatting

* formatting

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* Rename Recoveryservices.Management to RecoveryServices.Management (#36172)

All files and directories under specification/recoveryservices/Recoveryservices.Management were renamed to specification/recoveryservices/RecoveryServices.Management to standardize casing and improve consistency.

* Rename Powerbidedicated.Management to PowerBIDedicated.Management (#36169)

All files and folders under specification/powerbidedicated/Powerbidedicated.Management were renamed to specification/powerbidedicated/PowerBIDedicated.Management to correct casing and improve consistency.

* Rename NotificationHubs.Management directory and files (#36168)

Renamed 'Notificationhubs.Management' to 'NotificationHubs.Management' across all specification files and examples for consistency. Also updated the service name in tspconfig.yaml to 'NotificationHubs'.

Co-authored-by: Dapeng Zhang <dapzhang@microsoft.com>

* Fixed 2025-02-01-preview API by Reverting Linked Hub Changes and Added DeviceRegistry Namespace (#31635)

* update common model refs (#36114)

* java, mgmt, aks, fix readme (#36200)

* [Liftr-Confluent] Added enums for confluent cosmos connector and new property (#35982)

* Added properties for cosmos connectors

* Added properties for cosmos connectors

* Added property for cosmos sink container - write detailsnpx prettier --write **/*.json

---------

Co-authored-by: Mary Gao <yanmeigao1210@gmail.com>
Co-authored-by: Srinivas <alluri02@users.noreply.github.com>

* New API version for Microsoft.ServiceBus (#35860)

* base pr

* New api version added

* New updates in api version

* Example file modified

* MinTLS 1.3 added'

* Examples added'

* Updates

* updates

* updates

* updates linters

* updates linters again

* removing linter - suppress: GetCollectionOnlyHasValueAndNextLink

* removing linter - suppressions

* ANother linter fixed

* ANother linter fixed

* ANother linter fixed examples

* ANother linter fixed

* ANother linter fixed

* ANother linter fixed

* ANother linter fixed

* More updates

* More updates

* updates again

* updates again

* revert previous commit

* updates again

* updates again

---------

Co-authored-by: Your Name <you@example.com>

* Adding new public preview version 2025-05-03-preview for Microsoft.Monitor/Accounts (#35968)

* Adding new public preview version 2025-05-03-preview for Microsoft.Monitor/accounts

---------

Co-authored-by: GokulPrasad KrishnaSwamy (from Dev Box) <gokulpk@microsoft.com>

* Create Face API v1.3 preview.1 Version (#34429)

Adding new face liveness features, including new abuse detection features.

* Dev sentinel securityinsights microsoft.security insights 2025 07 01 preview (#35645)

* Copy files from preview/2025-04-01-preview

Copied the files in a separate commit.
This allows reviewers to easily diff subsequent changes against the previous spec.

* Update version to preview/2025-07-01-preview

Updated the API version from preview/2025-04-01-preview to preview/2025-07-01-preview.

* Added tag for 2025-07-01-preview in readme file

* fix the readme error generated by the tool

* Dev sentinel securityinsights microsoft.security insights 2025 07 01 preview (#35606)

* Add workload Identity Federation in the response

* add suppressions for known issue

* update the example (#35805)

* Sync eng/common directory with azure-sdk-tools for PR 11333 (#36210)

* Install azsdk cli to a place in PATH

* Only add to path if user manually approves via parameter

* Also update shell profile for linux

---------

Co-authored-by: Ben Broderick Phillips <bebroder@microsoft.com>

* Install azsdk mcp server in copilot setup steps (#36211)

* Review request for Microsoft.DBforPostgreSQL to add version preview/2025-06-01-preview (#35537)

* initial commit

* add tuning index and database changes

* remove tuning options change

* changes for default db name

* add current state for index tuning

* changed instance of tuning index name to tuning options

* update example reference from tuning index to tuning options

* change MVU and capability API to use PG17

* change examples to use PG17

* run prettier

* fix prettier

* address model validation

* revert cluster create example to use PG 16

* change the naming from IndexRecommendation* -> ObjectRecommendation*

* Auto update CMK key version

* change in the descriptions for the APIs in administrators, backups, capabilities, checknameavailability, configuration

* update operation IDs for flexible server API to reflect create/update and list by subscription

* refactor: update administrator examples and rename files for consistency

* feat: add backups management API with create, delete, get, and list functionalities

* Refactor code structure for improved readability and maintainability

* refactor: remove deprecated CheckNameAvailability API and examples

* Add example for updating PostgreSQL configuration 'constraint_exclusion'

- Introduced a new JSON example for the 'ConfigurationsUpdate' operation in the PostgreSQL resource manager.
- The example demonstrates how to update the 'constraint_exclusion' configuration with a user-defined value.
- Included detailed response structures for successful and asynchronous operations.

* feat: update database examples and restructure for consistency

* feat: add examples for firewall rules create, delete, get, and list operations

* Update PostgreSQL examples to reflect new dates for restore and creation times

- Changed earliestRestoreDate and createdAt timestamps from "2025-01-01" to "2025-06-01" in multiple JSON example files.
- Updated pointInTimeUTC for various server creation and restoration examples to "2025-06-01".
- Adjusted initialRecommendedTime and lastRecommendedTime in tuning options examples to "2025-06-01".
- Modified startTime in virtual endpoint operations to "2025-06-01".

* Add examples for PostgreSQL server management operations

- Introduced examples for promoting replicas as planned standalone and switchover.
- Added examples for restarting servers, including with failover options.
- Included examples for starting and stopping servers.
- Created examples for updating servers with various configurations, including custom maintenance windows, data encryption, major version upgrades, and Microsoft Entra integration.

* Add migration examples for PostgreSQL resource manager

- Introduced new examples for creating migrations with various configurations:
  - MigrationsCreateWithOtherUsers.json
  - MigrationsCreateWithPrivateEndpointServers.json
  - MigrationsCreateWithRoles.json
- Added examples for migration operations:
  - MigrationsDelete.json
  - MigrationsGet.json
  - MigrationsGetMigrationWithSuccessfulValidationAndMigration.json
  - MigrationsGetMigrationWithSuccessfulValidationButMigrationFailure.json
  - MigrationsGetMigrationWithSuccessfulValidationOnly.json
  - MigrationsGetMigrationWithValidationFailures.json
  - MigrationsListByTargetServer.json
  - MigrationsUpdate.json

* Remove deprecated Long Term Retention backup examples and add new API specifications for Backups Long Term Retention operations.

* refactor: update PostgreSQL API specifications and examples for private endpoint connections

* refactor: standardize response descriptions across PostgreSQL API specifications

* Remove deprecated example JSON files and add new API specifications for PostgreSQL management, including captured logs and virtual network subnet usage. Update tuning options examples to reflect the latest API version and structure.

* fix: update firewall rule name pattern to enforce valid naming conventions

* feat: add new API specifications and examples for PostgreSQL administrators with Microsoft Entra integration

* fix: update nextLink properties to use 'format: uri' for consistency across PostgreSQL API specifications

* feat: add Advanced Threat Protection settings API specifications and examples for PostgreSQL management

* fix: correct description casing for PrivateEndpoint and Database properties

* fix: correct typo in 'format' property for nextLink in AdvancedThreatProtectionSettings.json

* fix: update input files and suppressions for flexible server API specifications in readme.md

* Implement code changes to enhance functionality and improve performance

* fix: update example references in PrivateEndpointConnections and Servers JSON files; add VirtualNetworkSubnetUsageList example

* fix: correct indentation in examples for long term retention and tuning options

* Delete outdated example for creating PostgreSQL servers with Microsoft Entra enabled and update location references from 'westus' to 'eastus' in various examples. Add new examples for creating servers in Microsoft-owned and user-owned virtual networks with specific configurations, including high availability settings.

* fix: update reference for example in Servers.json to correct file path

* fix: update reference for example in Servers.json to correct file path

* fix: update response structure in AdministratorsMicrosoftEntraAdd.json to reflect correct status codes and headers

* fix: update example references and tags for server operations in Servers.json

* fix: update response structure in AdministratorsMicrosoftEntraDelete.json to reflect correct status codes and headers

* fix: update example references in Servers.json to correct file paths for start and stop operations

* Refactor PostgreSQL examples to update async operation URLs and remove unnecessary response bodies

- Updated async operation URLs in ServersUpdateWithMicrosoftEntraEnabled.json, VirtualEndpointCreate.json, VirtualEndpointDelete.json, and VirtualEndpointUpdate.json to reflect the correct region and operation IDs.
- Removed redundant response bodies for 200 and 201 status codes in VirtualEndpointCreate.json and VirtualEndpointUpdate.json.
- Cleaned up response structure in VirtualEndpointDelete.json by removing unnecessary content field.

* Refactor PostgreSQL examples for server promotion and tuning options

- Removed detailed response body for 200 status in examples of ServersPromoteReplicaAsForcedSwitchover, ServersPromoteReplicaAsPlannedStandaloneServer, and ServersPromoteReplicaAsPlannedSwitchover.
- Updated 202 status headers to use consistent "azure-asyncoperation" key and modified URLs for async operations.
- Added "kind" property to index recommendations in TuningOptionsListIndexRecommendations and TuningOptionsListIndexRecommendationsFilteredForCreateIndex examples.

* fix: remove redundant 200 response schema from VirtualEndpoints.json

* fix: update response headers and remove redundant response bodies in PrivateEndpointConnections examples

* fix: streamline response structure and enhance details in TuningOptionsListTableRecommendationsFilteredForAnalyzeTable example

* fix: update examples and descriptions to remove references to flexible servers

* Update Azure Async Operation headers in PostgreSQL examples for consistency and clarity

- Changed "azure-asyncoperation" to "Azure-AsyncOperation" in multiple JSON example files.
- Added "Location" header to responses in the following examples:
  - ServersUpdateWithMajorVersionUpgrade.json
  - ServersUpdateWithMicrosoftEntraEnabled.json
  - VirtualEndpointCreate.json
  - VirtualEndpointDelete.json
  - VirtualEndpointUpdate.json

* fix: enhance database name description for clarity and detail

* fix: add Azure-AsyncOperation header to multiple JSON specifications for consistency

* fix prettier

* fix: add response headers for Azure-AsyncOperation in backup API

* fix issue with the closing bracket

* fix: remove redundant response headers for 202 status in backups API

* fix: update location references from westus to eastus in migration examples and specifications

* fix: update migration examples and cancel operation details in PostgreSQL API

* fix: add example reference for updating existing migrations in PostgreSQL API

* fix: update administrator login examples to use 'exampleadministratorlogin' across multiple JSON files

* fix: add 204 No Content response description to multiple PostgreSQL API specifications

* fix: add 204 No Content response to multiple PostgreSQL API example files

* fix: update descriptions for CapabilityList, Migration, and Server to provide clarity

* fix: add 204 No Content response to PrivateEndpointConnectionsDelete example

* fix: rename CapabilityListResult and QuotaUsagesListResult to CapabilityList and QuotaUsageList for consistency

* fix: rename enums for clarity and consistency across PostgreSQL specifications

* fix: update descriptions in JSON files for consistency in quotation marks

* fix: update descriptions in Migrations.json for clarity and consistency

* fix: remove 'create' mutability from cluster properties in Servers.json

* fix: correct casing in MigrationSubStateDetails reference for consistency

* Refactor code structure for improved readability and maintainability

* fix: correct casing in MigrationSubstateDetails for consistency

* fix: correct casing in MigrationSubstate for consistency

* fix: update suppression reasons for consistency in PostgreSQL namespace

* fix: update suppression reasons for consistency in AdvancedThreatProtectionSettings and other JSON files

* fix: update suppression reasons for consistency in PostgreSQL API contracts

* fix: update suppression reasons and codes for consistency in PostgreSQL API contracts

* fix: add suppression reasons for PatchResponseCodes in PostgreSQL API contracts

* fix: add suppression for DeleteResponseBody in Migrations.json for API contract consistency

* fix: update suppression code for DeleteResponseBody in Migrations.json for API contract consistency

* fix: improve descriptions and add enum values for PostgreSQL API specifications

* fix: update migration references and example parameters for consistency in PostgreSQL API specifications

* fix: update NameAvailability references and add description for server properties in PostgreSQL API specifications

* fix: remove outdated NameAvailability example files and add new examples for PostgreSQL API specifications

* fix: update AdvancedThreatProtectionSettings references and rename examples for consistency in PostgreSQL API specifications

* fix: update parameters structure in NameAvailability examples for consistency in PostgreSQL API specifications

* fix: update VirtualNetworkSubnetUsage references for consistency in PostgreSQL API specifications

* fix: update OperationList reference and remove unused definitions in PostgreSQL API specifications

* fix: update parameter references and remove unused parameters in Migrations.json for PostgreSQL API specifications

* fix: update parameter references for consistency in PostgreSQL API specifications

* fix: update parameter references for consistency in Migrations.json for PostgreSQL API specifications

* fix: update targetDbServerName to serverName for consistency in PostgreSQL API specifications

* fix: update targetDbServerName to serverName for consistency in Migrations.json for PostgreSQL API specifications

* fix: add x-ms-pageable definition for pagination support in Operations.json

* fix: update minorVersion to 5 in multiple example JSON files for PostgreSQL API specifications

* fix: add detailed operation definitions and update reference in Operations.json for PostgreSQL API specifications

* fix: rename additionalProperties to extraProperties for clarity in JSON specifications

* fix: replace extraProperties with additionalProperties for consistency in JSON specifications

* fix: update operation and server definitions for consistency in API specifications

* fix: update references in Servers.json for patch operations and add new definitions for Backup, AuthConfig, and MaintenanceWindow

* fix: update HighAvailability reference and add HighAvailabilityForPatch definition in Servers.json

* fix: remove empty object definitions for 204 responses in JSON examples

* Rename folder

* Base commit

* To facilitate comparison

* fix: update reference to ServerList in Replicas.json to point to FlexibleServers.json

* Add VirtualNetworkSubnetUsage API definition for PostgreSQL management

- Introduced a new API definition for checking virtual network subnet usage in Azure Database for PostgreSQL.
- Added paths, parameters, and response models to support the functionality.
- Defined necessary request and response schemas, including VirtualNetworkSubnetUsageParameter and VirtualNetworkSubnetUsageModel.
- Included delegated subnet usage details in the response model.

* feat: add PUT operation for updating server configurations and example usage

* fix: update suppression codes in readme.md to align with existing API contract

* fix: update suppression code from PatchResponseCodes to PutResponseCodes in readme.md to align with existing API contract

---------

Co-authored-by: Matthew Boentoro <mboentoro@microsoft.com>
Co-authored-by: Nacho Alonso Portillo <41644064+nachoalonsoportillo@users.noreply.github.com>

* Sync eng/common directory with azure-sdk-tools for PR 11353 (#36215)

* Handle tool/directory copy better

* Use /usr/bin/env instead of /bin/env

* Append additional newline

---------

Co-authored-by: Ben Broderick Phillips <bebroder@microsoft.com>

* Fix non-customer-available create mode params (#36212)

* Add dump of triggering information to `summarize-checks` (#36209)

* [Monitor] Update python customization for logs query (#36144)

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>

* [LintDiff] More detailed error copy for spec model failures (#36216)

* Add more detail to exception

* Use SpecModelError

* Test with a change that includes an orpahend JSON

* format

* Remove extra line

* Less empty space

* Formatting

* Delete test

* Update .github/shared/src/spec-model.js

Co-authored-by: Mike Harder <mharder@microsoft.com>

* Cause a SpecModel error in LintDiff

* Formatting

* Remove test JSON

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* add stable tag (#36196)

* Update client.tsp for releasing Playwright .Net SDK (#36206)

* [workloadorchestration] update tsp config (#36061)

* Create client.tsp

* Update tspconfig.yaml

* Update tspconfig.yaml

* Update tspconfig.yaml

* update go config

* Update tspconfig.yaml

* Update tspconfig.yaml

* Update tspconfig.yaml

---------

Co-authored-by: kazrael2119 <98569699+kazrael2119@users.noreply.github.com>
Co-authored-by: ReleaseHelper <ReleaseHelper>
Co-authored-by: Weidong Xu <weidxu@microsoft.com>

* [Devex Agent] Ignore changes in .gitignore (#36142)

* Exclude changes in gitignore.

* rephrase

---------

Co-authored-by: Praven Kuttappan <55455725+praveenkuttappan@users.noreply.github.com>

* Review request for Microsoft.ContainerService/aks to add version preview/2025-06-02-preview (#35666)

* Adds base for updating Microsoft.ContainerService/aks from version preview/2025-05-02-preview to version preview/2025-06-02-preview

* Updates readme

* Updates API version in new specs and examples

* [AKS] Add KubernetesResourceObjectEncryptionProfile for KMS (2025-06-02-preview) (#35622)

* Added Changes for Managed Gateway API to 2025-06-02preview API (#35637)

* added changes

* format

* [AKS] Declare identity binding api models in 06-02-preview (#35640)

* feat: declare ib models

* fix: description updates

* feat: declare examples

* fix: format files

* fix: update api-version

* Windows2025 enum and docs. (#35648)

* fix default tag

* Update specification/containerservice/resource-manager/Microsoft.ContainerService/aks/preview/2025-06-02-preview/managedClusters.json

* Update specification/containerservice/resource-manager/Microsoft.ContainerService/aks/preview/2025-06-02-preview/managedClusters.json

---------

Co-authored-by: Bin Xia <binxi@microsoft.com>
Co-authored-by: Jaiveer Katariya <35347859+jaiveerk@users.noreply.github.com>
Co-authored-by: hbc <bahe@microsoft.com>
Co-authored-by: Christian Smith <1001494+smith1511@users.noreply.github.com>
Co-authored-by: hbc <bcxxxxxx@gmail.com>

* Made .net required for typespec case only (#36179)

* Made .net required for typespec case only

* Added wiki page to status page

* Checked if generation from typespec

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* fully qualfy legacy namespace (#36177)

Co-authored-by: iscai-msft <isabellavcai@gmail.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>

* Multiple `summarize` logic updates / fixes (#36246)

* multiple fixes and logic updates to  impact assessment and processing
* fix identified reversal of resource-manager label
* update tests to reflect new w reality

* Some pending fixes to breaking change checks (#36192)

* Made getVersionFromInputFile function async

* mysql spec test

* normalize path and use mapsAsyc from shared code

* Simplify test assertion

* revert mysql spec changes

* [oav-runner] Handle error if dir containing example is deleted (#36260)

- Fixes #36257

* [dependabot] Revert to listing all dirs and increase-if-necessary (#36262)

- Not perfect, but best option so far

* [dependabot.yml] ignore cross-env (#36264)

* Bump @types/glob from 8.1.0 to 9.0.0 in /eng/tools/summarize-impact (#36274)

* Bump @types/glob from 8.1.0 to 9.0.0 in /eng/tools/summarize-impact

Bumps [@types/glob](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/glob) from 8.1.0 to 9.0.0.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/glob)

---
updated-dependencies:
- dependency-name: "@types/glob"
  dependency-version: 9.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

* npm i

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>

* Bump commonmark from 0.29.3 to 0.31.2 in /eng/tools/summarize-impact (#36273)

* Bump commonmark from 0.29.3 to 0.31.2 in /eng/tools/summarize-impact

Bumps [commonmark](https://github.com/commonmark/commonmark.js) from 0.29.3 to 0.31.2.
- [Release notes](https://github.com/commonmark/commonmark.js/releases)
- [Changelog](https://github.com/commonmark/commonmark.js/blob/master/changelog.txt)
- [Commits](https://github.com/commonmark/commonmark.js/compare/0.29.3...0.31.2)

---
updated-dependencies:
- dependency-name: commonmark
  dependency-version: 0.31.2
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* [summarize-impact] pin commonmark and types (0.x versions)

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>

* Bump eslint-plugin-unicorn from 59.0.1 to 60.0.0 in /eng/tools/spec-gen-sdk-runner in the eslint group across 1 directory (#36272)

* Bump eslint-plugin-unicorn

Bumps the eslint group with 1 update in the /eng/tools/spec-gen-sdk-runner directory: [eslint-plugin-unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn).


Updates `eslint-plugin-unicorn` from 59.0.1 to 60.0.0
- [Release notes](https://github.com/sindresorhus/eslint-plugin-unicorn/releases)
- [Commits](https://github.com/sindresorhus/eslint-plugin-unicorn/compare/v59.0.1...v60.0.0)

---
updated-dependencies:
- dependency-name: eslint-plugin-unicorn
  dependency-version: 60.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
  dependency-group: eslint
...

Signed-off-by: dependabot[bot] <support@github.com>

* npm i

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>

* [EngSys] npm update (#36278)

* Ignore failures when new package isn't indexed yet. (#36245)

Co-authored-by: Wes Haggard <weshaggard@users.noreply.github.com>

* Release Fleet API 2025-04-01-preview (#35829)

* Add Gates resource to the Fleet 2025-04-01-preview API (#33620)

* Create the 2025-04-01-preview version, copied from 2025-03-01.

* Add FleetMember Label (#33085)

* Implement Gate API changes

* Create gate.tsp to model APIs for new Gate resource.
* Add Gates to strategy and update run models.
* Add examples for Gate APIs.
* Add gates to update run and strategy examples.
* Add "Pending" state which was missing from the enum.

* Implement Gate update API with ArmCustomPatchAsync instead of ArmResourcePatchAsync.

* Add suppressions for Swagger LintDiff errors to readme file.

---------

Co-authored-by: Nont <nontkrub@gmail.com>

* Change gates from tracked to proxy resource. (#35619)

* Change gates from tracked to proxy resource.

* Merge containerservice changes from main.

* Add missing typespec-python config.

---------

Co-authored-by: frantran <aznspartan117@gmail.com>

* add to 20250401preview (#35393) (#35799)

Co-authored-by: Minh Nguyen <comrc019@icloud.com>
Co-authored-by: nguyenmin <nguyenmin@microsoft.com>

* set GateTargetId to use alias and not union to fix go sdk issues (#35801)

* fix GateTargetId union for go sdk issues

* change to alias

---------

Co-authored-by: frantran <ftran@microsoft.com>

---------

Co-authored-by: dvadas <davidvadas@microsoft.com>
Co-authored-by: Nont <nontkrub@gmail.com>
Co-authored-by: Minh Nguyen <comrc019@icloud.com>
Co-authored-by: nguyenmin <nguyenmin@microsoft.com>
Co-authored-by: frantran <ftran@microsoft.com>

* Fix MCP in streaming scenarios (#36223)

* Update tspconfig.yaml (#36285)

* Monitor Metrics Query Java Updates (#36258)

* Java Updates to client.tsp

* Updating tspconfig.yaml

* Updating tspconfig.yaml

* Java Updates to client.tsp

* Java Updates to client.tsp

* Java Updates to client.tsp

* Java Updates to client.tsp

* Java Updates to client.tsp

* Java Updates to client.tsp

* Java Updates to client.tsp

* fixing formatting

* Fix `summarize-impact` failure to import lodash (#36270)

* according to chatgpt lodash needs to be imported differently when being used in an ES Module, which this package is

* ensure we don't crash on NaN issue-number (#36268)

* Fix Centralized Labelling - Page GraphQL in summarize checks (#36267)

* Java Updates to client.tsp (#36300)

* [hybridkubernetes] [Microsoft.Kubernetes] add preview version 2025-08-01-preview (#35949)

* [app config] migrate to new c# generator (#34871)

* build: migrate to new c# generator

* disable csharp conv methods

* undo

* try make getkeyValues internal

* more internals and renames

* internalize getConfigurationSetting(s)

* try fixing kv selection query

* more internals

* change getrevisions type

* remove internals

* try reducing renames

* try param nextlink

* make putkeyvalue internal again

* try renaming

* try to add custom csharp operations

* try another custom approach

* try suppressing method

* make all nextlinks urls

* revert

* cleanup

* cleanup

* cleanup tspconfig

* cleanup client.tsp

* try fixing error model name

* save inputs

* make all methods internal

* add back autorest config

* pr feedback

* Sync eng/common directory with azure-sdk-tools for PR 11373 (#36259)

* Use full checkout for regen stage

* remove fetchdepth

* update both

* checkout branch

* switch

* Fetch branch

* origin

* azure-sdk

---------

Co-authored-by: jolov <jolov@microsoft.com>

* Update CODEOWNERS (#36269)

* [extract-inputs] If issue-number is invalid, set output to NaN instead of throwing (#36307)

- While this might hide errors like issue-number=foo, it prevents errors in cases like issue-number=null
- It's better to just set issue_number=NaN and let the caller handle it
- Likely, the caller will fail the same, regardless of whether the artifact was set to an invalid value, or if it was never set at all.

* Introduce first Public Preview API version for microsoft.fileshares (2025-06-01-preview) (#36135)

* Establishing baseline with the most recent API version from private preview cycle.

This allows reviewers to easily diff subsequent changes against the previous spec.

It is based on release-Microsoft.FileShares-2024-01-01-preview
In https://github.com/Azure/azure-rest-api-specs-pr

* Update version to 2025-06-01-preview.

Based on private API version: 2024-01-01-preview

* Bring changes for 2025-06-01-preview from development repository

* Bring changes for 2025-06-01-preview from development repository

* Remove unused InformationalRequestParameters model

* Remove VirtualNetworkRule model from FileShares specifications

* Addressing @azure-tools/typespec-azure-core/no-enum suppression: Refactor MediaTier, Redundancy, Protocol, and ShareRootSquash to use union types

* Update descriptions for MediaTier, Redundancy, Protocol, and ShareRootSquash to specify they are enums

* Add justification for casing-style: customized style suitable for storage admins

* Refactor operation IDs for FileShare and FileShareSnapshot interfaces to improve outcome of Az PowerShell generation

* Correct PUT FileShareSnapshot spec to reflect it is using 202 Accepted pattern.

* Add examples and update example references in swagger

* Integrate from main to topic branch (#36191)

* [Language] Remove old preview API versions (#31781)

* [Language] Remove old preview API versions

* Remove 2023-04-15-preview from authoring

* update the api version

* tsv compile

---------

Co-authored-by: Bidisha Chakraborty <bidishac@microsoft.com>

* Migrate API Doc Preview (#35018)

* Add package.json

* Enable eng/tools in JS

* First cut at direct port

* Wire up command, move some functions into changed-files.js

* Move, pipeline, refactor

* Trivial test change to a spec file

* Usage, logging, add pathExists to changed-files.js, types in doc-preview.js, coverage for doc-preview.js

* Prettier

* SkipCheckoutNone

* Git token auth

* --

* ../

* Pool

* fetchDepth: 2

* Get-ChildItem

* More logging

* Directory

* BaseRepoOwner

* Cleanup

* 02

* Comment

* Test a change that should break the docs build

* Queue docs build

* 02

* Tab

* Add wait and result output

* Log files

* Direct invocation with valid path

* Output buildstart.json

* Fixes

* Remove BOM

* PR Number

* Test changes that won't break the build

* encodeURIComponent

* -pwsh

* Revert BatchService.json testing

* Test from another PR

* Test timeouts

* Test timeout in script

* >

* Remove test exception

* Show token scope

* Set status on PR

* git rev-parse HEAD

* SourceCommitId

* -Azure/

* Set check state in DevOps pipeline

* set-pr-check.yml

* -description

* Can't enforce values for macro (defined at runtime) syntax at template expansion time

* .mjs -> .js

* .js, other documentation

* vso

* displayName

* Add package.json to eng/scripts, wire up to github-test.yaml (might need a rename)

* sparse checkout eng/scripts

* eng/scripts/package-lock.json

* package.json

* npm i

* prettier -> format

* package-lock.json

* --output

* Path

* Revert test changes in specification/

* Revert "Test from another PR"

This reverts commit 04aeecce042d8de6df064596339aa8e57687d534.

* Architecture feedback

* Paths

* Docs preview

* pscore

* `

* copy

* $buildStart

* Test: timeout

* (

* Remove test timeout

* Test orchestration build failure

* Revert contrived orchestration failure

* Contrive a docs build failure

* Test success case

* Revert spec change

* Add support for filtering quickstart templates

* Use aka.ms link for docs support teams channel

* Sparse checkout might work but that can be investigated elsewhere

* Improve param validation

* Test api-doc-preview param validation in practice

* Revert github-test.yaml

* Revert .gitignore

* Remove unnecessary files

* More status update messages

* Revert "Test api-doc-preview param validation in practice"

This reverts commit 929d33c7d4ad66a1864d65c3c42d83b6e19aebf4.

* Fix package.json/package-lock.json

* package-lock.json

* npm i

* Format

* Apply suggestions from code review

Co-authored-by: Mike Harder <mharder@microsoft.com>

* inline, fix ts-check errors

* Use getChangedFilesStatuses to exclude deleted files instead of querying the filesystem directly

* Comments

* Named typedefs, more exceptions, expand "key" to a couple variables

* Adjust PR triggers

* Remove fs/promises/access

* Add WorkingDirectory to npm-install.yml, use shebang invocation

* Remove infinite loop condition

* pathExists

* .js

* (

* Only run docs build if there are changes to push

* DisplayName

* Final TODOs

* Format

* Update eng/pipelines/swagger-api-doc-preview.yml

Co-authored-by: Mike Harder <mharder@microsoft.com>

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* [.github] Add typescript-eslint (#36181)

* [chore] npm update (#36182)

* Azure Maps Weather Service: ordered the enum tables how they should appear in the docs. (#35646)

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* minor updates

* removed blank line.

* Removed word 'inhalable'

---------

Co-authored-by: Faraz Siddiqui <124096851+FarazGIS@users.noreply.github.com>

* Update `summarize-checks` output - add graceful exit (#36186)

* format, update output

* Ensure typespec project is valid before generating typespec apiview (#36183)

* [Monitor Metrics Query] Update TypeSpec Python config (#36052)

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>

* Add Microsoft.Mission spec to public repo (#32359)

* Moving specs from private to public

The files are the same as the one in https://github.com/Azure/azure-rest-api-specs-pr/pull/20074/files#diff-4764111bf455581c775da5c4711ccd11e820292fc9c84957532fc5d278b3ea2d

* Added missing files

* Add only version 2024-01-01 preview

* Remove old versions

* add back the old versions

* Removing old versions

* Added older version of the API

* Added older version of API to Readme

* Update version.tsp

* remove 2022 versions

* Delete versions prior 2024-06-01-preview

* remove status 200 of delete operations

* remove status 200 from openapi.json

* remove status 200 from example files

* remove status 200 from EnclaveEndpoints_Delete.json

* remove the status 200 when compiling

* change ArmResourcePatchAsync to ArnCustomPatch

* compile file with ArmCustomPatch

* rollback to ArmResourcePatch

* added version 2024-12-01

* remove status 200 from ver 2024-12-01

* change ARMResourcePatch for ARMResourcePatch

* add @parameterVisibility to all ocurrences of ArmCustomPatchAsync

* minor fix on ArmCustomPatchAsync

* compile the model

* added location to Community Update

* location to community_update

* Update Community_Update.json

* added location to CommunityEndpoints

* Added location on all update example files

* added location to virtualEnclave_update

* made rulecollection optional

* change propertires to optional

* change properties to optional

* Added suppression

* add suppression

* rollback suppressions

* made properties optional

* update openapi file

* Update for tsp update

* Update formatting

* Use latest version v6 of types.json

* Use latest version v6 of types.json

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Revert location addition in examples

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Fix location in examples.

* Update patch model. Fix location in examples.

* Format update

* Format update. Use Azure.Core.azureLocation for location def in mrg

* Fix visibility for mrg location

* Remove 2024_10 and 2024_11

* Remove 2024_10 and 2024_11 examples

* Remove 2024_10 and 2024_11 from readme.md

* Remove 2024_10 and 2024_11 from resource-manager

* Use Update<T> instead of separately defining the patchable props

* Use Update<T> on patchResources

* Revert optional/required params to match ve-common and hope the Update<T> model handles it correctly.

* Re-Enable PATCH optionality.

* Add types for ARM resources

* Fix examples

* Add suppressions for AvoidAnonymousTypes

* Fix examples for type updates. Add uuid type to uuid fields.

* Fix examples for type updates.

* Remove uuid type

* Remove uuid type

* Prettier

* Prettier

* Update suppressions

* Move routes to routes.tsp

* Feedback from engineering -- remove Endpoint, InternalConnection, ExternalConnection models and interfaces. Update Community to include _ as part of name validation.

* Fix examples

* Remove examples for deprecated resources

* Remove examples for deprecated resources

* Remove examples for deprecated resources

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@users.noreply.github.com>

---------

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>
Co-authored-by: Bidisha Chakraborty <29803402+bidisha-c@users.noreply.github.com>
Co-authored-by: Bidisha Chakraborty <bidishac@microsoft.com>
Co-authored-by: Daniel Jurek <djurek@microsoft.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>
Co-authored-by: steve munk <stevemunk@hotmail.com>
Co-authored-by: Faraz Siddiqui <124096851+FarazGIS@users.noreply.github.com>
Co-authored-by: Scott Beddall <45376673+scbedd@users.noreply.github.com>
Co-authored-by: Chidozie Ononiwu <31145988+chidozieononiwu@users.noreply.github.com>
Co-authored-by: Paul Van Eck <paulvaneck@microsoft.com>
Co-authored-by: jorgechav <54075564+jchavaherrera@users.noreply.github.com>
Co-authored-by: Trevor Goodyear <tgoodyear@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@users.noreply.github.com>

* Integrate from main (#36202)

* [Language] Remove old preview API versions (#31781)

* [Language] Remove old preview API versions

* Remove 2023-04-15-preview from authoring

* update the api version

* tsv compile

---------

Co-authored-by: Bidisha Chakraborty <bidishac@microsoft.com>

* Migrate API Doc Preview (#35018)

* Add package.json

* Enable eng/tools in JS

* First cut at direct port

* Wire up command, move some functions into changed-files.js

* Move, pipeline, refactor

* Trivial test change to a spec file

* Usage, logging, add pathExists to changed-files.js, types in doc-preview.js, coverage for doc-preview.js

* Prettier

* SkipCheckoutNone

* Git token auth

* --

* ../

* Pool

* fetchDepth: 2

* Get-ChildItem

* More logging

* Directory

* BaseRepoOwner

* Cleanup

* 02

* Comment

* Test a change that should break the docs build

* Queue docs build

* 02

* Tab

* Add wait and result output

* Log files

* Direct invocation with valid path

* Output buildstart.json

* Fixes

* Remove BOM

* PR Number

* Test changes that won't break the build

* encodeURIComponent

* -pwsh

* Revert BatchService.json testing

* Test from another PR

* Test timeouts

* Test timeout in script

* >

* Remove test exception

* Show token scope

* Set status on PR

* git rev-parse HEAD

* SourceCommitId

* -Azure/

* Set check state in DevOps pipeline

* set-pr-check.yml

* -description

* Can't enforce values for macro (defined at runtime) syntax at template expansion time

* .mjs -> .js

* .js, other documentation

* vso

* displayName

* Add package.json to eng/scripts, wire up to github-test.yaml (might need a rename)

* sparse checkout eng/scripts

* eng/scripts/package-lock.json

* package.json

* npm i

* prettier -> format

* package-lock.json

* --output

* Path

* Revert test changes in specification/

* Revert "Test from another PR"

This reverts commit 04aeecce042d8de6df064596339aa8e57687d534.

* Architecture feedback

* Paths

* Docs preview

* pscore

* `

* copy

* $buildStart

* Test: timeout

* (

* Remove test timeout

* Test orchestration build failure

* Revert contrived orchestration failure

* Contrive a docs build failure

* Test success case

* Revert spec change

* Add support for filtering quickstart templates

* Use aka.ms link for docs support teams channel

* Sparse checkout might work but that can be investigated elsewhere

* Improve param validation

* Test api-doc-preview param validation in practice

* Revert github-test.yaml

* Revert .gitignore

* Remove unnecessary files

* More status update messages

* Revert "Test api-doc-preview param validation in practice"

This reverts commit 929d33c7d4ad66a1864d65c3c42d83b6e19aebf4.

* Fix package.json/package-lock.json

* package-lock.json

* npm i

* Format

* Apply suggestions from code review

Co-authored-by: Mike Harder <mharder@microsoft.com>

* inline, fix ts-check errors

* Use getChangedFilesStatuses to exclude deleted files instead of querying the filesystem directly

* Comments

* Named typedefs, more exceptions, expand "key" to a couple variables

* Adjust PR triggers

* Remove fs/promises/access

* Add WorkingDirectory to npm-install.yml, use shebang invocation

* Remove infinite loop condition

* pathExists

* .js

* (

* Only run docs build if there are changes to push

* DisplayName

* Final TODOs

* Format

* Update eng/pipelines/swagger-api-doc-preview.yml

Co-authored-by: Mike Harder <mharder@microsoft.com>

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* [.github] Add typescript-eslint (#36181)

* [chore] npm update (#36182)

* Azure Maps Weather Service: ordered the enum tables how they should appear in the docs. (#35646)

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* ordered the enum tables how they should appear in the docs. Updated enum descriptions.

* minor updates

* removed blank line.

* Removed word 'inhalable'

---------

Co-authored-by: Faraz Siddiqui <124096851+FarazGIS@users.noreply.github.com>

* Update `summarize-checks` output - add graceful exit (#36186)

* format, update output

* Ensure typespec project is valid before generating typespec apiview (#36183)

* [Monitor Metrics Query] Update TypeSpec Python config (#36052)

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>

* Add Microsoft.Mission spec to public repo (#32359)

* Moving specs from private to public

The files are the same as the one in https://github.com/Azure/azure-rest-api-specs-pr/pull/20074/files#diff-4764111bf455581c775da5c4711ccd11e820292fc9c84957532fc5d278b3ea2d

* Added missing files

* Add only version 2024-01-01 preview

* Remove old versions

* add back the old versions

* Removing old versions

* Added older version of the API

* Added older version of API to Readme

* Update version.tsp

* remove 2022 versions

* Delete versions prior 2024-06-01-preview

* remove status 200 of delete operations

* remove status 200 from openapi.json

* remove status 200 from example files

* remove status 200 from EnclaveEndpoints_Delete.json

* remove the status 200 when compiling

* change ArmResourcePatchAsync to ArnCustomPatch

* compile file with ArmCustomPatch

* rollback to ArmResourcePatch

* added version 2024-12-01

* remove status 200 from ver 2024-12-01

* change ARMResourcePatch for ARMResourcePatch

* add @parameterVisibility to all ocurrences of ArmCustomPatchAsync

* minor fix on ArmCustomPatchAsync

* compile the model

* added location to Community Update

* location to community_update

* Update Community_Update.json

* added location to CommunityEndpoints

* Added location on all update example files

* added location to virtualEnclave_update

* made rulecollection optional

* change propertires to optional

* change properties to optional

* Added suppression

* add suppression

* rollback suppressions

* made properties optional

* update openapi file

* Update for tsp update

* Update formatting

* Use latest version v6 of types.json

* Use latest version v6 of types.json

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Revert location addition in examples

* Update patch model

* Update patch model

* Update patch model

* Update patch model. Fix location in examples.

* Update patch model. Fix location in examples.

* Format update

* Format update. Use Azure.Core.azureLocation for location def in mrg

* Fix visibility for mrg location

* Remove 2024_10 and 2024_11

* Remove 2024_10 and 2024_11 examples

* Remove 2024_10 and 2024_11 from readme.md

* Remove 2024_10 and 2024_11 from resource-manager

* Use Update<T> instead of separately defining the patchable props

* Use Update<T> on patchResources

* Revert optional/required params to match ve-common and hope the Update<T> model handles it correctly.

* Re-Enable PATCH optionality.

* Add types for ARM resources

* Fix examples

* Add suppressions for AvoidAnonymousTypes

* Fix examples for type updates. Add uuid type to uuid fields.

* Fix examples for type updates.

* Remove uuid type

* Remove uuid type

* Prettier

* Prettier

* Update suppressions

* Move routes to routes.tsp

* Feedback from engineering -- remove Endpoint, InternalConnection, ExternalConnection models and interfaces. Update Community to include _ as part of name validation.

* Fix examples

* Remove examples for deprecated resources

* Remove examples for deprecated resources

* Remove examples for deprecated resources

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@users.noreply.github.com>

* [applicationinsights][python] Convert applicationinsights readme.python.md to singleapi package format (#36026)

* Initial plan

* Convert applicationinsights readme.python.md to singleapi package format

Co-authored-by: msyyc <70930885+msyyc@users.noreply.github.com>

* Update readme.java.md

* Update readme.java.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Weidong Xu <weidxu@microsoft.com>

* Sync eng/common directory with azure-sdk-tools for PR 11336 (#36190)

* Install .NET from tools repo global.json

* Set workingDirectory to tools root

* use exact same install steps as tools repo

* revert formatting

* formatting

---------

Co-authored-by: Mike Harder <mharder@microsoft.com>

* Rename Recoveryservices.Management to RecoveryServices.Management (#36172)

All files and directories under specification/recoveryservices/Recoveryservices.Management were renamed to specification/recoveryservices/RecoveryServices.Management to standardize casing and improve consistency.

* Rename Powerbidedicated.Management to PowerBIDedicated.Management (#36169)

All files and folders under specification/powerbidedicated/Powerbidedicated.Management were renamed to specification/powerbidedicated/PowerBIDedicated.Management to correct casing and improve consistency.

* Rename NotificationHubs.Management directory and files (#36168)

Renamed 'Notificationhubs.Management' to 'NotificationHubs.Management' across all specification files and examples for consistency. Also updated the service name in tspconfig.yaml to 'NotificationHubs'.

Co-authored-by: Dapeng Zhang <dapzhang@microsoft.com>

* Fixed 2025-02-01-preview API by Reverting Linked Hub Changes and Added DeviceRegistry Namespace (#31635)

* update common model refs (#36114)

* java, mgmt, aks, fix readme (#36200)

---------

Signed-off-by: Paul Van Eck <paulvaneck@microsoft.com>
Co-authored-by: Bidisha Chakraborty <29803402+bidisha-c@users.noreply.github.com>
Co-authored-by: Bidisha Chakraborty <bidishac@microsoft.com>
Co-authored-by: Daniel Jurek <djurek@microsoft.com>
Co-authored-by: Mike Harder <mharder@microsoft.com>
Co-authored-by: steve munk <stevemunk@hotmail.com>
Co-authored-by: Faraz Siddiqui <124096851+FarazGIS@users.noreply.github.com>
Co-authored-by: Scott Beddall <45376673+scbedd@users.noreply.github.com>
Co-authored-by: Chidozie Ononiwu <31145988+chidozieononiwu@users.noreply.github.com>
Co-authored-by: Paul Van Eck <paulvaneck@microsoft.com>
Co-authored-by: jorgechav <54075564+jchavaherrera@users.noreply.github.com>
Co-authored-by: Trevor Goodyear <tgoodyear@microsoft.com>
Co-authored-by: Trevor Goodyear <tgoodyear@users.noreply.github.com>
Co-authored-by: Yuchao Yan <yuchaoyan@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Weidong Xu <weidxu@microsoft.com>
Co-authored-by: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Co-authored-by: Wenming Liu <v-wenmingliu@microsoft.com>
Co-authored-by: Dapeng Zhang <dapzhang@microsoft.com>
Co-authored-by: yijinglu-microsoft <yijinglu@microsoft.com>
Co-authored-by: jiminwen-msft <97924128+jiminwen-msft@users.noreply.github.com>

* Check in readmes

* Missed one

* Fix naming

* Revert "Fix naming"

This reverts commit 9c61a28216539eecb263b66b3571d6eae0e043b8.

* [For Allan ] Contribute to 2025 Api spec (#36203)

* Updates

* revert

* Update fileshares.json

* Update tspconfig.yaml

* Update tspconfig.yaml

* Update tspconfig.yaml

* revert

* Update readme.md

* Prettier (#36220)

npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_CreateOrUpdate_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Get_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Update_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetLimits_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetLimits_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetProvisioningRecommendation_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetProvisioningRecommendation_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetUsageData_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetUsageData_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_CheckNameAvailability_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_CheckNameAvailability_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/Operations_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/Operations_List_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_CreateOrUpdate_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_Get_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_Update_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetLimits_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetLimits_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetProvisioningRecommendation_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetProvisioningRecommendation_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetUsageData_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShare_GetUsageData_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShares_CheckNameAvailability_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShares_CheckNameAvailability_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShares_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/Operations_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/Operations_List_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/fileshares.json

* Update 2025 06 01 7 25 (#36222)

* Prettier

npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_CreateOrUpdate_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Get_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShareSnapshot_Update_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetLimits_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetLimits_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetProvisioningRecommendation_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetProvisioningRecommendation_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetUsageData_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShare_GetUsageData_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_CheckNameAvailability_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_CheckNameAvailability_MinimumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/FileShares_Delete_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/Operations_List_MaximumSet_Gen.json
npx prettier --write specification/fileshares/FileShares.Management/examples/2025-06-01-preview/Operations_List_MinimumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileShares/preview/2025-06-01-preview/examples/FileShareSnapshot_CreateOrUpdate_MaximumSet_Gen.json
npx prettier --write specification/fileshares/resource-manager/Microsoft.FileSha…
@FumingZhang FumingZhang restored the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch September 3, 2025 11:57
@FumingZhang FumingZhang deleted the FumingZhang-containerservice-Microsoft.ContainerService-2025-06-02-preview branch September 3, 2025 12:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ARMReview ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review BreakingChange-Approved-Previously Changes were reviewed and approved in a previous PR BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required brownfield Brownfield services will soon be required to convert to TypeSpec. See https://aka.ms/azsdk/typespec. Container Service new-api-version PipelineBotTrigger PublishToCustomers Acknowledgement the changes will be published to Azure customers. resource-manager

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants