Virtual Machine Images - Get
Lekéri a virtuálisgép-rendszerképet.
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
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
location
|
path | True |
string |
Egy támogatott Azure-régió neve. |
offer
|
path | True |
string |
Érvényes képkiadói ajánlat. |
publisher
|
path | True |
string |
Érvényes képkiadó. |
skus
|
path | True |
string |
Érvényes rendszerkép-termékváltozat. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz. |
version
|
path | True |
string |
A rendszerkép termékváltozatának érvényes verziója. |
api-version
|
query | True |
string |
Client API-verzió. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
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"
}
Definíciók
Name | Description |
---|---|
Alternative |
A lemezkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti. |
Alternative |
Az alternatív lehetőség típusát ismerteti. |
Api |
API-hiba. |
Api |
API-hibabázis. |
Architecture |
Az architektúratípust adja meg |
Automatic |
A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti. |
Cloud |
Hibaválasz a Compute szolgáltatástól. |
Data |
Az adatlemezképek adatait tartalmazza. |
Disallowed |
Megadja a virtuálisgép-rendszerképek nem engedélyezett konfigurációját. |
Extended |
A kiterjesztett hely összetett típusa. |
Extended |
A kiterjesztett hely típusa. |
Hyper |
A HyperVGeneration típusának megadása |
Image |
A kép elavulása állapottulajdonságainak leírása a képen. |
Image |
A kép állapotát ismerteti. |
Inner |
Belső hiba részletei. |
Operating |
Az osDiskImage operációs rendszere. |
OSDisk |
Az operációsrendszer-lemez lemezképének adatait tartalmazza. |
Purchase |
Bármely harmadik féltől származó összetevőnek a MarketPlace-en keresztüli vásárlási környezetének meghatározására szolgál. |
Virtual |
Egy virtuálisgép-rendszerképet ismertet. |
Virtual |
A rendszerkép által támogatott további képességeket adja meg |
Vm |
Nem engedélyezett virtuálisgép-lemeztípusok. |
AlternativeOption
A lemezkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti.
Name | Típus | Description |
---|---|---|
type |
Az alternatív lehetőség típusát ismerteti. |
|
value |
string |
A Közzétevő által megadott alternatív beállításértéket jelzi. Ez az ajánlat neve, ha a típus Ajánlat vagy a Csomag neve, ha a típus Plan. |
AlternativeType
Az alternatív lehetőség típusát ismerteti.
Name | Típus | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
API-hiba.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
details |
Az API-hiba részletei |
|
innererror |
Az API belső hibája |
|
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
ApiErrorBase
API-hibabázis.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
ArchitectureTypes
Az architektúratípust adja meg
Name | Típus | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti.
Name | Típus | Description |
---|---|---|
automaticOSUpgradeSupported |
boolean |
Meghatározza, hogy az automatikus operációsrendszer-frissítés támogatott-e a lemezképen. |
CloudError
Hibaválasz a Compute szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
API-hiba. |
DataDiskImage
Az adatlemezképek adatait tartalmazza.
Name | Típus | Description |
---|---|---|
lun |
integer |
Az adatlemez logikai egységszámát adja meg. Ez az érték a virtuális gépen belüli adatlemezek azonosítására szolgál, ezért egyedinek kell lennie a virtuális géphez csatolt minden adatlemez esetében. |
DisallowedConfiguration
Megadja a virtuálisgép-rendszerképek nem engedélyezett konfigurációját.
Name | Típus | Description |
---|---|---|
vmDiskType |
Nem engedélyezett virtuálisgép-lemeztípusok. |
ExtendedLocation
A kiterjesztett hely összetett típusa.
Name | Típus | Description |
---|---|---|
name |
string |
A kiterjesztett hely neve. |
type |
A kiterjesztett hely típusa. |
ExtendedLocationTypes
A kiterjesztett hely típusa.
Name | Típus | Description |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
A HyperVGeneration típusának megadása
Name | Típus | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
A kép elavulása állapottulajdonságainak leírása a képen.
Name | Típus | Description |
---|---|---|
alternativeOption |
A lemezkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti. |
|
imageState |
A kép állapotát ismerteti. |
|
scheduledDeprecationTime |
string |
Az az időpont, amikor ez a kép elavultként lesz megjelölve. Ezt az ütemezett időpontot a Közzétevő választja ki. |
ImageState
A kép állapotát ismerteti.
Name | Típus | Description |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
InnerError
Belső hiba részletei.
Name | Típus | Description |
---|---|---|
errordetail |
string |
A belső hibaüzenet vagy kivételkép. |
exceptiontype |
string |
A kivétel típusa. |
OperatingSystemTypes
Az osDiskImage operációs rendszere.
Name | Típus | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
Az operációsrendszer-lemez lemezképének adatait tartalmazza.
Name | Típus | Description |
---|---|---|
operatingSystem |
Az osDiskImage operációs rendszere. |
PurchasePlan
Bármely harmadik féltől származó összetevőnek a MarketPlace-en keresztüli vásárlási környezetének meghatározására szolgál.
Name | Típus | Description |
---|---|---|
name |
string |
A terv azonosítója. |
product |
string |
A rendszerkép termékét adja meg a piactérről. Ez ugyanaz az érték, mint az ImageReference elem alatti Ajánlat. |
publisher |
string |
A közzétevő azonosítója. |
VirtualMachineImage
Egy virtuálisgép-rendszerképet ismertet.
Name | Típus | Description |
---|---|---|
extendedLocation |
A virtuális gép kiterjesztett helye. |
|
id |
string |
Erőforrás-azonosító |
location |
string |
Az erőforrás támogatott Azure-helye. |
name |
string |
Az erőforrás neve. |
properties.architecture |
Az architektúratípust adja meg |
|
properties.automaticOSUpgradeProperties |
A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti. |
|
properties.dataDiskImages |
Az adatlemezképek adatait tartalmazza. |
|
properties.disallowed |
A rendszerképből létrehozott VirtualMachine nem engedélyezett konfigurációját adja meg |
|
properties.features |
A rendszerkép által támogatott további képességeket adja meg |
|
properties.hyperVGeneration |
A HyperVGeneration típusának megadása |
|
properties.imageDeprecationStatus |
A kép elavulása állapottulajdonságainak leírása a képen. |
|
properties.osDiskImage |
Az operációsrendszer-lemez lemezképének adatait tartalmazza. |
|
properties.plan |
Bármely harmadik féltől származó összetevőnek a MarketPlace-en keresztüli vásárlási környezetének meghatározására szolgál. |
|
tags |
object |
Megadja a virtuális géphez rendelt címkéket. További információ a címkék használatáról: Címkék használata az Azure-erőforrások rendszerezéséhez. |
VirtualMachineImageFeature
A rendszerkép által támogatott további képességeket adja meg
Name | Típus | Description |
---|---|---|
name |
string |
A szolgáltatás neve. |
value |
string |
A funkció megfelelő értéke. |
VmDiskTypes
Nem engedélyezett virtuálisgép-lemeztípusok.
Name | Típus | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |