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

specification/kubernetesconfiguration/cspell.yaml

@@ -8,10 +8,19 @@ version: '0.2'
 import:
   - ../../cspell.yaml
 words:
+  - armkubeinventory
+  - gvisor
+  - healthz
+  - kata
+  - kubeinventory
   - kubernetesconfiguration
+  - kubelet
   - kustomization
   - kustomizations
   - kustomize
+  - millicores
+  - Misscheduled
   - oidc
+  - readyz
   - rpns
 

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

@@ -0,0 +1,91 @@
+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 = "^[a-z]([a-z0-9._-]{0,126}[a-z0-9])?$"
+  >;
+}
+
+/**
+ * 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, Microsoft.KubernetesConfiguration.
+     */
+    @path
+    @segment("providers")
+    @key
+    @pattern("^Microsoft\\.(ContainerService|Kubernetes|HybridContainerService|KubernetesConfiguration)$")
+    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("^[a-zA-Z0-9][a-zA-Z0-9-_.]{0,62}$")
+    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/examples/2026-06-15-preview/GetKubeInventory-CSIStorageCapacity.json

@@ -0,0 +1,64 @@
+{
+  "title": "Get KubeInventory - CSIStorageCapacity",
+  "operationId": "KubeInventories_Get",
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000001",
+    "resourceGroupName": "rg1",
+    "clusterRp": "Microsoft.Kubernetes",
+    "clusterResourceName": "connectedClusters",
+    "clusterName": "clusterName1",
+    "kubeInventoryName": "csistoragecapacity-managed-premium-pool1-kube-system",
+    "api-version": "2026-06-15-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/csistoragecapacity-managed-premium-pool1-kube-system",
+        "name": "csistoragecapacity-managed-premium-pool1-kube-system",
+        "type": "Microsoft.KubernetesConfiguration/kubeInventory",
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2026-06-01T10:00:00.000Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2026-06-01T10:00:00.000Z"
+        },
+        "properties": {
+          "apiVersion": "storage.k8s.io/v1",
+          "kind": "CSIStorageCapacity",
+          "metadata": {
+            "name": "managed-premium-pool1",
+            "namespaceName": "kube-system",
+            "uid": "a7b8c9d0-e1f2-3456-abcd-789012345678",
+            "resourceVersion": "4567890",
+            "generation": 1,
+            "creationTimestamp": "2026-04-01T06:00:00Z",
+            "labels": [
+              {
+                "name": "csi.storage.k8s.io/storageclass",
+                "value": "managed-premium"
+              }
+            ]
+          },
+          "spec": {
+            "storageClassName": "managed-premium",
+            "storageCapacityAvailable": "512Gi",
+            "maximumVolumeSize": "4Ti",
+            "additionalFields": [
+              {
+                "name": "nodeTopology.matchLabels.topology.kubernetes.io/zone",
+                "value": "eastus-1"
+              },
+              {
+                "name": "nodeTopology.matchLabels.kubernetes.io/hostname",
+                "value": "aks-nodepool1-12345678-vmss000000"
+              }
+            ]
+          },
+          "attachedToExtension": "azure-kube-inventory"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,78 @@
+{
+  "title": "Get KubeInventory - CertificateSigningRequest",
+  "operationId": "KubeInventories_Get",
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000001",
+    "resourceGroupName": "rg1",
+    "clusterRp": "Microsoft.Kubernetes",
+    "clusterResourceName": "connectedClusters",
+    "clusterName": "clusterName1",
+    "kubeInventoryName": "certificatesigningrequest-myapp-node-client",
+    "api-version": "2026-06-15-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/certificatesigningrequest-myapp-node-client",
+        "name": "certificatesigningrequest-myapp-node-client",
+        "type": "Microsoft.KubernetesConfiguration/kubeInventory",
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2026-06-01T10:00:00.000Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2026-06-01T10:00:00.000Z"
+        },
+        "properties": {
+          "apiVersion": "certificates.k8s.io/v1",
+          "kind": "CertificateSigningRequest",
+          "metadata": {
+            "name": "myapp-node-client",
+            "uid": "f6a7b8c9-d0e1-2345-fabc-678901234567",
+            "resourceVersion": "3456789",
+            "generation": 1,
+            "creationTimestamp": "2026-05-20T09:30:00Z",
+            "labels": [
+              {
+                "name": "app",
+                "value": "myapp"
+              }
+            ]
+          },
+          "spec": {
+            "csrSignerName": "kubernetes.io/kube-apiserver-client",
+            "csrUsername": "system:serviceaccount:default:myapp-sa",
+            "csrUsages": [
+              "client auth",
+              "digital signature",
+              "key encipherment"
+            ],
+            "csrExpirationSeconds": 86400
+          },
+          "status": {
+            "conditions": [
+              {
+                "type": "Approved",
+                "status": "True",
+                "reason": "KubectlApprove",
+                "message": "This CSR was approved by kubectl certificate approve.",
+                "lastTransitionTime": "2026-05-20T09:31:00Z"
+              }
+            ]
+          },
+          "events": [
+            {
+              "type": "Normal",
+              "reason": "CertificateIssued",
+              "age": "16d",
+              "from": "certificatesigningrequest-controller",
+              "message": "Signed certificate from signer kubernetes.io/kube-apiserver-client"
+            }
+          ],
+          "attachedToExtension": "azure-kube-inventory"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,84 @@
+{
+  "title": "Get KubeInventory - ConfigMap",
+  "operationId": "KubeInventories_Get",
+  "parameters": {
+    "subscriptionId": "00000000-0000-0000-0000-000000000001",
+    "resourceGroupName": "rg1",
+    "clusterRp": "Microsoft.Kubernetes",
+    "clusterResourceName": "connectedClusters",
+    "clusterName": "clusterName1",
+    "kubeInventoryName": "configmap-app-config-default",
+    "api-version": "2026-06-15-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subId1/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/clusterName1/providers/Microsoft.KubernetesConfiguration/kubeInventory/configmap-app-config-default",
+        "name": "configmap-app-config-default",
+        "type": "Microsoft.KubernetesConfiguration/kubeInventory",
+        "systemData": {
+          "createdBy": "string",
+          "createdByType": "Application",
+          "createdAt": "2026-06-01T10:00:00.000Z",
+          "lastModifiedBy": "string",
+          "lastModifiedByType": "Application",
+          "lastModifiedAt": "2026-06-01T10:00:00.000Z"
+        },
+        "properties": {
+          "apiVersion": "v1",
+          "kind": "ConfigMap",
+          "metadata": {
+            "name": "app-config",
+            "namespaceName": "default",
+            "uid": "d4e5f6a7-b8c9-0123-defa-456789012345",
+            "resourceVersion": "1234567",
+            "generation": 1,
+            "creationTimestamp": "2026-05-01T12:00:00Z",
+            "labels": [
+              {
+                "name": "app",
+                "value": "myapp"
+              },
+              {
+                "name": "environment",
+                "value": "production"
+              }
+            ],
+            "annotations": [
+              {
+                "name": "kubectl.kubernetes.io/last-applied-configuration",
+                "value": "{}"
+              }
+            ]
+          },
+          "spec": {
+            "configMapData": [
+              {
+                "name": "DATABASE_HOST",
+                "value": "postgres.default.svc.cluster.local"
+              },
+              {
+                "name": "DATABASE_PORT",
+                "value": "5432"
+              },
+              {
+                "name": "LOG_LEVEL",
+                "value": "info"
+              },
+              {
+                "name": "FEATURE_FLAGS",
+                "value": "feature-a=true,feature-b=false"
+              }
+            ],
+            "configMapBinaryDataKeys": [
+              "tls.crt",
+              "tls.key"
+            ],
+            "configMapImmutable": false
+          },
+          "attachedToExtension": "azure-kube-inventory"
+        }
+      }
+    }
+  }
+}