Review request for Microsoft.ContainerService/aks to add version stab…

…le/2024-09-01 (#30901) * Adds base for updating Microsoft.ContainerService/aks from version stable/2024-08-01 to version 2024-09-01 * Updates readme * Updates API version in new specs and examples * feat(retina): update advanced networking api in 2024-09-01 (#30709) * feat(retina): update advanced networking api in 2024-09-01 * remove unexpected comma * Add node resource group lockdown related properties (#30723) * Add nodeResourceGroupProfile * Move to 2024-09-01 --------- Co-authored-by: Yihao Wang <[email protected]> * chore: remove `default` from ContainerServiceNetworkProfile.networkPlugin (#30844) NetworkPlugin will be defaulted based on k8s version rather than API version going forward. The default value in k8s < 1.30 will remain `kubenet` while in 1.30+ it will be CNI Overlay. * Microsoft.ContainerService: clarify BYO Kubelet identity API (#30958) Signed-off-by: Steve Kuznetsov <[email protected]> * Adding etags to AKS RP APIs (#30825) Co-authored-by: indusridhar <[email protected]> --------- Signed-off-by: Steve Kuznetsov <[email protected]> Co-authored-by: Steven Nguyen <[email protected]> Co-authored-by: Yihao Wang <[email protected]> Co-authored-by: Yihao Wang <[email protected]> Co-authored-by: Tyler Lloyd <[email protected]> Co-authored-by: Steve Kuznetsov <[email protected]> Co-authored-by: InduSridhar <[email protected]> Co-authored-by: indusridhar <[email protected]>
Azure · Nov 5, 2024 · ed3e718 · ed3e718
1 parent 1e75340
commit ed3e718
Show file tree

Hide file tree

Showing 113 changed files with 22,713 additions and 3 deletions.
diff --git a/cSpell.json b/cSpell.json
@@ -223,7 +223,8 @@
                 "PDBs",
                 "undrainable",
                 "Undrainable",
-                "acnstls"
+                "acnstls",
+                "kubeletIdentity"
             ]
         },
         {

diff --git a/...containerservice/resource-manager/Microsoft.ContainerService/aks/readme.java.md b/...containerservice/resource-manager/Microsoft.ContainerService/aks/readme.java.md
@@ -105,6 +105,20 @@ batch:
   - tag: package-preview-2024-07
   - tag: package-2024-07
   - tag: package-2024-08
+  - tag: package-2024-09
+```
+
+### Tag: package-2024-09 and java
+
+These settings apply only when `--tag=package-2024-09` 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-09' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.containerservice.v2024_09_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/containerservice/mgmt-v2024_09_01
+regenerate-manager: true
+generate-interface: true
 ```
 
 ### Tag: package-2024-08 and java

diff --git a/...tion/containerservice/resource-manager/Microsoft.ContainerService/aks/readme.md b/...tion/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-2024-08
+tag: package-2024-09
+```
+
+### Tag: package-2024-09
+
+These settings apply only when `--tag=package-2024-09` is specified on the command line.
+
+``` yaml $(tag) == 'package-2024-09'
+input-file:
+  - stable/2024-09-01/managedClusters.json
 ```
 
 ### Tag: package-2024-08

diff --git a/...ntainerservice/resource-manager/Microsoft.ContainerService/aks/readme.python.md b/...ntainerservice/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-08-01"
+default-api-version: "2024-09-01"
 multiapi: true
 batch:
+  - tag: package-2024-09
   - tag: package-2024-08
   - tag: package-2024-07
   - tag: package-preview-2024-07
@@ -112,6 +113,16 @@ perform-load: false
 clear-output-folder: false
 ```
 
+### Tag: package-2024-09 and python
+
+These settings apply only when `--tag=package-2024-09 --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-09' && $(python)
+namespace: azure.mgmt.containerservice.v2024_09_01
+output-folder: $(python-sdks-folder)/containerservice/azure-mgmt-containerservice/azure/mgmt/containerservice/v2024_09_01
+```
+
 ### Tag: package-2024-08 and python
 
 These settings apply only when `--tag=package-2024-08 --python` is specified on the command line.

diff --git a/...r/Microsoft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsAbortOperation.json b/...r/Microsoft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsAbortOperation.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "api-version": "2024-09-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-09-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-09-01"
+      }
+    }
+  }
+}
diff --git a/...nager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_CRG.json b/...nager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_CRG.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2024-09-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"
+        }
+      }
+    }
+  }
+}
diff --git a/...ft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_CustomNodeConfig.json b/...ft.ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_CustomNodeConfig.json
@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "api-version": "2024-09-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
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/....ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_DedicatedHostGroup.json b/....ContainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_DedicatedHostGroup.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "api-version": "2024-09-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"
+        }
+      }
+    }
+  }
+}
diff --git a/...tainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_EnableEncryptionAtHost.json b/...tainerService/aks/stable/2024-09-01/examples/AgentPoolsCreate_EnableEncryptionAtHost.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "api-version": "2024-09-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
+        }
+      }
+    }
+  }
+}