Galeri kaynaklarını listeleme, güncelleştirme ve silme

Makale
10/15/2024

Azure CLI veya Azure PowerShell kullanarak Azure İşlem Galerisi (eski adıyla Paylaşılan Görüntü Galerisi) kaynaklarınızı yönetebilirsiniz.

Sizinle paylaşılan galerileri listeleme

Aboneliğinizle paylaşılan Galerileri listeleyin.

region=westus
az sig list-shared --location $region

Kiracınızla paylaşılan Galerileri listeleyin.

region=westus
az sig list-shared --location $region --shared-to tenant

Çıkış, ortak ve uniqueID sizinle paylaşılan galeriyi içerirname. Galeri aracılığıyla kullanılabilen görüntüleri sorgulamak için galerinin adını kullanabilirsiniz.

Örnek çıktı aşağıda verilmiştir:

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

Abonelikle paylaşılan galerileri listeleme.

GET
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30

Yanıt şuna benzer görünmelidir:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueId": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
}

Kiracıyla paylaşılan galerileri listeleyin.

GET
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30&sharedTo=tenant

Yanıt şuna benzer görünmelidir:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
} 

---

## List your gallery information

### [CLI](#tab/cli)

Get the location, status and other information about your image galleries using [az sig list](/cli/azure/sig#az-sig-list).

```azurecli-interactive 
az sig list -o table

Görüntü tanımlarını listeleme

az sig image-definition list komutunu kullanarak galerinizdeki görüntü tanımlarını listeleyin.

az sig image-definition list --resource-group myGalleryRG --gallery-name myGallery -o table

Görüntü sürümlerini listeleme

Az sig image-version list komutunu kullanarak galerinizdeki görüntü sürümlerini listeleyin:

az sig image-version list --resource-group myGalleryRG --gallery-name myGallery --gallery-image-definition myImageDefinition -o table

Belirli bir görüntü sürümünü alma

az sig image-version show komutunu kullanarak galerinizdeki belirli bir görüntü sürümünün kimliğini alın.

az sig image-version show \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --query "id"

Tüm galerileri ada göre listeleyin.

$galleries = Get-AzResource -ResourceType Microsoft.Compute/galleries
$galleries.Name

Tüm görüntü tanımlarını ada göre listeleyin.

$imageDefinitions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images
$imageDefinitions.Name

Tüm görüntü sürümlerini ada göre listeleyin.

$imageVersions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images/versions
$imageVersions.Name

Görüntü sürümünü silme. Bu örnek, 1.0.0 adlı görüntü sürümünü siler.

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName myImageDefinition `
   -GalleryName myGallery `
   -Name 1.0.0 `
   -ResourceGroupName myGalleryRG

Kaynakları güncelleştirme

Güncelleştirilebilecek öğelerle ilgili bazı sınırlamalar vardır. Aşağıdaki öğeler güncelleştirilebilir:

Azure İşlem Galerisi:

Açıklama

Görüntü tanımı:

Önerilen vCPU'lar
Önerilen bellek
Açıklama
Kullanım süresi sonu tarihi

Görüntü sürümü:

Bölgesel çoğaltma sayısı
Hedef bölgeler
En son dışlama
Kullanım süresi sonu tarihi

CLI
PowerShell

(az sig update) kullanarak galerinin açıklamasını güncelleştirin.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

az sig image-definition update komutunu kullanarak bir görüntü tanımının açıklamasını güncelleştirin.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

Az sig image-version update kullanarak çoğaltılması gereken bir bölge eklemek için görüntü sürümünü güncelleştirin. Görüntü yeni bölgeye çoğaltılırken bu değişiklik biraz zaman alır.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

Bu örnekte, bu görüntü sürümünün en son görüntü olarak kullanılmasının dışında tutmak için az sig image-version update'in nasıl kullanılacağı gösterilmektedir.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

Bu örnekte, en son görüntü için dikkate alındığında bu görüntü sürümünü dahil etmek için az sig image-version update'in nasıl kullanılacağı gösterilmektedir.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

Galerinin açıklamasını güncelleştirmek için Update-AzGallery kullanın.

Update-AzGallery `
   -Name $gallery.Name ` 
   -ResourceGroupName $resourceGroup.Name

Bu örnekte, görüntü tanımımızın kullanım süresi sonu tarihini güncelleştirmek için Update-AzGalleryImageDefinition komutunun nasıl kullanılacağı gösterilmektedir.

Update-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -Name $galleryImage.Name `
   -ResourceGroupName $resourceGroup.Name `
   -EndOfLifeDate 01/01/2030

Bu örnekte, bu görüntü sürümünün en son görüntü olarak kullanılmasının dışında tutmak için Update-AzGalleryImageVersion'ın nasıl kullanılacağı gösterilmektedir.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest

Bu örnekte, bu görüntü sürümünün en son görüntü için dikkate alınmasını sağlamak için Update-AzGalleryImageVersion'ın nasıl kullanılacağı gösterilmektedir.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest:$false

Kaynakları silme

Önce görüntü sürümünü silerek kaynakları ters sırada silmeniz gerekir. Tüm görüntü sürümlerini sildikten sonra görüntü tanımını silebilirsiniz. Tüm görüntü tanımlarını sildikten sonra galeriyi silebilirsiniz.

CLI
PowerShell

Topluluk paylaşılan galerisini silebilmeniz için önce galeriyi genel olarak paylaşmayı durdurmak için az sig share reset komutunu kullanmanız gerekir.

az sig image-version delete komutunu kullanarak bir görüntü sürümünü silin.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

az sig image-definition delete komutunu kullanarak bir görüntü tanımını silin.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

az sig delete komutunu kullanarak galeriyi silin.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

$resourceGroup = "myResourceGroup"
$gallery = "myGallery"
$imageDefinition = "myImageDefinition"
$imageVersion = "myImageVersion"

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition `
   -GalleryName $gallery `
   -Name $imageVersion `
   -ResourceGroupName $resourceGroup

Remove-AzGalleryImageDefinition `
   -ResourceGroupName $resourceGroup `
   -GalleryName $gallery `
   -GalleryImageDefinitionName $imageDefinition

Remove-AzGallery `
   -Name $gallery `
   -ResourceGroupName $resourceGroup

Remove-AzResourceGroup -Name $resourceGroup

Topluluk galerileri

Önemli

Azure İşlem Galerisi – topluluk galerileri şu anda ÖNİzLEME aşamasındadır ve Azure İşlem Galerisi için Önizleme Koşulları - topluluk galerisine tabidir.

Topluluk galerisi yayımlamak için Azure aboneliğinizde önizleme özelliklerini ayarlamanız gerekir. Topluluk galerisi görüntülerinden VM oluşturma işlemi tüm Azure kullanıcılarına açıktır.

Kendi galerilerinizi listelemek ve topluluk galerilerinizin ortak adlarını çıkarmak için:

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

Not

Son kullanıcı olarak, bir topluluk galerisinin genel adını almak için şu anda portalı kullanmanız gerekir. Sanal makineler>Azure sanal makinesi>oluşturma>Görüntüsü>Tüm görüntüleri>görme Topluluk Görüntüleri>Genel galeri adı'na gidin.

az sig image-definition list-community komutunu kullanarak bir topluluk galerisinde bulunan tüm görüntü tanımlarını listeleyin.

Bu örnekte, Batı ABD'deki ContosoImage galerisindeki tüm görüntüleri ve vm, işletim sistemi ve işletim sistemi durumu oluşturmak için gereken benzersiz kimliği ada göre listeleyeceğiz.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Az sig image-version list-community kullanarak topluluk galerisinde paylaşılan görüntü sürümlerini listeleme:

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Doğrudan paylaşılan galeriler

Önemli

Azure İşlem Galerisi – Doğrudan paylaşılan galeri şu anda ÖNİzLEME aşamasındadır ve Azure İşlem Galerisi için Önizleme Koşulları'na tabidir.

Önizleme sırasında görüntüleri doğrudan paylaşılan bir galeride yayımlamak için adresine https://aka.ms/directsharedgallery-previewkaydolmanız gerekir. Doğrudan paylaşılan bir galeriden VM oluşturma işlemi tüm Azure kullanıcılarına açıktır.

Önizleme sırasında özelliği sharingProfile.permissions olarak ayarlanmış Groupsyeni bir galeri oluşturmanız gerekir. Cli kullanarak galeri oluştururken parametresini --permissions groups kullanın. Mevcut bir galeriyi kullanamazsınız, özelliği şu anda güncelleştirilemez.

Sizinle paylaşılan bir galeriyi uniqueID bulmak için az sig list-shared komutunu kullanın. Bu örnekte Batı ABD bölgesindeki galerileri arıyoruz.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

Doğrudan sizinle paylaşılan tüm görüntü tanımlarını listeleyin, az sig image-definition list-shared komutunu kullanın.

Bu örnekte, Batı ABD'deki galerideki tüm görüntüleri ve vm, işletim sistemi ve işletim sistemi durumu oluşturmak için gereken benzersiz kimliği ada göre listeleyeceğiz.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Az sig image-version list-shared kullanarak doğrudan sizinle paylaşılan görüntü sürümlerini listeleyin:

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Sonraki adımlar

Görüntü tanımı ve görüntü sürümü oluşturun.
Azure İşlem Galerisi'nde genelleştirilmiş veya özelleştirilmiş bir görüntüden VM oluşturun.

Aracılığıyla paylaş