Katalóguserőforrások listázása, frissítése és törlése

Cikk
10/15/2024

Az Azure Compute Gallery (korábbi nevén megosztott képgyűjtemény) erőforrásait az Azure CLI vagy az Azure PowerShell használatával kezelheti.

Önnel megosztott gyűjtemények listázása

Az előfizetésével megosztott katalógusok listázása.

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

A bérlővel megosztott katalógusok listázása.

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

A kimenet tartalmazza az Önnel megosztott nyilvános name és uniqueID katalógust. A katalógus nevével lekérdezheti a katalóguson keresztül elérhető képeket.

Íme egy példakimenet:

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

Előfizetéssel megosztott gyűjtemények listázása.

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

A válasznak a következőhöz hasonlóan kell kinéznie:

{	 
"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" 
  	} 
], 
}

A bérlővel megosztott gyűjtemények listázása.

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

A válasznak a következőhöz hasonlóan kell kinéznie:

{	 
"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

A képdefiníciók listázása

Listázhatja a képdefiníciókat a katalógusban, beleértve az operációs rendszer típusával és állapotával kapcsolatos információkat az sig képdefiníciós lista használatával.

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

Képverziók listázása

Képverziók listázása a katalógusban az sig image-version listával:

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

Adott képverzió lekérése

Kérje le egy adott képverzió azonosítóját a katalógusban az az sig image-version show használatával.

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

Az összes gyűjtemény listázása név szerint.

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

Az összes képdefiníció listázása név szerint.

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

Az összes képverzió listázása név szerint.

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

Képverzió törlése. Ez a példa törli az 1.0.0 nevű képverziót.

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

Erőforrások frissítése

A frissíthető összetevőkre bizonyos korlátozások vonatkoznak. A következő elemek frissíthetők:

Azure Compute Gallery:

Leírás

Képdefiníció:

Ajánlott vCPU-k
Ajánlott memória
Leírás
Élettartam vége

Kép verziója:

Regionális replikák száma
Célrégiók
Kizárás a legújabbakból
Élettartam vége

Parancssori felület
PowerShell

Frissítse a katalógus leírását az (az sig update) használatával.

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

Frissítse egy képdefiníció leírását az sig képdefiníció frissítésével.

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

Frissítsen egy képverziót, és adjon hozzá egy régiót, amely replikálódik az az sig rendszerképverzió frissítésének használatával. Ez a módosítás eltarthat egy ideig, amíg a rendszerkép replikálódik az új régióba.

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

Ez a példa bemutatja, hogyan használható az az sig image-version update a képverzió kizárására a legújabb rendszerképként való használatból.

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

Ez a példa bemutatja, hogyan használhatja az az sig image-version update-t, hogy belefoglalja ezt a képverziót a legújabb rendszerképbe.

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

A katalógus leírásának frissítéséhez használja az Update-AzGalleryt.

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

Ez a példa bemutatja, hogyan frissítheti az Update-AzGalleryImageDefinition parancsot a képdefiníció élettartamának dátumának frissítéséhez.

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

Ez a példa bemutatja, hogyan lehet az Update-AzGalleryImageVersion használatával kizárni ezt a képverziót a legújabb rendszerképként való használatból.

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

Ez a példa bemutatja, hogyan használhatja az Update-AzGalleryImageVersion szolgáltatást a rendszerkép verziójának belefoglalására a legújabb rendszerképek esetében.

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

Erőforrások törlése

Az erőforrásokat fordított sorrendben kell törölnie a rendszerkép verziójának törlésével. Miután törölte az összes képverziót, törölheti a képdefiníciót. Az összes képdefiníció törlése után törölheti a katalógust.

Parancssori felület
PowerShell

Mielőtt törölhet egy megosztott közösségi katalógust, az az sig share reset használatával le kell állítania a katalógus nyilvános megosztását.

Képverzió törlése az sig image-version delete használatával.

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

Képdefiníció törlése az sig képdefiníció törlésével.

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

Katalógus törlése az sig delete használatával.

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

Közösségi galériák

Fontos

Az Azure Compute Gallery – a közösségi gyűjtemények jelenleg előzetes verzióban vannak, és az Azure Compute Gallery előzetes verziójának feltételei vonatkoznak a közösségi katalógusra.

Közösségi katalógus közzétételéhez be kell állítania az előzetes verziójú funkciókat az Azure-előfizetésben. A virtuális gépek közösségi katalógusképekből való létrehozása minden Azure-felhasználó számára nyitva áll.

A saját gyűjtemények listázásához és a közösségi galériák nyilvános nevének kimenetéhez:

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

Feljegyzés

Végfelhasználóként a közösségi katalógus nyilvános nevének lekéréséhez jelenleg a portált kell használnia. Nyissa meg a Virtuális gépek>létrehozása>Azure-beli virtuális gép>rendszerképét>: Az összes lemezkép>közösségi rendszerképek>nyilvános katalógusának neve.

Listázhatja a közösségi katalógusban elérhető összes képdefiníciót az az sig image-definition list-community használatával.

Ebben a példában az USA nyugati régiójában található ContosoImage gyűjtemény összes képét, valamint a virtuális gép, az operációs rendszer és az operációs rendszer állapotának létrehozásához szükséges egyedi azonosítót soroljuk fel név alapján.

 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

A közösségi katalógusban megosztott képverziók listázása az az sig image-version list-community használatával:

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

Közvetlen megosztott gyűjtemények

Fontos

Azure Compute Gallery – a közvetlen megosztott katalógus jelenleg előzetes verzióban érhető el, és az Azure Compute Gallery előzetes verziójának feltételei érvényesek.

Ha az előnézet alatt közvetlen megosztott katalógusban szeretné közzétenni a képeket, regisztrálnia kell a következő helyen https://aka.ms/directsharedgallery-preview: . A virtuális gépek közvetlen megosztott katalógusból való létrehozása minden Azure-felhasználó számára nyitva áll.

Az előzetes verzióban létre kell hoznia egy új gyűjteményt, amelynek tulajdonsága sharingProfile.permissions Groupsa következő. Ha a parancssori felület használatával hoz létre katalógust, használja a paramétert --permissions groups . Nem használhat meglévő gyűjteményt, a tulajdonság jelenleg nem frissíthető.

Az Önnel megosztott katalógus megkereséséhez használja a uniqueID megosztott sig-listát. Ebben a példában az USA nyugati régiójában keresünk galériákat.

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

Listázhatja a közvetlenül Önnel megosztott képdefiníciókat, és használja az az sig image-definition list-shared parancsot.

Ebben a példában felsoroljuk az USA nyugati régiójában található katalógus összes képét, valamint a virtuális gép, az operációs rendszer és az operációs rendszer állapotának létrehozásához szükséges egyedi azonosítót.

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 az sig image-version list-shared használatával közvetlenül megosztott képverziók listázása:

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

Következő lépések

Hozzon létre egy képdefiníciót és egy képverziót.
Virtuális gép létrehozása egy általánosított vagy specializált rendszerképből egy Azure Compute Galleryben.

Megosztás a következőn keresztül: