AKS Fleet 2026-05-01-preview API version

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/clustermeshprofile.tsp

@@ -0,0 +1,127 @@
+import "@azure-tools/typespec-azure-core";
+import "./selector.tsp";
+
+using Azure.ResourceManager;
+using Azure.ResourceManager.Foundations;
+using TypeSpec.Http;
+using TypeSpec.Rest;
+using TypeSpec.Versioning;
+
+namespace Microsoft.ContainerService;
+
+@doc("A cluster mesh profile stores the general information about the mesh.")
+@added(Versions.v2026_03_02_preview)
+@resource("clusterMeshProfiles")
+@parentResource(Fleet)
+model ClusterMeshProfile
+  is Azure.ResourceManager.ProxyResource<ClusterMeshProfileProperties> {
+  @doc("The name of the ClusterMeshProfile resource.")
+  @pattern("^[a-z0-9]([-a-z0-9]*[a-z0-9])?$")
+  @minLength(1)
+  @maxLength(63)
+  @path
+  @segment("clusterMeshProfiles")
+  @key("clusterMeshProfileName")
+  @visibility(Lifecycle.Read)
+  name: string;
+
+  ...EntityTagProperty;
+}
+
+@doc("A cluster mesh profile stores the general information about the mesh.")
+@added(Versions.v2026_03_02_preview)
+model ClusterMeshProfileProperties {
+  @doc("The provisioning state of the cluster mesh profile.")
+  @visibility(Lifecycle.Read)
+  provisioningState?: ClusterMeshProfileProvisioningState;
+
+  @doc("""
+    Select the members of the mesh.
+      * Only key/value pairs with the `=` operator are accepted in the label selector.
+      * If empty or not specified, no Fleet members will be selected to join the mesh.
+    """)
+  @visibility(Lifecycle.Read, Lifecycle.Create)
+  memberSelector?: MemberSelector;
+
+  @doc("The cluster mesh profile status.")
+  @visibility(Lifecycle.Read)
+  status?: ClusterMeshProfileStatus;
+}
+
+@doc("The provisioning state of the cluster mesh profile resource.")
+@added(Versions.v2026_03_02_preview)
+union ClusterMeshProfileProvisioningState {
+  string,
+  ResourceProvisioningState,
+}
+
+@doc("Cluster mesh state.")
+@added(Versions.v2026_03_02_preview)
+union ClusterMeshState {
+  string,
+
+  @doc("The mesh is not connected.")
+  NotConnected: "NotConnected",
+
+  @doc("The mesh is applying.")
+  Applying: "Applying",
+
+  @doc("The mesh is connected.")
+  Connected: "Connected",
+
+  @doc("The mesh is degraded.")
+  Degraded: "Degraded",
+
+  @doc("The mesh failed to connect.")
+  Failed: "Failed",
+}
+
+@doc("Status of the cluster mesh.")
+@added(Versions.v2026_03_02_preview)
+model ClusterMeshProfileStatus {
+  @doc("The state of the cluster mesh.")
+  @visibility(Lifecycle.Read)
+  state: ClusterMeshState;
+
+  @visibility(Lifecycle.Read)
+  @doc("The last applied MemberSelector for the cluster mesh profile.")
+  lastAppliedMemberSelector?: MemberSelector;
+
+  @visibility(Lifecycle.Read)
+  @doc("The last operation ID for the cluster mesh profile.")
+  lastOperationId?: string;
+
+  @visibility(Lifecycle.Read)
+  @doc("The last operation error of the cluster mesh profile.")
+  lastOperationError?: Azure.ResourceManager.Foundations.ErrorDetail;
+}
+
+@added(Versions.v2026_03_02_preview)
+@armResourceOperations
+interface ClusterMeshProfiles {
+  get is ArmResourceRead<ClusterMeshProfile>;
+
+  createOrUpdate is ArmResourceCreateOrUpdateAsync<
+    ClusterMeshProfile,
+    Azure.ResourceManager.Foundations.BaseParameters<ClusterMeshProfile> &
+      IfMatchParameters<ClusterMeshProfile> &
+      IfNoneMatchParameters<ClusterMeshProfile>,
+    LroHeaders = Azure.Core.Foundations.RetryAfterHeader
+  >;
+
+  delete is ArmResourceDeleteWithoutOkAsync<
+    ClusterMeshProfile,
+    Azure.ResourceManager.Foundations.BaseParameters<ClusterMeshProfile> &
+      IfMatchParameters<ClusterMeshProfile>
+  >;
+
+  listByFleet is ArmResourceListByParent<ClusterMeshProfile>;
+
+  @doc("Applies the cluster mesh profile to selected fleet members.")
+  apply is Azure.ResourceManager.ArmResourceActionAsync<
+    ClusterMeshProfile,
+    void,
+    ClusterMeshProfile,
+    BaseParameters<ClusterMeshProfile> & IfMatchParameters<ClusterMeshProfile>
+  >;
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfileOperations_GenerateUpdateRun.json

@@ -0,0 +1,23 @@
+{
+  "title": "AutoUpgradeProfileOperations_GenerateUpdateRun",
+  "operationId": "AutoUpgradeProfileOperations_GenerateUpdateRun",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rgfleets",
+    "fleetName": "fleet1",
+    "autoUpgradeProfileName": "aup1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "lfte"
+      }
+    },
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://contoso.com/operationstatus"
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_CreateOrUpdate.json

