Add 2026-06-15-preview API version for Microsoft.KubernetesConfiguration to add KubernetesResources and UpgradeAssessments

specification/kubernetesconfiguration/resource-manager/Microsoft.KubernetesConfiguration/kubeInventory/KubeInventory.tsp

@@ -0,0 +1,89 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/rest";
+import "./models.tsp";
+
+using TypeSpec.Rest;
+using Azure.Core;
+using Azure.ResourceManager;
+using Azure.ResourceManager.Foundations;
+using TypeSpec.Http;
+
+namespace Microsoft.KubernetesConfiguration;
+
+/**
+ * Singleton container resource grouping cluster inventory reports.
+ */
+model KubeInventory is Azure.ResourceManager.ProxyResource<KubeInventoryProperties> {
+  ...ResourceNameParameter<
+    Resource = KubeInventory,
+    KeyName = "kubeInventoryName",
+    SegmentName = "kubeInventory",
+    NamePattern = ""
+  >;
+}
+
+/**
+ * Operations alias for KubeInventory using the cluster extension routing pattern.
+ * Generates URLs of the form:
+ *   /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/kubeInventory[/{kubeInventoryName}]
+ */
+alias KubeInventoryOps = Azure.ResourceManager.Legacy.ExtensionOperations<
+  {
+    ...ApiVersionParameter;
+    ...SubscriptionIdParameter;
+    ...ResourceGroupParameter;
+
+    /**
+     * The Kubernetes cluster RP - i.e. Microsoft.ContainerService, Microsoft.Kubernetes,
+     * Microsoft.HybridContainerService.
+     */
+    @path
+    @segment("providers")
+    @key
+    clusterRp: string;
+
+    /**
+     * The Kubernetes cluster resource name - i.e. managedClusters, connectedClusters,
+     * provisionedClusters, appliances.
+     */
+    @key
+    @path
+    @pattern("^[a-zA-Z]*$")
+    clusterResourceName: string;
+
+    /**
+     * The name of the kubernetes cluster.
+     */
+    @key
+    @path
+    @pattern("^.*")
+    clusterName: string;
+  },
+  {
+    ...Azure.ResourceManager.Extension.ExtensionProviderNamespace<KubeInventory>;
+    ...ParentKeysOf<KubeInventory>;
+  },
+  {
+    ...Azure.ResourceManager.Extension.ExtensionProviderNamespace<KubeInventory>;
+    ...KeysOf<KubeInventory>;
+  }
+>;
+
+@armResourceOperations(#{ allowStaticRoutes: true, omitTags: true })
+interface KubeInventories {
+  /**
+   * Get the kubeInventory singleton for a cluster.
+   */
+  @tag("KubeInventory")
+  get is KubeInventoryOps.Read<KubeInventory>;
+
+  /**
+   * List kubeInventory containers for the cluster (currently always a single 'default').
+   */
+  @tag("KubeInventory")
+  list is KubeInventoryOps.List<KubeInventory>;
+}
+
+@@doc(KubeInventory.name, "Name of the KubeInventory resource.");
+@@doc(KubeInventory.properties, "Properties of the KubeInventory resource.");

specification/kubernetesconfiguration/resource-manager/Microsoft.KubernetesConfiguration/kubeInventory/UpgradeAssessment.tsp

@@ -0,0 +1,165 @@
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+import "@typespec/rest";
+import "./models.tsp";
+import "./KubeInventory.tsp";
+
+using TypeSpec.Rest;
+using Azure.Core;
+using Azure.ResourceManager;
+using Azure.ResourceManager.Foundations;
+using TypeSpec.Http;
+
+namespace Microsoft.KubernetesConfiguration;
+
+/**
+ * Periodic, cluster-computed Kubernetes upgrade assessment.
+ */
+@parentResource(KubeInventory)
+model UpgradeAssessment is Azure.ResourceManager.ProxyResource<UpgradeAssessmentProperties> {
+  ...ResourceNameParameter<
+    Resource = UpgradeAssessment,
+    KeyName = "assessmentName",
+    SegmentName = "upgradeAssessments",
+    NamePattern = ""
+  >;
+}
+
+/**
+ * Operations alias for UpgradeAssessment using the cluster + KubeInventory extension routing pattern.
+ * Generates URLs of the form:
+ *   .../providers/Microsoft.KubernetesConfiguration/kubeInventory/{kubeInventoryName}/upgradeAssessments[/{assessmentName}]
+ */
+alias UpgradeAssessmentOps = Azure.ResourceManager.Legacy.ExtensionOperations<
+  {
+    ...ApiVersionParameter;
+    ...SubscriptionIdParameter;
+    ...ResourceGroupParameter;
+
+    /**
+     * The Kubernetes cluster RP - i.e. Microsoft.ContainerService, Microsoft.Kubernetes,
+     * Microsoft.HybridContainerService.
+     */
+    @path
+    @segment("providers")
+    @key
+    clusterRp: string;
+
+    /**
+     * The Kubernetes cluster resource name - i.e. managedClusters, connectedClusters,
+     * provisionedClusters, appliances.
+     */
+    @key
+    @path
+    @pattern("^[a-zA-Z]*$")
+    clusterResourceName: string;
+
+    /**
+     * The name of the kubernetes cluster.
+     */
+    @key
+    @path
+    @pattern("^.*")
+    clusterName: string;
+  },
+  {
+    ...Azure.ResourceManager.Extension.ExtensionProviderNamespace<UpgradeAssessment>;
+    ...ParentKeysOf<UpgradeAssessment>;
+  },
+  {
+    ...Azure.ResourceManager.Extension.ExtensionProviderNamespace<UpgradeAssessment>;
+    ...ParentKeysOf<UpgradeAssessment>;
+    ...KeysOf<UpgradeAssessment>;
+  }
+>;
+
+/**
+ * RoutedOperations alias used for the refresh action on a specific UpgradeAssessment instance.
+ * Includes all path params up to and including assessmentName so the action route resolves correctly.
+ */
+alias UpgradeAssessmentBuildingOps = Azure.ResourceManager.Legacy.RoutedOperations<
+  {
+    ...ApiVersionParameter;
+    ...SubscriptionIdParameter;
+    ...ResourceGroupParameter;
+
+    /**
+     * The Kubernetes cluster RP - i.e. Microsoft.ContainerService, Microsoft.Kubernetes,
+     * Microsoft.HybridContainerService.
+     */
+    @path
+    @segment("providers")
+    @key
+    clusterRp: string;
+
+    /**
+     * The Kubernetes cluster resource name - i.e. managedClusters, connectedClusters,
+     * provisionedClusters, appliances.
+     */
+    @key
+    @path
+    @pattern("^[a-zA-Z]*$")
+    clusterResourceName: string;
+
+    /**
+     * The name of the kubernetes cluster.
+     */
+    @key
+    @path
+    @pattern("^.*")
+    clusterName: string;
+
+    ...KeysOf<KubeInventory>;
+    ...KeysOf<UpgradeAssessment>;
+  },
+  {},
+  ResourceRoute = #{
+    route: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/kubeInventory",
+  }
+>;
+
+@armResourceOperations(#{ allowStaticRoutes: true, omitTags: true })
+interface UpgradeAssessments {
+  /**
+   * Get the upgrade assessment for a cluster.
+   */
+  @tag("UpgradeAssessments")
+  get is UpgradeAssessmentOps.Read<UpgradeAssessment>;
+
+  /**
+   * List upgrade assessments under a kubeInventory (currently always a single 'current').
+   */
+  @tag("UpgradeAssessments")
+  list is UpgradeAssessmentOps.List<UpgradeAssessment>;
+
+  /**
+   * Internal write path used by the in-cluster agent to publish or update an upgrade assessment.
+   * End users do NOT have RBAC for this operation; access is restricted to the cluster's managed identity.
+   */
+  @tag("UpgradeAssessments")
+  createOrUpdate is UpgradeAssessmentOps.CreateOrUpdateAsync<UpgradeAssessment>;
+
+  /**
+   * Trigger the in-cluster agent to recompute the upgrade assessment.
+   * Long-running; only one refresh per cluster may be in flight at a time (returns 409 otherwise).
+   */
+  @tag("UpgradeAssessments")
+  @post
+  @route("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/kubeInventory/{kubeInventoryName}/upgradeAssessments/{assessmentName}/refresh")
+  refresh is UpgradeAssessmentBuildingOps.ActionAsync<
+    UpgradeAssessment,
+    RefreshRequest,
+    | ArmAcceptedLroResponse<LroHeaders = ArmCombinedLroHeaders<FinalResult = UpgradeAssessment>>
+    | ArmResponse<UpgradeAssessment>
+  >;
+}
+
+@@doc(UpgradeAssessment.name, "Name of the UpgradeAssessment resource.");
+@@doc(
+  UpgradeAssessment.properties,
+  "Properties of the UpgradeAssessment resource."
+);
+@@doc(
+  UpgradeAssessments.createOrUpdate::parameters.resource,
+  "The UpgradeAssessment resource body."
+);

specification/kubernetesconfiguration/resource-manager/Microsoft.KubernetesConfiguration/kubeInventory/examples/2026-06-15-preview/CreateOrUpdateUpgradeAssessment.json

@@ -0,0 +1,133 @@
+{
+  "title": "Create or Update UpgradeAssessment",
+  "operationId": "UpgradeAssessments_CreateOrUpdate",
+  "parameters": {
+    "subscriptionId": "subId1",
+    "resourceGroupName": "rg1",
+    "clusterRp": "Microsoft.Kubernetes",
+    "clusterResourceName": "connectedClusters",
+    "clusterName": "clusterName1",
+    "kubeInventoryName": "default",
+    "assessmentName": "current",
+    "api-version": "2026-06-15-preview",
+    "resource": {
+      "properties": {
+        "kubernetesVersion": "1.29",
+        "targetKubernetesVersion": "1.30",
+        "overallSeverity": "critical",
+        "componentCompatibility": [
+          {
+            "name": "containerd",
+            "version": "1.6.8",
+            "compatibilityStatus": "incompatible",
+            "severity": "critical",
+            "minCompatibleVersion": "1.7.0",
+            "notes": "containerd 1.6.x is not compatible with Kubernetes 1.30. Upgrade to 1.7.x required."
+          }
+        ],
+        "deprecatedApis": [
+          {
+            "group": "flowcontrol.apiserver.k8s.io",
+            "version": "v1beta3",
+            "resource": "flowschemas",
+            "removedRelease": "1.32",
+            "usageMetrics": {
+              "get": 12,
+              "list": 45
+            },
+            "lastUsageObservedAt": "2026-06-09T14:22:00.000Z",
+            "severity": "warning"
+          }
+        ],
+        "readinessChecks": [
+          {
+            "category": "NodeStatus",
+            "severity": "pass"
+          },
+          {
+            "category": "Storage",
+            "name": "node-pool-1",
+            "severity": "critical",
+            "details": "Node disk pressure detected; upgrade may fail."
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/default/upgradeAssessments/current",
+        "name": "current",
+        "type": "Microsoft.KubernetesConfiguration/kubeInventory/upgradeAssessments",
+        "systemData": {
+          "createdBy": "cluster-managed-identity",
+          "createdByType": "Application",
+          "createdAt": "2026-06-01T10:00:00.000Z",
+          "lastModifiedBy": "cluster-managed-identity",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2026-06-10T09:00:00.000Z"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "assessmentTime": "2026-06-10T09:00:00.000Z",
+          "kubernetesVersion": "1.29",
+          "targetKubernetesVersion": "1.30",
+          "overallSeverity": "critical",
+          "componentCompatibility": [
+            {
+              "name": "containerd",
+              "version": "1.6.8",
+              "compatibilityStatus": "incompatible",
+              "severity": "critical",
+              "minCompatibleVersion": "1.7.0",
+              "notes": "containerd 1.6.x is not compatible with Kubernetes 1.30. Upgrade to 1.7.x required."
+            }
+          ],
+          "deprecatedApis": [
+            {
+              "group": "flowcontrol.apiserver.k8s.io",
+              "version": "v1beta3",
+              "resource": "flowschemas",
+              "removedRelease": "1.32",
+              "usageMetrics": {
+                "get": 12,
+                "list": 45
+              },
+              "lastUsageObservedAt": "2026-06-09T14:22:00.000Z",
+              "severity": "warning"
+            }
+          ],
+          "readinessChecks": [
+            {
+              "category": "NodeStatus",
+              "severity": "pass"
+            },
+            {
+              "category": "Storage",
+              "name": "node-pool-1",
+              "severity": "critical",
+              "details": "Node disk pressure detected; upgrade may fail."
+            }
+          ]
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/default/upgradeAssessments/current/operations/operationId1?api-version=2026-06-15-preview",
+        "Retry-After": 10
+      },
+      "body": {
+        "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/default/upgradeAssessments/current",
+        "name": "current",
+        "type": "Microsoft.KubernetesConfiguration/kubeInventory/upgradeAssessments",
+        "properties": {
+          "provisioningState": "Updating",
+          "kubernetesVersion": "1.29",
+          "targetKubernetesVersion": "1.30"
+        }
+      }
+    }
+  }
+}