Preannournce BC in AKS sku (#27420)

isra-fel · notyashhh · web-flow · commit a82ac4262e15 · 2025-03-25T14:24:22.000+11:00
Co-authored-by: Yash &lt;55773468+notyashhh@users.noreply.github.com&gt;
diff --git a/src/Aks/Aks.Autorest/README.md b/src/Aks/Aks.Autorest/README.md
@@ -139,7 +139,7 @@ directive:
         change-description: 
           - The type of property 'TimeInWeek' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IMaintenanceConfiguration' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.ITimeInWeek[]' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.ITimeInWeek]'
           - The type of property 'NotAllowedTime' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IMaintenanceConfiguration' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.ITimeSpan' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.ITimeSpan]'
-        deprecated-by-version: 2.0.0
+        deprecated-by-version: 7.0.0
         deprecated-by-azversion: 14.0.0
         change-effective-date: 2025/05/19
 
@@ -156,7 +156,7 @@ directive:
           - OSOptionPropertyList System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOSOptionProperty]
         change-description: 
           - The type of property 'OSOptionPropertyList' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IOSOptionProfile' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOSOptionProperty' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOSOptionProperty]'.
-        deprecated-by-version: 2.0.0
+        deprecated-by-version: 7.0.0
         deprecated-by-azversion: 14.0.0
         change-effective-date: 2025/05/19
 
@@ -173,7 +173,7 @@ directive:
           - Endpoint System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IEndpointDependency]
         change-description: 
           - The type of property 'Endpoint' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IOutboundEnvironmentEndpoint' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IEndpointDependency' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IEndpointDependency]'.
-        deprecated-by-version: 2.0.0
+        deprecated-by-version: 7.0.0
         deprecated-by-azversion: 14.0.0
         change-effective-date: 2025/05/19
 
@@ -190,7 +190,7 @@ directive:
           - Upgrade System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IAgentPoolUpgradeProfilePropertiesUpgradesItem]
         change-description: 
           - The type of property 'Upgrade' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IAgentPoolUpgradeProfile' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IAgentPoolUpgradeProfilePropertiesUpgradesItem' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IAgentPoolUpgradeProfilePropertiesUpgradesItem]'.
-        deprecated-by-version: 2.0.0
+        deprecated-by-version: 7.0.0
         deprecated-by-azversion: 14.0.0
         change-effective-date: 2025/05/19
 
@@ -210,7 +210,7 @@ directive:
         change-description: 
           - The type of property 'AgentPoolProfile' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IManagedClusterUpgradeProfile' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IManagedClusterPoolUpgradeProfile' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IManagedClusterPoolUpgradeProfile]'.
           - The type of property 'ControlPlaneProfileUpgrade' of type 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20230201.IManagedClusterUpgradeProfile' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IManagedClusterPoolUpgradeProfileUpgradesItem' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IManagedClusterPoolUpgradeProfileUpgradesItem]'.
-        deprecated-by-version: 2.0.0
+        deprecated-by-version: 7.0.0
         deprecated-by-azversion: 14.0.0
         change-effective-date: 2025/05/19
 ```
diff --git a/src/Aks/Aks.Autorest/custom/Get-AzAksVersion.ps1 b/src/Aks/Aks.Autorest/custom/Get-AzAksVersion.ps1
@@ -24,7 +24,7 @@ The operation returns properties of each orchestrator including version, availab
 #>
 function Get-AzAksVersion {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20190801.IOrchestratorVersionProfileListResult])]
-    [Microsoft.Azure.PowerShell.Cmdlets.Aks.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20190801.IOrchestratorVersionProfileListResult", "14.0.0", "2.0.0", "2025/05/19", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfileListResult", DeprecatedOutputProperties = ("Orchestrator Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfile"), NewOutputProperties = ("Orchestrator System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfile]"))]
+    [Microsoft.Azure.PowerShell.Cmdlets.Aks.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.Api20190801.IOrchestratorVersionProfileListResult", "14.0.0", "7.0.0", "2025/05/19", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfileListResult", DeprecatedOutputProperties = ("Orchestrator Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfile"), NewOutputProperties = ("Orchestrator System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Aks.Models.IOrchestratorVersionProfile]"))]
     [CmdletBinding(DefaultParameterSetName='List', PositionalBinding=$false)]
     param(
         [Parameter(Mandatory)]
diff --git a/src/Aks/Aks/ChangeLog.md b/src/Aks/Aks/ChangeLog.md
@@ -18,6 +18,7 @@
         - Additional information about change #1
 -->
 ## Upcoming Release
+* Preannounced breaking change: The default value of `-NodeVmSize` parameter of `New-AzAksCluster` will be changing from 'Standard_DS2_V2 (Linux), Standard_DS2_V3 (Windows)' to being dynamically selected by the AKS resource provider based on quota and capacity in the next major release.
 * The code base is going to be refactored, the following cmdlet adds a BreakingChange announcement:
   * `Get-AzAksMaintenanceConfiguration`
   * `Get-AzAksManagedClusterOSOption`
diff --git a/src/Aks/Aks/Commands/NewAzureRmAks.cs b/src/Aks/Aks/Commands/NewAzureRmAks.cs
@@ -35,6 +35,7 @@
 namespace Microsoft.Azure.Commands.Aks
 {
     [Cmdlet("New", ResourceManager.Common.AzureRMConstants.AzureRMPrefix + "AksCluster", DefaultParameterSetName = DefaultParamSet, SupportsShouldProcess = true)]
+    [GenericBreakingChangeWithVersion("The default value of -NodeVmSize will be changing from 'Standard_DS2_V2 (Linux), Standard_DS2_V3 (Windows)' to being dynamically selected by the AKS resource provider based on quota and capacity.", "14.0.0", "7.0.0")]
     [OutputType(typeof(PSKubernetesCluster))]
     public class NewAzureRmAks : CreateOrUpdateKubeBase
     {

Original file line number	Diff line number	Diff line change
`@@ -35,6 +35,7 @@`
`35`	`35`	`namespace Microsoft.Azure.Commands.Aks`
`36`	`36`	`{`
`37`	`37`	`[Cmdlet("New", ResourceManager.Common.AzureRMConstants.AzureRMPrefix + "AksCluster", DefaultParameterSetName = DefaultParamSet, SupportsShouldProcess = true)]`
	`38`	`+ [GenericBreakingChangeWithVersion("The default value of -NodeVmSize will be changing from 'Standard_DS2_V2 (Linux), Standard_DS2_V3 (Windows)' to being dynamically selected by the AKS resource provider based on quota and capacity.", "14.0.0", "7.0.0")]`
`38`	`39`	`[OutputType(typeof(PSKubernetesCluster))]`
`39`	`40`	`public class NewAzureRmAks : CreateOrUpdateKubeBase`
`40`	`41`	`{`