Check Azure Compute Gallery names before creating the sharing resource

Source facts

Microsoft permits letters, numbers, periods, and underscores in a Compute Gallery name, but excludes hyphens. The gallery name must be unique across the subscription. A gallery is the top-level resource used to group and share resources such as VM images and application packages. Microsoft Learn

Applicability

This applies to teams creating a Compute Gallery and deciding its resource name before adding images or application packages to it.

DSE recommendation

DSE recommends checking the proposed gallery name against both the naming rules and the subscription inventory before submitting the deployment. Keep the gallery name distinct from the names of image definitions and versions in the request. Record the subscription, resource group, region, and intended sharing audience together. If an internal naming pattern uses hyphens, agree the gallery-specific spelling before dependent deployment templates are written.

Verification

Inspect the deployment result and verify that the gallery appears in the intended subscription and resource group with the agreed name. Have the deployment owner compare the returned resource identifier with the request. Treat successful creation as the completion of this naming check; review sharing permissions and image content through their own acceptance steps.

Official references

• Microsoft: Create a Gallery for Sharing Resources – Azure Virtual Machines | Microsoft Learn