Shared Gallery Image Versions - Get

Servizio:: Compute

Versione API:: 2024-03-03

Ottenere una versione dell'immagine della raccolta condivisa in base all'ID sottoscrizione o all'ID tenant.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
galleryImageName	path	True	string	Nome della definizione dell'immagine della galleria condivisa da cui devono essere elencate le versioni dell'immagine.
galleryImageVersionName	path	True	string	Il nome della versione dell'immagine della galleria da creare. Deve seguire il modello di nome della versione semantica: i caratteri consentiti sono cifre e punti. Le cifre devono essere comprese nell'intervallo di un intero a 32 bit. Formato: <MajorVersion>.<MinorVersion>.<Benda>
galleryUniqueName	path	True	string	Il nome univoco della Galleria condivisa.
location	path	True	string minLength: 1	Nome dell'area di Azure.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	SharedGalleryImageVersion	L'operazione di Azure è stata completata correttamente.
Other Status Codes	CloudError	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get a shared gallery image version.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
ApiError	Errore API.
ApiErrorBase	Base di errore API.
CloudError	Risposta di errore dal servizio di calcolo.
InnerError	Dettagli dell'errore interno.
SharedGalleryDataDiskImage	Questa è l'immagine del disco dati.
SharedGalleryHostCaching	Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite'
SharedGalleryImageVersion	Specifica informazioni sulla versione dell'immagine della raccolta da creare o aggiornare.
SharedGalleryImageVersionStorageProfile	Questo è il profilo di archiviazione di una versione dell'immagine della raccolta.
SharedGalleryOSDiskImage	Questa è l'immagine del disco del sistema operativo.

ApiError

Oggetto

Errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore Api
innererror	InnerError	L'errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

InnerError

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

SharedGalleryDataDiskImage

Oggetto

Questa è l'immagine del disco dati.

Nome	Tipo	Descrizione
diskSizeGB	integer (int32)	Questa proprietà indica le dimensioni del disco rigido virtuale da creare.
hostCaching	SharedGalleryHostCaching	Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite'
lun	integer (int32)	Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale.

SharedGalleryHostCaching

Enumerazione

Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite'

Valore	Descrizione
None
ReadOnly
ReadWrite