Review request for Microsoft.ContainerService/aks to add version stable/2024-05-01

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/readme.java.md

@@ -99,6 +99,20 @@ batch:
   - tag: package-2024-02
   - tag: package-preview-2024-03
   - tag: package-preview-2024-04
+  - tag: package-2024-05
+```
+
+### Tag: package-2024-05 and java
+
+These settings apply only when `--tag=package-2024-05` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2024-05' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.containerservice.v2024_05_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/containerservice/mgmt-v2024_05_01
+regenerate-manager: true
+generate-interface: true
 ```
 
 ### Tag: package-preview-2024-04 and java

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/readme.md

@@ -34,7 +34,16 @@ These are the global settings for the ContainerServices API.
 
 ``` yaml
 openapi-type: arm
-tag: package-preview-2024-04
+tag: package-2024-05
+```
+
+### Tag: package-2024-05
+
+These settings apply only when `--tag=package-2024-05` is specified on the command line.
+
+``` yaml $(tag) == 'package-2024-05'
+input-file:
+  - stable/2024-05-01/managedClusters.json
 ```
 
 ### Tag: package-preview-2024-04

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/readme.python.md

@@ -16,9 +16,10 @@ no-namespace-folders: true
 Generate all API versions currently shipped for this package
 
 ```yaml $(python)
-default-api-version: "2024-04-02-preview"
+default-api-version: "2024-05-01"
 multiapi: true
 batch:
+  - tag: package-2024-05
   - tag: package-preview-2024-04
   - tag: package-preview-2024-03
   - tag: package-2024-02
@@ -106,6 +107,16 @@ perform-load: false
 clear-output-folder: false
 ```
 
+### Tag: package-2024-05 and python
+
+These settings apply only when `--tag=package-2024-05 --python` is specified on the command line.
+Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
+
+``` yaml $(tag) == 'package-2024-05' && $(python)
+namespace: azure.mgmt.containerservice.v2024_05_01
+output-folder: $(python-sdks-folder)/containerservice/azure-mgmt-containerservice/azure/mgmt/containerservice/v2024_05_01
+```
+
 ### Tag: package-preview-2024-04 and python
 
 These settings apply only when `--tag=package-preview-2024-04 --python` is specified on the command line.

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/sdk-suppressions.yaml

@@ -2,9 +2,17 @@ suppressions:
   azure-sdk-for-go:
     - package: 'sdk/resourcemanager/containerservice/armcontainerservice'
       breaking-changes:
-        - Field `NodeSelector` of struct `IstioEgressGateway` has been removed
+        - Function `*ManagedClustersClient.GetOSOptions` has been removed
+        - Struct `OSOptionProfile` has been removed
+        - Struct `OSOptionPropertyList` has been removed
+        - Struct `OSOptionProperty` has been removed
   azure-sdk-for-python:
     - package: azure-mgmt-containerservice
       breaking-changes:
+        - Removed operation ManagedClustersOperations.get_os_options
         - Model ManagedClusterAzureMonitorProfileAppMonitoring no longer has parameter enabled
         - Model ManagedClusterAzureMonitorProfileContainerInsights no longer has parameter windows_host_logs
+  azure-sdk-for-js:
+    - package: '@azure/arm-containerservice'
+      breaking-changes:
+        - Removed operation ManagedClusters.getOSOptions

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-05-01/examples/AgentPoolsAbortOperation.json

@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2024-05-01",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1"
+  },
+  "responses": {
+    "204": {},
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2024-05-01",
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/eastus/operationStatus/00000000-0000-0000-0000-000000000000?api-version=2024-05-01"
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-05-01/examples/AgentPoolsCreate_CRG.json

@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2024-05-01",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "count": 3,
+        "vmSize": "Standard_DS2_v2",
+        "osType": "Linux",
+        "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.9.6",
+          "currentOrchestratorVersion": "1.9.6",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Creating",
+          "orchestratorVersion": "1.9.6",
+          "currentOrchestratorVersion": "1.9.6",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
+        }
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-05-01/examples/AgentPoolsCreate_CustomNodeConfig.json

