Shared Gallery Images - Get

Služba:: Compute

Verze rozhraní API:: 2024-03-03

Získejte sdílený obrázek galerie podle ID předplatného nebo ID tenanta.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2024-03-03

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
galleryImageName	path	True	string	Název definice obrazu sdílené galerie, ze které mají být uvedeny verze obrazů.
galleryUniqueName	path	True	string	Jedinečný název sdílené galerie.
location	path	True	string minLength: 1	Název oblasti Azure.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
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	SharedGalleryImage	Operace Azure byla úspěšně dokončena.
Other Status Codes	CloudError	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

Get a shared gallery image.

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2024-03-03

Ukázková odpověď

Stavový kód:: 200

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "eula": "https://www.microsoft.com/en-us/",
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Definice

Name	Description
ApiError	Chyba rozhraní API.
ApiErrorBase	Chybová základna API.
Architecture	Architektura image. Platí jenom pro disky s operačním systémem.
CloudError	Chybová odpověď ze služby Compute.
Disallowed	Popisuje nepovolené typy disků.
GalleryImageFeature	Funkce pro obrázek galerie.
GalleryImageIdentifier	Toto je identifikátor definice obrázku galerie.
HyperVGeneration	Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.
ImagePurchasePlan	Popisuje plán nákupu definic obrázků galerie. Používá se v imagích marketplace.
InnerError	Podrobnosti vnitřní chyby.
OperatingSystemStateTypes	Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v této imagi generalizované nebo specializované.
OperatingSystemTypes	Tato vlastnost umožňuje určit typ operačního systému, který je součástí disku při vytváření virtuálního počítače ze spravované image. Možné hodnoty jsou: Windows,Linux.
RecommendedMachineConfiguration	Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti jsou aktualizovatelné.
ResourceRange	Popisuje rozsah prostředků.
SharedGalleryImage	Určuje informace o definici obrazu galerie, kterou chcete vytvořit nebo aktualizovat.

ApiError

Objekt

Chyba rozhraní API.

Name	Typ	Description
code	string	Kód chyby.
details	ApiErrorBase[]	Podrobnosti o chybě rozhraní API
innererror	InnerError	Vnitřní chyba Api
message	string	Chybová zpráva.
target	string	Cíl konkrétní chyby.

ApiErrorBase

Objekt

Chybová základna API.

Name	Typ	Description
code	string	Kód chyby.
message	string	Chybová zpráva.
target	string	Cíl konkrétní chyby.

Architecture

Výčet

Architektura image. Platí jenom pro disky s operačním systémem.

Hodnota	Description
x64
Arm64

CloudError

Objekt

Chybová odpověď ze služby Compute.

Name	Typ	Description
error	ApiError	Chyba rozhraní API.

Disallowed

Objekt

Popisuje nepovolené typy disků.

Name	Typ	Description
diskTypes	string[]	Seznam typůdiskůch

GalleryImageFeature

Objekt

Funkce pro obrázek galerie.

Name	Typ	Description
name	string	Název funkce obrázku galerie.
startsAtVersion	string	Minimální verze image galerie, která tuto funkci podporuje.
value	string	Hodnota funkce obrázku galerie.

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

HyperVGeneration

Výčet

Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.

Hodnota	Description
V1
V2

ImagePurchasePlan

Objekt

Popisuje plán nákupu definic obrázků galerie. Používá se v imagích marketplace.

Name	Typ	Description
name	string	ID plánu.
product	string	ID produktu.
publisher	string	ID vydavatele.

InnerError

Objekt

Podrobnosti vnitřní chyby.

Name	Typ	Description
errordetail	string	Vnitřní chybová zpráva nebo výpis výjimky.
exceptiontype	string	Typ výjimky.

OperatingSystemStateTypes

Výčet

Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v této imagi generalizované nebo specializované.

Hodnota	Description
Generalized	Zobecněný obrázek. Je třeba jej zřídit během doby nasazení.
Specialized	Specializovaný obrázek. Obsahuje již zřízený disk s operačním systémem.

OperatingSystemTypes

Výčet

Tato vlastnost umožňuje určit typ operačního systému, který je součástí disku při vytváření virtuálního počítače ze spravované image. Možné hodnoty jsou: Windows,Linux.

Hodnota	Description
Windows
Linux

RecommendedMachineConfiguration

Objekt

Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti jsou aktualizovatelné.

Name	Typ	Description
memory	ResourceRange	Popisuje rozsah prostředků.
vCPUs	ResourceRange	Popisuje rozsah prostředků.

ResourceRange

Objekt

Popisuje rozsah prostředků.

Name	Typ	Description
max	integer (int32)	Maximální počet prostředků.
min	integer (int32)	Minimální počet prostředků.