Gallery Images - List By Resource Group

Reference

Služba:: Azure Stack HCI

Verze rozhraní API:: 2025-04-01-preview

Zobrazí seznam všech imagí galerie v zadané skupině prostředků. Pomocí vlastnosti nextLink v odpovědi získáte další stránku obrázků galerie.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/galleryImages?api-version=2025-04-01-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	GalleryImageListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ListGalleryImageByResourceGroup

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/galleryImages?api-version=2025-04-01-preview

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "name": "test-gallery-image",
      "type": "Microsoft.AzureStackHCI/galleryImages",
      "extendedLocation": {
        "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
        "type": "CustomLocation"
      },
      "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/galleryImages/test-gallery-image",
      "location": "West US2",
      "properties": {
        "cloudInitDataSource": "NoCloud",
        "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
        "hyperVGeneration": "V2",
        "osType": "Linux",
        "provisioningState": "Accepted",
        "status": {
          "downloadStatus": {
            "downloadSizeInMB": 9383
          },
          "progressPercentage": 100,
          "provisioningStatus": {
            "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
            "status": "Succeeded"
          }
        },
        "version": {
          "properties": {
            "storageProfile": {
              "osDiskImage": {
                "sizeInMB": 30270
              }
            }
          }
        }
      }
    }
  ]
}

Definice

Name	Description
CloudInitDataSource	Zdroj dat pro image galerie při zřizování pomocí cloud-init [NoCloud, Azure]
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Komplexní typ rozšířeného umístění.
ExtendedLocationTypes	Typ extendedLocation.
GalleryImage	Definice prostředku galerie obrázků.
GalleryImageIdentifier	Toto je identifikátor definice obrázku galerie.
GalleryImageListResult	Odpověď operace seznamu GalleryImage.
GalleryImageStatus	Pozorovaný stav obrázků galerie
GalleryImageStatusDownloadStatus	Stav stahování obrázku galerie
GalleryImageStatusProvisioningStatus	Stav operace provedené na imagi galerie
GalleryImageVersion	Určuje informace o verzi image galerie, kterou chcete vytvořit nebo aktualizovat.
GalleryImageVersionStorageProfile	Toto je profil úložiště verze image galerie.
GalleryOSDiskImage	Toto je image disku s operačním systémem.
HyperVGeneration	Generace hypervisoru virtuálního počítače [V1, V2]
OperatingSystemTypes	Typ operačního systému, který image galerie používá [Windows, Linux]
ProvisioningStateEnum	Stav zřizování prostředku
Status	Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
VmImageRepositoryCredentials	Přihlašovací údaje používané k přihlášení k úložišti imagí, které mají přístup k zadané imagi.

CloudInitDataSource

Výčet

Zdroj dat pro image galerie při zřizování pomocí cloud-init [NoCloud, Azure]

Hodnota	Description
Azure	Azure se používá jako zdroj dat.
NoCloud	NoCloud se používá jako zdroj dat.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationTypes	Typ rozšířeného umístění.

ExtendedLocationTypes

Výčet

Typ extendedLocation.

Hodnota	Description
CustomLocation	Vlastní rozšířený typ umístění

GalleryImage

Objekt

Definice prostředku galerie obrázků.

Name	Typ	Description
extendedLocation	ExtendedLocation	ExtendedLocation prostředku.
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.cloudInitDataSource	CloudInitDataSource	Zdroj dat pro image galerie při zřizování pomocí cloud-init [NoCloud, Azure]
properties.containerId	string (arm-id)	STORAGE ContainerID kontejneru úložiště, který se má použít pro image galerie
properties.hyperVGeneration	HyperVGeneration	Generace hypervisoru virtuálního počítače [V1, V2]
properties.identifier	GalleryImageIdentifier	Toto je identifikátor definice obrázku galerie.
properties.imagePath	string (password)	umístění obrázku, ze které má být obrázek galerie vytvořen
properties.osType	OperatingSystemTypes	Typ operačního systému, který image galerie používá [Windows, Linux]
properties.provisioningState	ProvisioningStateEnum	Stav zřizování image galerie
properties.sourceVirtualMachineId	string (arm-id)	ID prostředku zdrojového virtuálního počítače, ze kterého se vytvoří disk s operačním systémem image galerie.
properties.status	GalleryImageStatus	Pozorovaný stav obrázků galerie
properties.version	GalleryImageVersion	Určuje informace o verzi image galerie, kterou chcete vytvořit nebo aktualizovat.
properties.vmImageRepositoryCredentials	VmImageRepositoryCredentials	Přihlašovací údaje používané k přihlášení k úložišti imagí, které mají přístup k zadané imagi.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