@@ -0,0 +1,78 @@
+{
+  "title": "Create an AutoUpgradeProfile.",
+  "operationId": "AutoUpgradeProfiles_CreateOrUpdate",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rgfleets",
+    "If-Match": "uktvayathbu",
+    "If-None-Match": "vdjolwxnefqamimybcvxxva",
+    "fleetName": "fleet1",
+    "autoUpgradeProfileName": "autoupgradeprofile1",
+    "resource": {
+      "properties": {
+        "channel": "Stable",
+        "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/updateStrategies/strategy1",
+        "nodeImageSelection": {
+          "type": "Latest"
+        },
+        "disabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "channel": "Stable",
+          "provisioningState": "Succeeded",
+          "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/updateStrategies/strategy1",
+          "nodeImageSelection": {
+            "type": "Latest"
+          },
+          "disabled": true
+        },
+        "eTag": "\"EtagValue\"",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/autoUpgradeProfiles/autoupgradeprofile1",
+        "name": "autoupgradeprofile1",
+        "type": "Microsoft.ContainerService/fleets/autoUpgradeProfiles",
+        "systemData": {
+          "createdBy": "someUser",
+          "createdByType": "User",
+          "createdAt": "2022-03-23T05:40:40.657Z",
+          "lastModifiedBy": "someOtherUser",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-03-23T05:40:40.657Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://contoso.com/operationstatus"
+      },
+      "body": {
+        "properties": {
+          "channel": "Stable",
+          "provisioningState": "Succeeded",
+          "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/updateStrategies/strategy1",
+          "nodeImageSelection": {
+            "type": "Latest"
+          },
+          "disabled": true
+        },
+        "eTag": "\"EtagValue\"",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/autoUpgradeProfiles/autoupgradeprofile1",
+        "name": "autoupgradeprofile1",
+        "type": "Microsoft.ContainerService/fleets/autoUpgradeProfiles",
+        "systemData": {
+          "createdBy": "someUser",
+          "createdByType": "User",
+          "createdAt": "2022-03-23T05:40:40.657Z",
+          "lastModifiedBy": "someOtherUser",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-03-23T05:40:40.657Z"
+        }
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_Delete.json

@@ -0,0 +1,20 @@
+{
+  "operationId": "AutoUpgradeProfiles_Delete",
+  "title": "Delete an AutoUpgradeProfile resource.",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "fleetName": "fleet1",
+    "autoUpgradeProfileName": "autoupgradeprofile1"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2026-03-02-preview",
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2026-03-02-preview"
+      }
+    },
+    "204": {}
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_Get.json

@@ -0,0 +1,38 @@
+{
+  "title": "Gets an AutoUpgradeProfile resource.",
+  "operationId": "AutoUpgradeProfiles_Get",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rgfleets",
+    "fleetName": "fleet1",
+    "autoUpgradeProfileName": "autoupgradeprofile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "channel": "Stable",
+          "provisioningState": "Succeeded",
+          "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/updateStrategies/strategy1",
+          "nodeImageSelection": {
+            "type": "Latest"
+          },
+          "disabled": true
+        },
+        "eTag": "\"EtagValue\"",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/autoUpgradeProfiles/autoupgradeprofile1",
+        "name": "autoupgradeprofile1",
+        "type": "Microsoft.ContainerService/fleets/autoUpgradeProfiles",
+        "systemData": {
+          "createdBy": "someUser",
+          "createdByType": "User",
+          "createdAt": "2022-03-23T05:40:40.657Z",
+          "lastModifiedBy": "someOtherUser",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-03-23T05:40:40.657Z"
+        }
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/AutoUpgradeProfiles_ListByFleet.json

@@ -0,0 +1,42 @@
+{
+  "title": "Lists the AutoUpgradeProfile resources by fleet.",
+  "operationId": "AutoUpgradeProfiles_ListByFleet",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rgfleets",
+    "fleetName": "fleet1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/autoUpgradeProfiles/autoupgradeprofile1",
+            "name": "autoupgradeprofile1",
+            "type": "Microsoft.ContainerService/fleets/autoUpgradeProfiles",
+            "systemData": {
+              "createdBy": "@contoso.com",
+              "createdByType": "User",
+              "createdAt": "2023-03-01T01:10:08.395Z",
+              "lastModifiedBy": "@contoso.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2023-03-01T01:10:08.395Z"
+            },
+            "properties": {
+              "provisioningState": "Succeeded",
+              "channel": "Stable",
+              "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgfleets/providers/Microsoft.ContainerService/fleets/fleet1/updateStrategies/strategy1",
+              "nodeImageSelection": {
+                "type": "Latest"
+              },
+              "disabled": true
+            },
+            "eTag": "\"EtagValue\""
+          }
+        ],
+        "nextLink": "http://nextlink.contoso.com"
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/examples/2026-03-02-preview/ClusterMeshProfiles_Apply.json

@@ -0,0 +1,48 @@
+{
+  "title": "Apply a ClusterMeshProfile",
+  "operationId": "ClusterMeshProfiles_Apply",
+  "parameters": {
+    "api-version": "2026-03-02-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rgfleets",
+    "fleetName": "fleet1",
+    "clusterMeshProfileName": "clustermeshprofile1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "provisioningState": "Succeeded",
+          "memberSelector": {
+            "byLabel": "env=production"
+          },
+          "status": {
+            "state": "Connected",
+            "lastAppliedMemberSelector": {
+              "byLabel": "env=production"
+            },
+            "lastOperationId": "12345678-1234-1234-1234-123456789012"
+          }
+        },
+        "eTag": "\"EtagValue\"",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/clusterMeshProfiles/clustermeshprofile1",
+        "name": "clustermeshprofile1",
+        "type": "Microsoft.ContainerService/fleets/clusterMeshProfiles",
+        "systemData": {
+          "createdBy": "someUser",
+          "createdByType": "User",
+          "createdAt": "2022-03-23T05:40:40.657Z",
+          "lastModifiedBy": "someOtherUser",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2022-03-23T05:40:40.657Z"
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2026-03-02-preview",
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2026-03-02-preview"
+      }
+    }
+  }
+}