Virtual Machine Images - Get

Servizio:: Compute

Versione API:: 2025-04-01

Ottiene un'immagine della macchina virtuale.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmimage/offers/{offer}/skus/{skus}/versions/{version}?api-version=2025-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
location	path	True	string minLength: 1	Nome dell'area di Azure.
offer	path	True	string	Un'offerta valida per gli editori di immagini.
publisherName	path	True	string	Un editore di immagini valido.
skus	path	True	string	Uno SKU immagine valido.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
version	path	True	string	Una versione valida dello SKU dell'immagine.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualMachineImage	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

VirtualMachineImage_Get_MaximumSet_Gen

VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaa/publishers/aaa/artifacttypes/vmimage/offers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/skus/aaaaaaaaaaaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaa?api-version=2025-04-01

Risposta di esempio

Codice di stato:: 200

{
  "properties": {
    "plan": {
      "publisher": "aaaaaaaaaaaaaaaaaaa",
      "name": "aaaaaaaaa",
      "product": "aaaaaaaaaaaaaa"
    },
    "osDiskImage": {
      "operatingSystem": "Windows"
    },
    "dataDiskImages": [
      {
        "lun": 17
      }
    ],
    "automaticOSUpgradeProperties": {
      "automaticOSUpgradeSupported": true
    },
    "hyperVGeneration": "V1",
    "disallowed": {
      "vmDiskType": "None"
    },
    "features": [
      {
        "name": "aaaaaaaaaaaaaaaaaaaaa",
        "value": "aaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "imageDeprecationStatus": {
      "imageState": "ScheduledForDeprecation",
      "scheduledDeprecationTime": "2023-01-13T00:00:00+00:00",
      "alternativeOption": {
        "type": "Offer",
        "value": "aaaaaaa"
      }
    }
  },
  "name": "aaaaaaaaa",
  "location": "aaaaa",
  "tags": {
    "key6817": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "extendedLocation": {
    "name": "aaaaaaaaaaaaaaaaaaaaa",
    "type": "EdgeZone"
  },
  "id": "aaaaaaaaaaa"
}

VirtualMachineImage_Get_MinimumSet_Gen

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaa/publishers/aaaaaaaaaaa/artifacttypes/vmimage/offers/aa/skus/aaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2025-04-01

Risposta di esempio

Codice di stato:: 200

{
  "name": "aaaaaaaaa",
  "location": "aaaaa",
  "id": "aaaaaaaaaaa"
}

Definizioni

Nome	Descrizione
AlternativeOption	Viene descritta l'opzione alternativa specificata dal server di pubblicazione per l'immagine quando l'immagine è deprecata.
AlternativeType	Viene descritto il tipo di opzione alternativa.
ApiError	Errore API.
ApiErrorBase	Base di errore API.
ArchitectureTypes	Specifica il tipo di architettura
AutomaticOSUpgradeProperties	Descrive le proprietà di aggiornamento automatico del sistema operativo nell'immagine.
CloudError	Risposta di errore dal servizio di calcolo.
DataDiskImage	Contiene le informazioni sulle immagini del disco dati.
DisallowedConfiguration	Specifica la configurazione non consentita per un'immagine di macchina virtuale.
ExtendedLocation	Tipo complesso della posizione estesa.
ExtendedLocationTypes	Tipo dell'ubicazione estesa.
HyperVGenerationTypes	Specifica il tipo di HyperVGeneration
ImageDeprecationStatus	Descrive le proprietà dello stato di deprecazione dell'immagine nell'immagine.
ImageState	Descrive lo stato dell'immagine.
InnerError	Dettagli dell'errore interno.
OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine personalizzata. I valori possibili sono: Windows,Linux.
OSDiskImage	Contiene le informazioni sull'immagine del disco del sistema operativo.
PurchasePlan	Utilizzato per stabilire il contesto di acquisto di qualsiasi artefatto di terze parti tramite MarketPlace.
VirtualMachineImage	Viene descritta un'immagine di macchina virtuale.
VirtualMachineImageFeature	Specifica le funzionalità aggiuntive supportate dall'immagine
VmDiskTypes	Tipi di disco VM non consentiti.

AlternativeOption

Oggetto

Viene descritta l'opzione alternativa specificata dal server di pubblicazione per l'immagine quando l'immagine è deprecata.

Nome	Tipo	Descrizione
type	AlternativeType	Viene descritto il tipo di opzione alternativa.
value	string	Indica il valore dell'opzione alternativa specificato dal server di pubblicazione. Questo è il nome dell'offerta quando il tipo è Offerta o il nome del piano quando il tipo è Piano.

AlternativeType

Enumerazione

Viene descritto il tipo di opzione alternativa.

Valore	Descrizione
None
Offer
Plan

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.

ArchitectureTypes

Enumerazione

Specifica il tipo di architettura

Valore	Descrizione
x64
Arm64

AutomaticOSUpgradeProperties

Oggetto

Descrive le proprietà di aggiornamento automatico del sistema operativo nell'immagine.

Nome	Tipo	Descrizione
automaticOSUpgradeSupported	boolean	Specifica se l'aggiornamento automatico del sistema operativo è supportato nell'immagine.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

DataDiskImage

Oggetto

Contiene le informazioni sulle immagini del disco dati.

Nome	Tipo	Descrizione
lun	integer (int32)	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 a una macchina virtuale.

DisallowedConfiguration

Oggetto

Specifica la configurazione non consentita per un'immagine di macchina virtuale.

Nome	Tipo	Descrizione
vmDiskType	VmDiskTypes	Tipi di disco VM non consentiti.

ExtendedLocation

Oggetto

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo dell'ubicazione estesa.

ExtendedLocationTypes

Enumerazione

Tipo dell'ubicazione estesa.

Valore	Descrizione
EdgeZone

HyperVGenerationTypes

Enumerazione

Specifica il tipo di HyperVGeneration

Valore	Descrizione
V1
V2

ImageDeprecationStatus

Oggetto

Descrive le proprietà dello stato di deprecazione dell'immagine nell'immagine.

Nome	Tipo	Descrizione
alternativeOption	AlternativeOption	Viene descritta l'opzione alternativa specificata dal server di pubblicazione per l'immagine quando l'immagine è deprecata.
imageState	ImageState	Descrive lo stato dell'immagine.
scheduledDeprecationTime	string (date-time)	Il momento, in futuro, in cui questa immagine verrà contrassegnata come deprecata. L'orario programmato viene scelto dall'editore.

ImageState

Enumerazione

Descrive lo stato dell'immagine.

Valore	Descrizione
Active
ScheduledForDeprecation
Deprecated

InnerError

Oggetto

Dettagli dell'errore interno.

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

OperatingSystemTypes

Enumerazione

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine personalizzata. I valori possibili sono: Windows,Linux.

Valore	Descrizione
Windows
Linux

OSDiskImage

Oggetto

Contiene le informazioni sull'immagine del disco del sistema operativo.

Nome	Tipo	Descrizione
operatingSystem	OperatingSystemTypes	Il sistema operativo di osDiskImage.

PurchasePlan

Oggetto

Utilizzato per stabilire il contesto di acquisto di qualsiasi artefatto di terze parti tramite MarketPlace.

Nome	Tipo	Descrizione
name	string	ID del piano.
product	string	Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference.
publisher	string	ID editore.