Virtual Machine Images - Get
Získá image virtuálního počítače.
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-03-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
location
|
path | True |
string |
Název podporované oblasti Azure. |
offer
|
path | True |
string |
Platná nabídka vydavatele obrázků. |
publisher
|
path | True |
string |
Platný vydavatel image. |
skus
|
path | True |
string |
Platná skladová položka image. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
version
|
path | True |
string |
Platná verze skladové položky image. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
Sample Request
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-03-01
Sample Response
{
"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
Sample Request
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=2024-03-01
Sample Response
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
Definice
Name | Description |
---|---|
Alternative |
Popisuje alternativní možnost určenou vydavatelem pro tuto image, když je tato image zastaralá. |
Alternative |
Popisuje typ alternativní možnosti. |
Api |
Chyba rozhraní API |
Api |
Základ chyb rozhraní API. |
Architecture |
Určuje typ architektury. |
Automatic |
Popisuje vlastnosti automatického upgradu operačního systému na imagi. |
Cloud |
Chybová odpověď ze služby Compute. |
Data |
Obsahuje informace o imagích datových disků. |
Disallowed |
Určuje nepovolenou konfiguraci image virtuálního počítače. |
Extended |
Komplexní typ rozšířeného umístění. |
Extended |
Typ rozšířeného umístění. |
Hyper |
Určuje typ HyperVGeneration. |
Image |
Popisuje vlastnosti stavu vyřazení image na obrázku. |
Image |
Popisuje stav image. |
Inner |
Podrobnosti o vnitřní chybě. |
Operating |
Operační systém osDiskImage. |
OSDisk |
Obsahuje informace o imagi disku s operačním systémem. |
Purchase |
Používá se k vytvoření kontextu nákupu jakéhokoli artefaktu třetí strany prostřednictvím MarketPlace. |
Virtual |
Popisuje image virtuálního počítače. |
Virtual |
Určuje další možnosti podporované image. |
Vm |
Typy disků virtuálních počítačů, které jsou zakázány. |
AlternativeOption
Popisuje alternativní možnost určenou vydavatelem pro tuto image, když je tato image zastaralá.
Name | Typ | Description |
---|---|---|
type |
Popisuje typ alternativní možnosti. |
|
value |
string |
Označuje alternativní hodnotu možnosti určenou vydavatelem. Jedná se o název nabídky, pokud je typ Nabídka, nebo název plánu, pokud je typ Plán. |
AlternativeType
Popisuje typ alternativní možnosti.
Name | Typ | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
Chyba rozhraní API
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě rozhraní API |
|
innererror |
Vnitřní chyba rozhraní API |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
ApiErrorBase
Základ chyb rozhraní API.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
ArchitectureTypes
Určuje typ architektury.
Name | Typ | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
Popisuje vlastnosti automatického upgradu operačního systému na imagi.
Name | Typ | Description |
---|---|---|
automaticOSUpgradeSupported |
boolean |
Určuje, jestli se v imagi podporuje automatický upgrade operačního systému. |
CloudError
Chybová odpověď ze služby Compute.
Name | Typ | Description |
---|---|---|
error |
Chyba rozhraní API |
DataDiskImage
Obsahuje informace o imagích datových disků.
Name | Typ | Description |
---|---|---|
lun |
integer |
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. |
DisallowedConfiguration
Určuje nepovolenou konfiguraci image virtuálního počítače.
Name | Typ | Description |
---|---|---|
vmDiskType |
Typy disků virtuálních počítačů, které jsou zakázány. |
ExtendedLocation
Komplexní typ rozšířeného umístění.
Name | Typ | Description |
---|---|---|
name |
string |
Název rozšířeného umístění. |
type |
Typ rozšířeného umístění. |
ExtendedLocationTypes
Typ rozšířeného umístění.
Name | Typ | Description |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
Určuje typ HyperVGeneration.
Name | Typ | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
Popisuje vlastnosti stavu vyřazení image na obrázku.
Name | Typ | Description |
---|---|---|
alternativeOption |
Popisuje alternativní možnost určenou vydavatelem pro tuto image, když je tato image zastaralá. |
|
imageState |
Popisuje stav image. |
|
scheduledDeprecationTime |
string |
V budoucnu bude tento obrázek označen jako zastaralý. Tento naplánovaný čas zvolí vydavatel. |
ImageState
Popisuje stav image.
Name | Typ | Description |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
InnerError
Podrobnosti o vnitřní chybě.
Name | Typ | Description |
---|---|---|
errordetail |
string |
Vnitřní chybová zpráva nebo výpis výjimky. |
exceptiontype |
string |
Typ výjimky. |
OperatingSystemTypes
Operační systém osDiskImage.
Name | Typ | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
Obsahuje informace o imagi disku s operačním systémem.
Name | Typ | Description |
---|---|---|
operatingSystem |
Operační systém osDiskImage. |
PurchasePlan
Používá se k vytvoření kontextu nákupu jakéhokoli artefaktu třetí strany prostřednictvím MarketPlace.
Name | Typ | Description |
---|---|---|
name |
string |
ID plánu. |
product |
string |
Určuje součin obrázku z marketplace. To je stejná hodnota jako Nabídka v elementu imageReference. |
publisher |
string |
ID vydavatele. |
VirtualMachineImage
Popisuje image virtuálního počítače.
Name | Typ | Description |
---|---|---|
extendedLocation |
Rozšířené umístění virtuálního počítače. |
|
id |
string |
ID prostředku |
location |
string |
Podporované umístění prostředku v Azure |
name |
string |
Název prostředku. |
properties.architecture |
Určuje typ architektury. |
|
properties.automaticOSUpgradeProperties |
Popisuje vlastnosti automatického upgradu operačního systému na imagi. |
|
properties.dataDiskImages |
Obsahuje informace o imagích datových disků. |
|
properties.disallowed |
Určuje nepovolenou konfiguraci virtuálního počítače vytvořeného z image. |
|
properties.features |
Určuje další možnosti podporované image. |
|
properties.hyperVGeneration |
Určuje typ HyperVGeneration. |
|
properties.imageDeprecationStatus |
Popisuje vlastnosti stavu vyřazení image na obrázku. |
|
properties.osDiskImage |
Obsahuje informace o imagi disku s operačním systémem. |
|
properties.plan |
Používá se k vytvoření kontextu nákupu jakéhokoli artefaktu třetí strany prostřednictvím MarketPlace. |
|
tags |
object |
Určuje značky, které jsou přiřazené virtuálnímu počítači. Další informace o používání značek najdete v tématu Použití značek k uspořádání prostředků Azure. |
VirtualMachineImageFeature
Určuje další možnosti podporované image.
Name | Typ | Description |
---|---|---|
name |
string |
Název funkce. |
value |
string |
Odpovídající hodnota funkce. |
VmDiskTypes
Typy disků virtuálních počítačů, které jsou zakázány.
Name | Typ | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |