Shared Gallery Image Versions - Get

Služba:

Compute

Verze rozhraní API:

2024-03-03

Získejte verzi image sdílené 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}/versions/{galleryImageVersionName}?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ů.
galleryImageVersionName	path	True	string	Název verze obrazu galerie, která má být vytvořena. Musí dodržovat sémantický vzor názvu verze: Povolené znaky jsou číslice a tečka. Číslice musí být v rozsahu 32bitového celého čísla. Formát: <MajorVersion>.<MinorVersion>.<Záplata>
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	SharedGalleryImageVersion	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 version.

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

{
  "properties": {
    "publishedDate": "2018-03-20T09:12:28Z",
    "endOfLifeDate": "2022-03-20T09:12:28Z",
    "excludeFromLatest": false,
    "storageProfile": {
      "osDiskImage": {
        "diskSizeGB": 29,
        "hostCaching": "None"
      }
    },
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageVersionName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName/Versions/myGalleryImageVersionName"
  }
}

Definice

Name	Description
ApiError	Chyba rozhraní API.
ApiErrorBase	Chybová základna API.
CloudError	Chybová odpověď ze služby Compute.
InnerError	Podrobnosti vnitřní chyby.
SharedGalleryDataDiskImage	Toto je obraz datového disku.
SharedGalleryHostCaching	Ukládání disku do mezipaměti hostitele. Platné hodnoty jsou None, ReadOnly a ReadWrite.
SharedGalleryImageVersion	Určuje informace o verzi image galerie, kterou chcete vytvořit nebo aktualizovat.
SharedGalleryImageVersionStorageProfile	Toto je profil úložiště verze image galerie.
SharedGalleryOSDiskImage	Toto je image disku s operačním systémem.

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.

CloudError

Objekt

Chybová odpověď ze služby Compute.

Name	Typ	Description
error	ApiError	Chyba rozhraní API.

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.

SharedGalleryDataDiskImage

Objekt

Toto je obraz datového disku.

Name	Typ	Description
diskSizeGB	integer (int32)	Tato vlastnost označuje velikost virtuálního pevného disku, který se má vytvořit.
hostCaching	SharedGalleryHostCaching	Ukládání disku do mezipaměti hostitele. Platné hodnoty jsou None, ReadOnly a ReadWrite.
lun	integer (int32)	Tato vlastnost určuje číslo logické jednotky datového disku. Tato hodnota se používá k identifikaci datových disků v rámci virtuálního počítače, a proto musí být jedinečná pro každý datový disk připojený k virtuálnímu počítači.

SharedGalleryHostCaching

Výčet

Ukládání disku do mezipaměti hostitele. Platné hodnoty jsou None, ReadOnly a ReadWrite.

Hodnota	Description
None
ReadOnly
ReadWrite

SharedGalleryImageVersion

Objekt

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

Name	Typ	Description
identifier.uniqueId	string	Jedinečné ID této sdílené galerie.
location	string	Umístění prostředku
name	string	Název prostředku
properties.artifactTags	object	Značky artefaktů sdíleného prostředku galerie.
properties.endOfLifeDate	string (date-time)	Datum ukončení životnosti verze obrazu galerie Definice. Tuto vlastnost lze použít pro účely vyřazení z provozu. Tato vlastnost je aktualizovatelná.
properties.excludeFromLatest	boolean	Pokud je nastavená hodnota true, virtuální počítače nasazené z nejnovější verze definice image tuto verzi image nebudou používat.
properties.publishedDate	string (date-time)	Datum zveřejnění verze obrazu galerie Definice. Tuto vlastnost lze použít pro účely vyřazení z provozu. Tato vlastnost je aktualizovatelná.
properties.storageProfile	SharedGalleryImageVersionStorageProfile	Popisuje profil úložiště verze bitové kopie.

SharedGalleryImageVersionStorageProfile

Objekt

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

Name	Typ	Description
dataDiskImages	SharedGalleryDataDiskImage[]	Seznam imagí datových disků
osDiskImage	SharedGalleryOSDiskImage	Toto je image disku s operačním systémem.

SharedGalleryOSDiskImage

Objekt

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

Name	Typ	Description
diskSizeGB	integer (int32)	Tato vlastnost označuje velikost virtuálního pevného disku, který se má vytvořit.
hostCaching	SharedGalleryHostCaching	Ukládání disku do mezipaměti hostitele. Platné hodnoty jsou None, ReadOnly a ReadWrite.