Virtual Machine Images - Get
Ottiene un'immagine di 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=2024-07-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
location
|
path | True |
string |
Nome di un'area di Azure supportata. |
offer
|
path | True |
string |
Offerta di pubblicazione di immagini valida. |
publisher
|
path | True |
string |
Autore di immagini valido. |
skus
|
path | True |
string |
SKU di immagine valido. |
subscription
|
path | True |
string |
Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio. |
version
|
path | True |
string |
Versione valida dello SKU dell'immagine. |
api-version
|
query | True |
string |
Versione dell'API client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
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
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
Esempio di richiesta
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=2024-07-01
Risposta di esempio
{
"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
Risposta di esempio
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
Definizioni
Nome | Descrizione |
---|---|
Alternative |
Descrive l'opzione alternativa specificata dal server di pubblicazione per questa immagine quando questa immagine è deprecata. |
Alternative |
Descrive il tipo dell'opzione alternativa. |
Api |
Errore dell'API. |
Api |
Base degli errori api. |
Architecture |
Specifica il tipo di architettura |
Automatic |
Descrive le proprietà di aggiornamento automatico del sistema operativo nell'immagine. |
Cloud |
Risposta di errore dal servizio di calcolo. |
Data |
Contiene le informazioni sulle immagini del disco dati. |
Disallowed |
Specifica la configurazione non consentita per un'immagine di macchina virtuale. |
Extended |
Tipo complesso della posizione estesa. |
Extended |
Tipo della posizione estesa. |
Hyper |
Specifica il tipo HyperVGeneration |
Image |
Descrive le proprietà dello stato di deprecazione dell'immagine nell'immagine. |
Image |
Descrive lo stato dell'immagine. |
Inner |
Dettagli dell'errore interno. |
Operating |
Sistema operativo di osDiskImage. |
OSDisk |
Contiene le informazioni sull'immagine del disco del sistema operativo. |
Purchase |
Usato per stabilire il contesto di acquisto di qualsiasi artefatto di terze parti tramite MarketPlace. |
Virtual |
Descrive un'immagine di macchina virtuale. |
Virtual |
Specifica funzionalità aggiuntive supportate dall'immagine |
Vm |
Tipi di disco della macchina virtuale non consentiti. |
AlternativeOption
Descrive l'opzione alternativa specificata dal server di pubblicazione per questa immagine quando questa immagine è deprecata.
Nome | Tipo | Descrizione |
---|---|---|
type |
Descrive il tipo dell'opzione alternativa. |
|
value |
string |
Indica il valore dell'opzione alternativo specificato dal server di pubblicazione. Si tratta del nome dell'offerta quando il tipo è Offerta o il nome del piano quando il tipo è Plan. |
AlternativeType
Descrive il tipo dell'opzione alternativa.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
Errore dell'API.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore dell'API |
|
innererror |
Errore interno dell'API |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore specifico. |
ApiErrorBase
Base degli errori api.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore specifico. |
ArchitectureTypes
Specifica il tipo di architettura
Nome | Tipo | Descrizione |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
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
Risposta di errore dal servizio di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore dell'API. |
DataDiskImage
Contiene le informazioni sulle immagini del disco dati.
Nome | Tipo | Descrizione |
---|---|---|
lun |
integer |
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
Specifica la configurazione non consentita per un'immagine di macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
vmDiskType |
Tipi di disco della macchina virtuale non consentiti. |
ExtendedLocation
Tipo complesso della posizione estesa.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome della posizione estesa. |
type |
Tipo della posizione estesa. |
ExtendedLocationTypes
Tipo della posizione estesa.
Nome | Tipo | Descrizione |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
Specifica il tipo HyperVGeneration
Nome | Tipo | Descrizione |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
Descrive le proprietà dello stato di deprecazione dell'immagine nell'immagine.
Nome | Tipo | Descrizione |
---|---|---|
alternativeOption |
Descrive l'opzione alternativa specificata dal server di pubblicazione per questa immagine quando questa immagine è deprecata. |
|
imageState |
Descrive lo stato dell'immagine. |
|
scheduledDeprecationTime |
string |
Ora, in futuro, in cui questa immagine verrà contrassegnata come deprecata. L'ora pianificata viene scelta dal server di pubblicazione. |
ImageState
Descrive lo stato dell'immagine.
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
InnerError
Dettagli dell'errore interno.
Nome | Tipo | Descrizione |
---|---|---|
errordetail |
string |
Messaggio di errore interno o dump delle eccezioni. |
exceptiontype |
string |
Tipo di eccezione. |
OperatingSystemTypes
Sistema operativo di osDiskImage.
Nome | Tipo | Descrizione |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
Contiene le informazioni sull'immagine del disco del sistema operativo.
Nome | Tipo | Descrizione |
---|---|---|
operatingSystem |
Sistema operativo di osDiskImage. |
PurchasePlan
Usato 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. |
VirtualMachineImage
Descrive un'immagine di macchina virtuale.
Nome | Tipo | Descrizione |
---|---|---|
extendedLocation |
Posizione estesa della macchina virtuale. |
|
id |
string |
ID risorsa |
location |
string |
Posizione di Azure supportata della risorsa. |
name |
string |
Nome della risorsa. |
properties.architecture |
Specifica il tipo di architettura |
|
properties.automaticOSUpgradeProperties |
Descrive le proprietà di aggiornamento automatico del sistema operativo nell'immagine. |
|
properties.dataDiskImages |
Contiene le informazioni sulle immagini del disco dati. |
|
properties.disallowed |
Specifica la configurazione non consentita per VirtualMachine creata dall'immagine |
|
properties.features |
Specifica funzionalità aggiuntive supportate dall'immagine |
|
properties.hyperVGeneration |
Specifica il tipo HyperVGeneration |
|
properties.imageDeprecationStatus |
Descrive le proprietà dello stato di deprecazione dell'immagine nell'immagine. |
|
properties.osDiskImage |
Contiene le informazioni sull'immagine del disco del sistema operativo. |
|
properties.plan |
Usato per stabilire il contesto di acquisto di qualsiasi artefatto di terze parti tramite MarketPlace. |
|
tags |
object |
Specifica i tag assegnati alla macchina virtuale. Per altre informazioni sull'uso dei tag, vedere Uso di tag per organizzare le risorse di Azure. |
VirtualMachineImageFeature
Specifica funzionalità aggiuntive supportate dall'immagine
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome della funzionalità. |
value |
string |
Valore corrispondente per la funzionalità. |
VmDiskTypes
Tipi di disco della macchina virtuale non consentiti.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
Unmanaged |
string |