AKS Fleet 2026-05-01-preview API version by Ealianis · Pull Request #41422 · Azure/azure-rest-api-specs

Ealianis · 2026-03-16T16:32:44Z

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.

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.

github-actions · 2026-03-16T16:33:14Z

Next Steps to Merge

Next steps that must be taken to merge this PR:

❌ Your PR has breaking changes in the generated SDK for Go (label: BreakingChange-Go-Sdk). Refer to step 3 in the PR workflow diagram.
❌ The required check named SDK Validation Status 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

Comment generated by summarize-checks workflow run.

* [fleet] Adding mesh member property to fleet member api (#39540) * adding mesh member typespec definition * added meshmember model to fleetmember * adjusted provisioning state * fixed meshmember model definition to not be a resource * removed incorrect name field from mesh member property * removed excess imports * final fixes * ran tsp compile * rename mesh member state property Co-authored-by: dvadas <davidvadas@microsoft.com> * applying suggested changes * adjusted doc line for mesh member prop --------- Co-authored-by: dvadas <davidvadas@microsoft.com> * Delete 2025-08-02-clustermesh version of fleets.json * Add clustermeshprofile.tsp and meshmember.tsp. * Ran tsp format. * Add examples for clusterMeshProfile APIs. * Make clusterMeshProfile status optional, since on create it will be nil. * Add missing "state" field to Member meshProperties example. * Improve doc comments and allow memberLabelSelector to be nil. * Run prettier to remove blank line. --------- Co-authored-by: zuhair <48816804+zuhairm2001@users.noreply.github.com>

* Extract label selector out to its own model. * No restrictions in the generic selector. * Update examples to match tsp changes.

…atus (#41124) * fix: update last applied member label selector to member selector in cluster mesh profile * tidy + example fix * fix incorrect name --------- Co-authored-by: Sean Hobbs <sehobbs@microsoft.com>

github-actions · 2026-04-11T04:08:39Z

API Change Check

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

Language	API Review for Package
TypeSpec	Microsoft.ContainerService
Swagger	Microsoft.ContainerService-fleet
Go	sdk/resourcemanager/containerservicefleet/armcontainerservicefleet
Python	azure-mgmt-containerservicefleet
Java	com.azure.resourcemanager:azure-resourcemanager-containerservicefleet

Comment generated by After APIView workflow run.

sandipsh · 2026-04-13T23:20:44Z

Please address avocado and lintdiff errors.

Copilot

Pull request overview

Adds new ContainerService Fleet (ARM control plane) preview API versions and updates the Fleet TypeSpec + generated Swagger/examples to reflect new features and clarified semantics.

Changes:

Introduces preview API versions 2026-03-02-preview and 2026-05-01-preview in the Fleet TypeSpec and generated Swagger.
Adds new/updated Fleet concepts (e.g., mesh member status models, scheduled start gates, rollout strategy, failure counts) and propagates them into examples.
Updates generator configuration (tspconfig.yaml) and refreshes example artifacts for the new preview versions.

Reviewed changes

Copilot reviewed 198 out of 200 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/update/run.tsp	Adds read-only failure count fields to update-run status models for the new preview version.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/tspconfig.yaml	Configures the TypeSpec autorest emitter to use a project-root examples directory.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2025-03-01/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2024-04-01/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2023-10-15/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/selector.tsp	Adds `MemberSelector` TypeSpec model.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/readme.md	Updates default autorest tag and adds a `package-2026-03-02-preview` tag block/suppressions.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/UpdateStrategies_Get.json	Adds swagger example for getting an update strategy.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/UpdateStrategies_Delete.json	Adds swagger example for deleting an update strategy.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/UpdateRuns_Delete.json	Adds swagger example for deleting an update run.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Operations_List.json	Adds swagger example for provider operations listing.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Gates_Update.json	Adds swagger example for updating a gate.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Gates_Get_ScheduledStart.json	Adds swagger example for getting a scheduled-start gate.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Gates_Get.json	Adds swagger example for getting a gate.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Fleets_PatchTags.json	Adds swagger example for patching fleet tags.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Fleets_ListCredentialsResult.json	Adds swagger example for listing fleet credentials.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Fleets_Get.json	Adds swagger example for getting a fleet.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/Fleets_Delete.json	Adds swagger example for deleting a fleet.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/FleetMembers_Update.json	Adds swagger example for updating a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/FleetMembers_ListByFleet.json	Adds swagger example for listing fleet members.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/FleetMembers_Get.json	Adds swagger example for getting a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/FleetMembers_Delete.json	Adds swagger example for deleting a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/FleetManagedNamespaces_Delete.json	Adds swagger example for deleting a managed namespace.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/ClusterMeshProfiles_ListByFleet.json	Adds swagger example for listing cluster mesh profiles.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/ClusterMeshProfiles_Get.json	Adds swagger example for getting a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/ClusterMeshProfiles_Delete.json	Adds swagger example for deleting a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/ClusterMeshProfiles_Apply.json	Adds swagger example for applying a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/AutoUpgradeProfiles_ListByFleet.json	Adds swagger example for listing auto-upgrade profiles.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/AutoUpgradeProfiles_Get.json	Adds swagger example for getting an auto-upgrade profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/AutoUpgradeProfiles_Delete.json	Adds swagger example for deleting an auto-upgrade profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/examples/AutoUpgradeProfileOperations_GenerateUpdateRun.json	Adds swagger example for generating an update run.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/UpdateStrategies_ListByFleet.json	Adds swagger example for listing update strategies.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/UpdateStrategies_Get.json	Adds swagger example for getting an update strategy.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/UpdateStrategies_Delete.json	Adds swagger example for deleting an update strategy.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/UpdateRuns_Delete.json	Adds swagger example for deleting an update run.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Operations_List.json	Adds swagger example for provider operations listing.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Gates_Update.json	Adds swagger example for updating a gate.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Gates_ListByFleet.json	Adds swagger example for listing gates.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Gates_Get.json	Adds swagger example for getting a gate.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Fleets_PatchTags.json	Adds swagger example for patching fleet tags.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Fleets_ListCredentialsResult.json	Adds swagger example for listing fleet credentials.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Fleets_Get.json	Adds swagger example for getting a fleet.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/Fleets_Delete.json	Adds swagger example for deleting a fleet.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/FleetMembers_Update.json	Adds swagger example for updating a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/FleetMembers_ListByFleet.json	Adds swagger example for listing fleet members.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/FleetMembers_Get.json	Adds swagger example for getting a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/FleetMembers_Delete.json	Adds swagger example for deleting a fleet member.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/FleetManagedNamespaces_Delete.json	Adds swagger example for deleting a managed namespace.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/ClusterMeshProfiles_ListByFleet.json	Adds swagger example for listing cluster mesh profiles.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/ClusterMeshProfiles_Get.json	Adds swagger example for getting a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/ClusterMeshProfiles_Delete.json	Adds swagger example for deleting a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/ClusterMeshProfiles_Apply.json	Adds swagger example for applying a cluster mesh profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/AutoUpgradeProfiles_ListByFleet.json	Adds swagger example for listing auto-upgrade profiles.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/AutoUpgradeProfiles_Get.json	Adds swagger example for getting an auto-upgrade profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/AutoUpgradeProfiles_Delete.json	Adds swagger example for deleting an auto-upgrade profile.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-03-02-preview/examples/AutoUpgradeProfileOperations_GenerateUpdateRun.json	Adds swagger example for generating an update run.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-02-01-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2025-08-01-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2025-04-01-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-05-02-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-08-15-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-06-15-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-03-15-preview/fleets.json	Updates the description text for an update-strategy group name field.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/meshmember.tsp	Adds mesh member models referenced from fleet members.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/main.tsp	Adds new preview versions and imports for additional TypeSpec files.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/kubefleet/apis/placement/v1/types.tsp	Adds rollout strategy modeling and versioned optionality changes.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/helpers.tsp	Adds `DayOfWeek` union and versioning usage in helpers.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/gate.tsp	Adds `ScheduledStart` gate type and its properties.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/fleetnamespace.tsp	Adds patchable properties model updates and versioned optionality changes.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/fleetmember.tsp	Adds meshProperties to fleet member properties.
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/UpdateStrategies_Get.json	Adds TypeSpec-source example for update strategy get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/UpdateStrategies_Delete.json	Adds TypeSpec-source example for update strategy delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/UpdateRuns_Delete.json	Adds TypeSpec-source example for update run delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Operations_List.json	Adds TypeSpec-source example for operations list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Gates_Update.json	Adds TypeSpec-source example for gates update (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Gates_Get_ScheduledStart.json	Adds TypeSpec-source example for scheduled-start gate get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Gates_Get.json	Adds TypeSpec-source example for gate get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Fleets_PatchTags.json	Adds TypeSpec-source example for fleet patch tags (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Fleets_ListCredentialsResult.json	Adds TypeSpec-source example for fleet list credentials (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Fleets_ListBySub.json	Adds TypeSpec-source example for fleets list by subscription (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Fleets_Get.json	Adds TypeSpec-source example for fleet get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/Fleets_Delete.json	Adds TypeSpec-source example for fleet delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/FleetMembers_Update.json	Adds TypeSpec-source example for fleet member update (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/FleetMembers_ListByFleet.json	Adds TypeSpec-source example for fleet members list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/FleetMembers_Get.json	Adds TypeSpec-source example for fleet member get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/FleetMembers_Delete.json	Adds TypeSpec-source example for fleet member delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/FleetManagedNamespaces_Delete.json	Adds TypeSpec-source example for managed namespaces delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/ClusterMeshProfiles_ListByFleet.json	Adds TypeSpec-source example for cluster mesh profile list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/ClusterMeshProfiles_Get.json	Adds TypeSpec-source example for cluster mesh profile get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/ClusterMeshProfiles_Delete.json	Adds TypeSpec-source example for cluster mesh profile delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/ClusterMeshProfiles_Apply.json	Adds TypeSpec-source example for cluster mesh profile apply (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/AutoUpgradeProfiles_ListByFleet.json	Adds TypeSpec-source example for auto-upgrade profiles list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/AutoUpgradeProfiles_Get.json	Adds TypeSpec-source example for auto-upgrade profile get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/AutoUpgradeProfiles_Delete.json	Adds TypeSpec-source example for auto-upgrade profile delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-05-01-preview/AutoUpgradeProfileOperations_GenerateUpdateRun.json	Adds TypeSpec-source example for generating update run (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/UpdateStrategies_ListByFleet.json	Adds TypeSpec-source example for update strategies list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/UpdateStrategies_Get.json	Adds TypeSpec-source example for update strategy get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/UpdateStrategies_Delete.json	Adds TypeSpec-source example for update strategy delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/UpdateRuns_Delete.json	Adds TypeSpec-source example for update run delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Operations_List.json	Adds TypeSpec-source example for operations list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Gates_Update.json	Adds TypeSpec-source example for gates update (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Gates_ListByFleet.json	Adds TypeSpec-source example for gates list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Gates_Get.json	Adds TypeSpec-source example for gate get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Fleets_PatchTags.json	Adds TypeSpec-source example for fleet patch tags (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Fleets_ListCredentialsResult.json	Adds TypeSpec-source example for fleet list credentials (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Fleets_ListBySub.json	Adds TypeSpec-source example for fleets list by subscription (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Fleets_Get.json	Adds TypeSpec-source example for fleet get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/Fleets_Delete.json	Adds TypeSpec-source example for fleet delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/FleetMembers_Update.json	Adds TypeSpec-source example for fleet member update (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/FleetMembers_ListByFleet.json	Adds TypeSpec-source example for fleet members list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/FleetMembers_Get.json	Adds TypeSpec-source example for fleet member get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/FleetMembers_Delete.json	Adds TypeSpec-source example for fleet member delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/FleetManagedNamespaces_Delete.json	Adds TypeSpec-source example for managed namespaces delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/ClusterMeshProfiles_ListByFleet.json	Adds TypeSpec-source example for cluster mesh profile list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/ClusterMeshProfiles_Get.json	Adds TypeSpec-source example for cluster mesh profile get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/ClusterMeshProfiles_Delete.json	Adds TypeSpec-source example for cluster mesh profile delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/ClusterMeshProfiles_Apply.json	Adds TypeSpec-source example for cluster mesh profile apply (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_ListByFleet.json	Adds TypeSpec-source example for auto-upgrade profiles list (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_Get.json	Adds TypeSpec-source example for auto-upgrade profile get (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_Delete.json	Adds TypeSpec-source example for auto-upgrade profile delete (for emitter).
specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfileOperations_GenerateUpdateRun.json	Adds TypeSpec-source example for generating update run (for emitter).

Copilot · 2026-04-13T23:29:29Z

+import "@azure-tools/typespec-azure-core";
+using TypeSpec.Versioning;
+
+namespace Microsoft.ContainerService;
+
+@doc("Select members of a fleet.")
+@added(Versions.v2026_03_02_preview)
+model MemberSelector {
+  @doc("Kubernetes-style label selector for selecting Fleet members, e.g. `env=production`.")
+  @maxLength(512)
+  @visibility(Lifecycle.Read, Lifecycle.Create)
+  byLabel: string;


Lifecycle is referenced but Azure.Core is not imported into the file scope, which will fail TypeSpec compilation. Add using Azure.Core; (or fully-qualify Azure.Core.Lifecycle) before using Lifecycle.* in @visibility.

Copilot · 2026-04-13T23:29:30Z

+import "@typespec/rest";
+import "./helpers.tsp";
+
+using TypeSpec.Versioning;
+
+namespace Microsoft.ContainerService;
+
+scalar ClusterMeshProfileResourceId
+  extends Azure.Core.armResourceIdentifier<[
+    {
+      type: "Microsoft.ContainerService/fleets/clusterMeshProfiles",
+    }
+  ]>;
+
+@added(Versions.v2026_03_02_preview)
+@doc("The Mesh Member data for a Fleet Member resource.")
+model MeshProperties {
+  @doc("The Cilium cluster properties.")
+  @visibility(Lifecycle.Read)
+  ciliumProperties: CiliumProperties;
+


This file references Azure.Core.armResourceIdentifier, utcDateTime, and Lifecycle.* but does not include using Azure.Core; (and relies on unqualified Lifecycle). This will likely break TypeSpec compilation; add using Azure.Core; (or fully-qualify Azure.Core symbols) in this file.

Copilot · 2026-04-13T23:29:30Z

+        "responses": {
+          "202": {
+            "description": "Resource deletion accepted.",
+            "headers": {
+              "Location": {
+                "type": "string",
+                "description": "The Location header contains the URL where the status of the long running operation can be checked."
+              },
+              "Retry-After": {
+                "type": "integer",
+                "format": "int32",
+                "description": "The Retry-After header can indicate how long the client should wait before polling the operation status."
+              }
+            }
+          },
+          "204": {
+            "description": "Resource does not exist."
+          },
+          "default": {


ARM delete operations should include a 200 success response in addition to 202 (async accepted), 204, and default (RPC-Delete-V1-01). FleetManagedNamespaces_Delete currently defines only 202 and 204; add a 200 response.

weng271190436 · 2026-04-16T20:04:13Z

+@doc("A reference to an existing cluster staged update strategy.")
+model ClusterUpdateStrategyReference {
+  @doc("The name of an existing cluster staged update strategy.")
+  name?: string;


If made required, it would fail RPC-Patch-V1-10 - "Properties of a PATCH request body must not be required"

{"pluginName":"spectral","extensionName":"@microsoft.azure/openapi-validator","level":"error","message":"Properties of a PATCH request body must not be required, property:name.","code":"PatchBodyParametersSchema","details":{"jsonpath":["paths","/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/managedNamespaces/{managedNamespaceName}","patch","parameters","6","schema","properties","properties"],"validationCategory":"","providerNamespace":false,"resourceType":false,"rpcGuidelineCode":"RPC-Patch-V1-10","range":{"start":{"line":1,"column":0},"end":{"line":1,"column":0}}},"source":[{"document":"file:///home/runner/work/azure-rest-api-specs/azure-rest-api-specs/after/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2026-05-01-preview/fleets.json","position":{"line":1782,"column":13}}]}

Discussed in this PR #41809 (comment)

Now we are just confirming that after seeing test failure

#41809 (comment)

The link doesn't work too well

This discussion

* init * tsp compile + fix enum name

Co-authored-by: Sean Hobbs <sehobbs@microsoft.com>

* add memberselector to updatestage ts * update tspconfig to reference examples-dir * add examples/2026-05-01-preview dir * update 2026-05-01-preview/examples * tsp compile --------- Co-authored-by: yoobinshin <yoobinshin@microsoft.com>

… Staged Update Run and enhance PATCH for Managed Namespace (#41809)

…41996)

…iew (#41988) * add memberselector to updategroup in typespec * update examples * compile tsp and regenerate swagger * update comments --------- Co-authored-by: yoobinshin <yoobinshin@microsoft.com>

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

Signed-off-by: Wei Weng <Wei.Weng@microsoft.com>

…tchable

* readd removed maf fields * Run tsp compile --------- Co-authored-by: Sean Hobbs <sehobbs@microsoft.com> Co-authored-by: Wei Weng <Wei.Weng@microsoft.com>

…preview API (#42978)

nibooy · 2026-05-08T20:52:51Z

In the block above for @armResourceOperations, I think we may want to override where to retrieve the final state of the resource like FleetMember and Fleet async patches?

@extension( "x-ms-long-running-operation-options", #{ `final-state-via`: "original-uri" } ) update is ArmCustomPatchAsync< FleetManagedNamespace, FleetManagedNamespacePatch, Azure.ResourceManager.Foundations.BaseParameters<FleetManagedNamespace> & IfMatchParameters<FleetManagedNamespace> >;

Without the override, ArmCustomPatchAsync defaults to final-state-via: "location". And SDK polls the Location URL, gets an empty body, and the CLI command for az fleet namespace update doesn't print anything.

microsoft-github-policy-service Bot added the Container Service label Mar 16, 2026

github-actions Bot added resource-manager TypeSpec Authored with TypeSpec labels Mar 16, 2026

dvadas and others added 4 commits March 19, 2026 19:05

Copy fleet-2026-02-01-preview to fleet-2026-03-02-preview.

571d831

Extract label selector out to its own model. (#40665)

3fd6b63

* Extract label selector out to its own model. * No restrictions in the generic selector. * Update examples to match tsp changes.

fix: update type of lastAppliedMemberSelector on ClusterMeshProfileSt…

eaa9243

…atus (#41124) * fix: update last applied member label selector to member selector in cluster mesh profile * tidy + example fix * fix incorrect name --------- Co-authored-by: Sean Hobbs <sehobbs@microsoft.com>

Ealianis marked this pull request as ready for review April 8, 2026 20:41

Ealianis requested review from matthchr and serbrech as code owners April 8, 2026 20:41

Ealianis changed the title ~~[DO NOT REVIEW YET] AKS Fleet 2026-05-01-preview API version~~ AKS Fleet 2026-05-01-preview API version Apr 8, 2026

Ealianis force-pushed the dev-aks-fleet-2026-05-01-preview branch from bd551d3 to 6abf7f9 Compare April 11, 2026 03:57

github-actions Bot added ARMReview new-api-version WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Apr 11, 2026

sandipsh requested a review from Copilot April 13, 2026 23:19

sandipsh added ARMChangesRequested and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Apr 13, 2026

Copilot started reviewing on behalf of sandipsh April 13, 2026 23:22 View session

Copilot AI reviewed Apr 13, 2026

View reviewed changes

weng271190436 force-pushed the dev-aks-fleet-2026-05-01-preview branch from 7bf653c to c9c58f6 Compare April 16, 2026 19:52

weng271190436 reviewed Apr 16, 2026

View reviewed changes

Comment thread specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/helpers.tsp

github-actions Bot added ARMAutoSignedOff-IncrementalTSP ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review and removed ARMChangesRequested labels Apr 16, 2026

Updating Mesh Member and ClusterMesh Profile State Enums (#42446)

754da54

* init * tsp compile + fix enum name

microsoft-github-policy-service Bot added Insights Authorization Automation Batch Cognitive Services labels Apr 17, 2026

Ealianis force-pushed the dev-aks-fleet-2026-05-01-preview branch from 67bb10a to 03e94dc Compare April 17, 2026 05:19

Sean Hobbs and others added 15 commits April 17, 2026 17:14

add Azure Kubernetes Fleet Manager API version 2026-05-01-preview

c29467b

Add 2026-05-01-preview json spec / examples

fe0e714

Fixed maxAllowedFailures type on stage / group status objects (#41423)

5873951

Co-authored-by: Sean Hobbs <sehobbs@microsoft.com>

Target Fleet 2026-05-01-preview: Add support for external rollout via…

d656b8f

… Staged Update Run and enhance PATCH for Managed Namespace (#41809)

Add Scheduled Start Gate to 2026-05-01-preview (#41895)

a0d6af3

Add an extra field absolute-start-time to Scheduled Start Properties (#…

4fba331

…41996)

Adding memberSelector to UpdateGroup in dev-aks-fleet-2026-05-01-prev…

a9f3f4f

…iew (#41988) * add memberselector to updategroup in typespec * update examples * compile tsp and regenerate swagger * update comments --------- Co-authored-by: yoobinshin <yoobinshin@microsoft.com>

fix: update updategroup doc contract (#42330)

7515953

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

Add 2026-05-01-preview tag block in README

f7488ac

Signed-off-by: Wei Weng <Wei.Weng@microsoft.com>

Make cluster update strategy reference name optional because it is pa…

81ed2ad

…tchable

Fix DescriptionMustNotBeNodeName

abcfafd

Run tsp compile

be51e68

[fleet] Readd accidently removed MAF fields from TSPs (#42895)

3434621

* readd removed maf fields * Run tsp compile --------- Co-authored-by: Sean Hobbs <sehobbs@microsoft.com> Co-authored-by: Wei Weng <Wei.Weng@microsoft.com>

Add managed namespace Rollout Strategy and PATCH examples to 20260501…

aa1799c

…preview API (#42978)

nibooy reviewed May 8, 2026

View reviewed changes

Get update namespace final state via original uri (#43299)

6a7c703

minhng22 mentioned this pull request May 21, 2026

AKS Fleet 2026-06-02-preview API version #43386

Open

9 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

AKS Fleet 2026-05-01-preview API version#41422

AKS Fleet 2026-05-01-preview API version#41422
Ealianis wants to merge 21 commits into
mainfrom
dev-aks-fleet-2026-05-01-preview

Ealianis commented Mar 16, 2026

Uh oh!

github-actions Bot commented Mar 16, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 11, 2026 •

edited

Loading

Uh oh!

sandipsh commented Apr 13, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Apr 13, 2026

Uh oh!

Copilot AI Apr 13, 2026

Uh oh!

Uh oh!

Copilot AI Apr 13, 2026

Uh oh!

weng271190436 Apr 16, 2026

Uh oh!

weng271190436 Apr 16, 2026

Uh oh!

weng271190436 Apr 16, 2026

Uh oh!

Uh oh!

nibooy May 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

Uh oh!

Conversation

Ealianis commented Mar 16, 2026

ARM (Control Plane) API Specification Update Pull Request

PR review workflow diagram

Purpose of this PR

Due diligence checklist

Additional information

Getting help

Uh oh!

github-actions Bot commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Next Steps to Merge

Uh oh!

github-actions Bot commented Apr 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Change Check

Uh oh!

sandipsh commented Apr 13, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

weng271190436 Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

weng271190436 Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

weng271190436 Apr 16, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

nibooy May 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

github-actions Bot commented Mar 16, 2026 •

edited

Loading

github-actions Bot commented Apr 11, 2026 •

edited

Loading