Warning message for Azure Compute Gallery resources from Api-version 2026-03-03 #32376
Description
Preconditions
- No need to upgrade Python SDK or the Python SDK is ready.
Related command
The warning should be shown for all these commands: https://learn.microsoft.com/en-us/cli/azure/sig/image-version?view=azure-cli-latest#az-sig-image-version-create
Some commands are:
-
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
[--end-of-life-date] -
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
[--end-of-life-date]
Resource Provider
Microsoft.Compute/galleries
Description of Feature or Work Requested
This issue is for adding a warning message in CLI for customers who are using Azure Compute Gallery (ACG) APIs and resources.
ACG team has introduced a new api-version: 2026-03-03. Currently, there are no customers on this api-version, and we expect the customers to onboard to this api-version gradually.
This api-version has a new default behavior in case the customers have not set the "endOfLifeDate" and "blockDeletionBeforeEndOFLife" values for their ACG Image Version resources while creating them.
The "endOfLifeDate" will be set to 6 months in future from the publishing date by default.
The "blockDeletionBeforeEndOfLife" boolean will be set to true by default.
This means that from the new api-version (2026-03-03), ACG APIs will block the deletion of image versions by default till 6 months from the publishing date. If customers use the new api-version, and have a scenario where they need to delete their images before 6 months:
They can set the "endOfLifeDate" accordingly.
Or they can set the "blockDeletionBeforeEndOfLife" boolean to false.
Ask on CLI team: Please add a warning message in CLI so that all the customers know about this breaking change while executing CLI commands. This message should be added:
Warning:
Starting api-version 2026-03-03, gallery image versions will default to:
endOfLifeDate = 6 months from publish date (unless explicitly set)
blockDeletionBeforeEndOfLife = true (unless explicitly set)
By default, image deletion is blocked for 6 months. To override, set a custom endOfLifeDate or set blockDeletionBeforeEndOfLife = false
Minimum API Version Required
2026-03-03
Swagger PR link / SDK link
N/A
This request is for adding a warning message.
Request Example
N/A
This request is for adding a warning message.
Target Date
2026-01-15
PM Contact
Engineer Contact
Additional context
No response