Create a gallery for storing and sharing resources

1. Sign in to the Azure portal.

2. Enter Azure Compute Gallery in the search box, and select Azure Compute Gallery in the results.

3. On the Azure Compute Gallery page, select Add.

4. On the Create Azure compute gallery pane, select the correct subscription.

5. For Resource group, select a resource group from the dropdown list. Or, select Create new and enter a name for the new resource group.

6. For Name, enter a name for the gallery.

7. For Region, select a region from the dropdown list.

8. You can enter a short description of the gallery, like My gallery for testing. Then select Review + create.

9. After validation passes, select Create.

10. When the deployment finishes, select Go to resource.

Create a gallery by using az sig create. The following example creates a resource group named myGalleryRG in East US, and a gallery named myGallery:

az group create --name myGalleryRG --location eastus
az sig create --resource-group myGalleryRG --gallery-name myGallery

Create a gallery by using New-AzGallery. The following example creates a gallery named myGallery in the myGalleryRG resource group:

$resourceGroup = New-AzResourceGroup `
   -Name 'myGalleryRG' `
   -Location 'West Central US'  
$gallery = New-AzGallery `
   -GalleryName 'myGallery' `
   -ResourceGroupName $resourceGroup.ResourceGroupName `
   -Location $resourceGroup.Location `
   -Description 'Azure Compute Gallery for my organization'  

Use the REST API to create a resource group:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01

{
  "location": "eastus"
}

Use the REST API to create a gallery:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2019-12-01

{
  "properties": {
    "description": "Azure Compute Gallery for my organization"
  },
  "location": "eastus",
}

1. Sign in to the Azure portal.

2. Enter Azure Compute Gallery in the search box, and select Azure Compute Gallery in the results.

3. On the Azure Compute Gallery page, select Add.

4. On the Create Azure compute gallery pane, on the Basics tab, select the correct subscription.

5. Complete all of the details on the Basics tab.

6. At the bottom of the pane, select Next: Sharing method.

   

7. On the Sharing tab, select RBAC + share directly.

   

8. When you finish, select Review + create.

9. After validation passes, select Create.

10. When the deployment finishes, select Go to resource.

To start sharing the gallery with a subscription or tenant, see Share a gallery with a subscription or tenant.

To create a gallery that you can share with a subscription or tenant by using a direct shared gallery, you need to create the gallery with the --permissions parameter set to groups:

az sig create \
   --gallery-name myGallery \
   --permissions groups \
   --resource-group myResourceGroup  

To start sharing the gallery with a subscription or tenant, see Share a gallery with a subscription or tenant.

Create a gallery for subscription-level or tenant-level sharing by using the Azure REST API:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}?api-version=2020-09-30

{
  "properties": {
    "sharingProfile": {
      "permissions": "Groups"
    }
  },
  "location": "{location}
}

To start sharing the gallery with a subscription or tenant, see Share a gallery with a subscription or tenant.

Reset sharing to clear everything in sharingProfile:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{galleryName}/share?api-version=2020-09-30 

{ 
 "operationType" : "Reset", 
} 

Use the --public-name-prefix value to create a name for the public version of your gallery. The --public-name-prefix value is the first part of the public name. The last part is a GUID, created by the platform, that's unique to your gallery.

location=westus
galleryName=contosoGallery
resourceGroup=myCGRG
publisherUri=https://www.contoso.com
publisherEmail=support@contoso.com
eulaLink=https://www.contoso.com/eula
prefix=ContosoImages

az group create --name $resourceGroup --location $location

az sig create \
   --gallery-name $galleryName \
   --permissions community \
   --resource-group $resourceGroup \
   --publisher-uri $publisherUri \
   --publisher-email $publisherEmail \
   --eula $eulaLink \
   --public-name-prefix $prefix

The output of this command gives you the public name for your community gallery in the sharingProfile section, under publicNames.

To start sharing the gallery to all Azure users, see Share images by using a community gallery.

To create a gallery, submit a PUT request:

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2021-10-01

Specify permissions as Community and information about your gallery in the request body:

{
  "location": "West US",
  "properties": {
    "description": "This is the gallery description.",
    "sharingProfile": {
      "permissions": "Community",
      "communityGalleryInfo": {
        "publisherUri": "http://www.uri.com",
        "publisherContact": "contact@domain.com",
        "eula": "http://www.uri.com/terms",
        "publicNamePrefix": "Prefix"
      }
    }
  }
}

To start sharing the gallery with all Azure users, see Share images by using a community gallery.

Making a community gallery available to all Azure users is a two-step process. First, you create the gallery with community sharing enabled. When you're ready to make the gallery public, you share it.

1. Sign in to the Azure portal.

2. Enter Azure Compute Gallery in the search box, and select Azure Compute Gallery in the results.

3. On the Azure Compute Gallery page, select Add.

4. On the Create Azure compute gallery pane, on the Basics tab, select the correct subscription.

5. For Resource group, select Create new and enter myGalleryRG for the name.

6. For Name, enter myGallery for the name of the gallery.

7. For Region, leave the default value.

8. You can enter a short description of the gallery, like My gallery for testing.

9. At the bottom of the pane, select Next: Sharing method.

   

10. On the Sharing tab, select RBAC + share to public community gallery.

    

11. For Community gallery prefix, enter a prefix that will be appended to a GUID to create the unique name for your community gallery.

12. For Publisher email, enter a valid e-mail address that can be used to communicate with you about the gallery.

13. For Publisher URL, enter the URL for a site where users can get more information about the images in your community gallery.

14. For Legal Agreement URL, enter the URL for a site where users can find legal terms for the image.

15. When you finish, select Review + create.

    

16. After validation passes, select Create.

17. When the deployment finishes, select Go to resource.

To see the public name of your gallery, select Sharing on the left menu.

To start sharing the gallery to all Azure users, see Share images by using a community gallery.