GalleryImageIdentifier

Objekt

Toto je identifikátor definice obrázku galerie.

Name	Typ	Description
offer	string	Název nabídky definice obrázku galerie.
publisher	string	Název vydavatele definice obrázku galerie.
sku	string	Název skladové položky definice obrázku galerie

GalleryImageListResult

Objekt

Odpověď operace seznamu GalleryImage.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	GalleryImage[]	Položky GalerieImage na této stránce

GalleryImageStatus

Objekt

Pozorovaný stav obrázků galerie

Name	Typ	Description
downloadStatus	GalleryImageStatusDownloadStatus	Stav stahování obrázku galerie
errorCode	string	Kód chyby zřizování GalleryImage
errorMessage	string	Popisná chybová zpráva
progressPercentage	integer (int64)	Průběh operace v procentech
provisioningStatus	GalleryImageStatusProvisioningStatus	stav zřizování image galerie

GalleryImageStatusDownloadStatus

Objekt

Stav stahování obrázku galerie

Name	Typ	Description
downloadSizeInMB	integer (int64)	Stažená velikost obrázku v MB

GalleryImageStatusProvisioningStatus

Objekt

Stav operace provedené na imagi galerie

Name	Typ	Description
operationId	string	ID operace provedené na imagi galerie
status	Status	Stav operace provedené na imagi galerie [Úspěch, Selhání, InProgress]

GalleryImageVersion

Objekt

Určuje informace o verzi image galerie, kterou chcete vytvořit nebo aktualizovat.

Name	Typ	Description
name	string	Toto je verze image galerie.
properties.storageProfile	GalleryImageVersionStorageProfile	Toto je profil úložiště verze image galerie.

GalleryImageVersionStorageProfile

Objekt

Toto je profil úložiště verze image galerie.

Name	Typ	Description
osDiskImage	GalleryOSDiskImage	Toto je image disku s operačním systémem.

GalleryOSDiskImage

Objekt

Toto je image disku s operačním systémem.

Name	Typ	Description
sizeInMB	integer (int64)	Tato vlastnost označuje velikost virtuálního pevného disku, který se má vytvořit.

HyperVGeneration

Výčet

Generace hypervisoru virtuálního počítače [V1, V2]

Hodnota	Description
V1	Hypervisor generace 1 (V1)
V2	Hypervisor generace 2 (V2)

OperatingSystemTypes

Výčet

Typ operačního systému, který image galerie používá [Windows, Linux]

Hodnota	Description
Linux	Operační systém Linux
Windows	Operační systém Windows

ProvisioningStateEnum

Výčet

Stav zřizování prostředku

Hodnota	Description
Accepted	Zřizování bylo přijato.
Canceled	Zřizování bylo zrušeno.
Deleting	Probíhá odstranění prostředku.
Failed	Zřizování se nezdařilo.
InProgress	Probíhá zřizování.
Succeeded	Zřizování bylo úspěšné.

Status

Výčet

Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]

Hodnota	Description
Failed	Operace selhala.
InProgress	Probíhá operace.
Succeeded	Operace byla úspěšná.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

VmImageRepositoryCredentials

Objekt

Přihlašovací údaje používané k přihlášení k úložišti imagí, které mají přístup k zadané imagi.

Name	Typ	Description
password	string (password)	Heslo pro přístup k úložišti imagí
username	string	Uživatelské jméno pro přístup k úložišti imagí

Sdílet prostřednictvím

Gallery Images - List By Resource Group

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ListGalleryImageByResourceGroup

Ukázkový požadavek

Ukázková odpověď

Definice

CloudInitDataSource

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

GalleryImage

GalleryImageIdentifier

GalleryImageListResult

GalleryImageStatus

GalleryImageStatusDownloadStatus

GalleryImageStatusProvisioningStatus

GalleryImageVersion

GalleryImageVersionStorageProfile

GalleryOSDiskImage

HyperVGeneration

OperatingSystemTypes

ProvisioningStateEnum

Status

systemData

VmImageRepositoryCredentials