Preconditions
Related command
az vmss update
Resource Provider
Microsoft.Compute/VMSS
Description of Feature or Work Requested
az vmss create already supports --zone-placement-policy, --include-zones, and --exclude-zones for automatic zone placement. There is currently no way to set or change these on an existing scale set via az vmss update.
Request: add --zone-placement-policy, --include-zones, and --exclude-zones to az vmss update so customers can configure/adjust the zone placement profile on an existing VMSS
The same client-side mutual-exclusivity validation requested for create (--include-zones cannot be combined with --exclude-zones) should apply to update as well. #33473
Minimum API Version Required
2025-11-01
Swagger PR link / SDK link
https://learn.microsoft.com/en-us/rest/api/compute/virtual-machine-scale-sets/update?view=rest-compute-2025-11-01&tabs=HTTP#placement
Python SDK link: https://pypi.org/project/azure-mgmt-compute/38.0.0/
Request Example
Impacted CLI Command: az vmss update
"--zone-placement-policy", { "Auto" }
- Whether Automatic Zone Placement with be applied for this VMSS. If customer has ZonePlacementPolicy specified, they cannot have the "zones" list on their VMSS.
"--includeZones", { int list }
- List of zones that must be included when platform is selecting zones. Including a specific zone does not guarantee that instances will be placed in the zone, but the zone will be available for future scale outs.
"--excludeZones", { int list }
- List of zones that must be excluded when selecting zones.
Target Date
2026-07-31
PM Contact
hilarywang
Engineer Contact
raredd, frankpang
Additional context
No response
Preconditions
Related command
az vmss update
Resource Provider
Microsoft.Compute/VMSS
Description of Feature or Work Requested
az vmss create already supports --zone-placement-policy, --include-zones, and --exclude-zones for automatic zone placement. There is currently no way to set or change these on an existing scale set via az vmss update.
Request: add --zone-placement-policy, --include-zones, and --exclude-zones to az vmss update so customers can configure/adjust the zone placement profile on an existing VMSS
The same client-side mutual-exclusivity validation requested for create (--include-zones cannot be combined with --exclude-zones) should apply to update as well. #33473
Minimum API Version Required
2025-11-01
Swagger PR link / SDK link
https://learn.microsoft.com/en-us/rest/api/compute/virtual-machine-scale-sets/update?view=rest-compute-2025-11-01&tabs=HTTP#placement
Python SDK link: https://pypi.org/project/azure-mgmt-compute/38.0.0/
Request Example
Impacted CLI Command: az vmss update
"--zone-placement-policy", { "Auto" }
"--includeZones", { int list }
"--excludeZones", { int list }
Target Date
2026-07-31
PM Contact
hilarywang
Engineer Contact
raredd, frankpang
Additional context
No response