@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "api-version": "2024-05-01",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "count": 3,
+        "vmSize": "Standard_DS2_v2",
+        "osType": "Linux",
+        "kubeletConfig": {
+          "cpuManagerPolicy": "static",
+          "cpuCfsQuota": true,
+          "cpuCfsQuotaPeriod": "200ms",
+          "imageGcHighThreshold": 90,
+          "imageGcLowThreshold": 70,
+          "topologyManagerPolicy": "best-effort",
+          "allowedUnsafeSysctls": [
+            "kernel.msg*",
+            "net.core.somaxconn"
+          ],
+          "failSwapOn": false
+        },
+        "linuxOSConfig": {
+          "sysctls": {
+            "netCoreWmemDefault": 12345,
+            "netIpv4TcpTwReuse": true,
+            "netIpv4IpLocalPortRange": "20000 60000",
+            "kernelThreadsMax": 99999
+          },
+          "transparentHugePageEnabled": "always",
+          "transparentHugePageDefrag": "madvise",
+          "swapFileSizeMB": 1500
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.17.8",
+          "currentOrchestratorVersion": "1.17.8",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "kubeletConfig": {
+            "cpuManagerPolicy": "static",
+            "cpuCfsQuota": true,
+            "cpuCfsQuotaPeriod": "200ms",
+            "imageGcHighThreshold": 90,
+            "imageGcLowThreshold": 70,
+            "topologyManagerPolicy": "best-effort",
+            "allowedUnsafeSysctls": [
+              "kernel.msg*",
+              "net.core.somaxconn"
+            ],
+            "failSwapOn": false
+          },
+          "linuxOSConfig": {
+            "sysctls": {
+              "netCoreWmemDefault": 12345,
+              "netIpv4TcpTwReuse": true,
+              "netIpv4IpLocalPortRange": "20000 60000",
+              "kernelThreadsMax": 99999
+            },
+            "transparentHugePageEnabled": "always",
+            "transparentHugePageDefrag": "madvise",
+            "swapFileSizeMB": 1500
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Creating",
+          "orchestratorVersion": "1.17.8",
+          "currentOrchestratorVersion": "1.17.8",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "kubeletConfig": {
+            "cpuManagerPolicy": "static",
+            "cpuCfsQuota": true,
+            "cpuCfsQuotaPeriod": "200ms",
+            "imageGcHighThreshold": 90,
+            "imageGcLowThreshold": 70,
+            "topologyManagerPolicy": "best-effort",
+            "allowedUnsafeSysctls": [
+              "kernel.msg*",
+              "net.core.somaxconn"
+            ],
+            "failSwapOn": false,
+            "podMaxPids": 100
+          },
+          "linuxOSConfig": {
+            "sysctls": {
+              "netCoreWmemDefault": 65536,
+              "netIpv4TcpTwReuse": true,
+              "netIpv4IpLocalPortRange": "20000 60000",
+              "kernelThreadsMax": 99999
+            },
+            "transparentHugePageEnabled": "always",
+            "transparentHugePageDefrag": "madvise",
+            "swapFileSizeMB": 1500
+          }
+        }
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-05-01/examples/AgentPoolsCreate_DedicatedHostGroup.json

@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "api-version": "2024-05-01",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "count": 3,
+        "vmSize": "Standard_DS2_v2",
+        "osType": "Linux",
+        "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.19.6",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Creating",
+          "orchestratorVersion": "1.19.6",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
+        }
+      }
+    }
+  }
+}

specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-05-01/examples/AgentPoolsCreate_EnableEncryptionAtHost.json

@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2024-05-01",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "count": 3,
+        "vmSize": "Standard_DS2_v2",
+        "osType": "Linux",
+        "enableEncryptionAtHost": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.17.13",
+          "currentOrchestratorVersion": "1.17.13",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "enableEncryptionAtHost": true
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Creating",
+          "orchestratorVersion": "1.17.13",
+          "currentOrchestratorVersion": "1.17.13",
+          "count": 3,
+          "vmSize": "Standard_DS2_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "enableEncryptionAtHost": true
+        }
+      }
+    }
+  }
+}