Megosztás a következőn keresztül:


Virtual Machine Images - Get

Lekéri a virtuális gép rendszerképét.

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

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.

publisherName
path True

string

Érvényes képkiadó.

skus
path True

string

Érvényes képváltozat.

subscriptionId
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ója minden szolgáltatáshíváshoz az URI részét képezi.

version
path True

string

A rendszerkép termékváltozatának érvényes verziója.

api-version
query True

string

Ügyfél API-verziója.

Válaszok

Name Típus Description
200 OK

VirtualMachineImage

OKÉ

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Mintakérelem

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

Mintaválasz

{
  "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

Mintakérelem

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-07-01

Mintaválasz

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

Definíciók

Name Description
AlternativeOption

A rendszerkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti.

AlternativeType

A másik lehetőség típusát ismerteti.

ApiError

Api-hiba.

ApiErrorBase

Api-hibabázis.

ArchitectureTypes

Az architektúra típusát adja meg

AutomaticOSUpgradeProperties

A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti.

CloudError

Hibaválasz a Compute szolgáltatástól.

DataDiskImage

Az adatlemezképek adatait tartalmazza.

DisallowedConfiguration

Megadja a virtuálisgép-rendszerképek nem engedélyezett konfigurációját.

ExtendedLocation

A kiterjesztett hely összetett típusa.

ExtendedLocationTypes

A kiterjesztett hely típusa.

HyperVGenerationTypes

A HyperVGeneration típusának megadása

ImageDeprecationStatus

A kép elavulási állapotának tulajdonságait ismerteti a képen.

ImageState

A kép állapotát ismerteti.

InnerError

Belső hiba részletei.

OperatingSystemTypes

Az osDiskImage operációs rendszere.

OSDiskImage

Az operációsrendszer-lemez lemezképének adatait tartalmazza.

PurchasePlan

Bármely harmadik féltől származó összetevő vásárlási környezetének a MarketPlace-en keresztüli létrehozására szolgál.

VirtualMachineImage

Egy virtuálisgép-rendszerképet ír le.

VirtualMachineImageFeature

A rendszerkép által támogatott további képességeket adja meg

VmDiskTypes

A nem engedélyezett virtuálisgép-lemeztípusok.

AlternativeOption

A rendszerkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti.

Name Típus Description
type

AlternativeType

A másik lehetőség típusát ismerteti.

value

string

A Publisher á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 terv.

AlternativeType

A másik lehetőség típusát ismerteti.

Érték Description
None
Offer
Plan

ApiError

Api-hiba.

Name Típus Description
code

string

A hibakód.

details

ApiErrorBase[]

Az API-hiba részletei

innererror

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úra típusát adja meg

Érték Description
Arm64
x64

AutomaticOSUpgradeProperties

A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti.

Name Típus Description
automaticOSUpgradeSupported

boolean

Megadja, hogy az operációs rendszer automatikus frissítése támogatott-e a lemezképen.

CloudError

Hibaválasz a Compute szolgáltatástól.

Name Típus Description
error

ApiError

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 csatlakoztatott minden adatlemez esetében.

DisallowedConfiguration

Megadja a virtuálisgép-rendszerképek nem engedélyezett konfigurációját.

Name Típus Description
vmDiskType

VmDiskTypes

A 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

ExtendedLocationTypes

A kiterjesztett hely típusa.

ExtendedLocationTypes

A kiterjesztett hely típusa.

Érték Description
EdgeZone

HyperVGenerationTypes

A HyperVGeneration típusának megadása

Érték Description
V1
V2

ImageDeprecationStatus

A kép elavulási állapotának tulajdonságait ismerteti a képen.

Name Típus Description
alternativeOption

AlternativeOption

A rendszerkép elavult állapotában a Publisher által megadott alternatív lehetőséget ismerteti.

imageState

ImageState

A kép állapotát ismerteti.

scheduledDeprecationTime

string

Az az időpont, amikor a rendszerkép elavultként lesz megjelölve. Ezt az ütemezett időpontot a Publisher választja ki.

ImageState

A kép állapotát ismerteti.

Érték Description
Active
Deprecated
ScheduledForDeprecation

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.

Érték Description
Linux
Windows

OSDiskImage

Az operációsrendszer-lemez lemezképének adatait tartalmazza.

Name Típus Description
operatingSystem

OperatingSystemTypes

Az osDiskImage operációs rendszere.

PurchasePlan

Bármely harmadik féltől származó összetevő vásárlási környezetének a MarketPlace-en keresztüli létrehozá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 ajánlat az imageReference elem alatt.

publisher

string

A közzétevő azonosítója.

VirtualMachineImage

Egy virtuálisgép-rendszerképet ír le.

Name Típus Description
extendedLocation

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

ArchitectureTypes

Az architektúra típusát adja meg

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

A rendszerkép automatikus operációsrendszer-frissítési tulajdonságait ismerteti.

properties.dataDiskImages

DataDiskImage[]

Az adatlemezképek adatait tartalmazza.

properties.disallowed

DisallowedConfiguration

A rendszerképből létrehozott VirtualMachine nem engedélyezett konfigurációját adja meg

properties.features

VirtualMachineImageFeature[]

A rendszerkép által támogatott további képességeket adja meg

properties.hyperVGeneration

HyperVGenerationTypes

A HyperVGeneration típusának megadása

properties.imageDeprecationStatus

ImageDeprecationStatus

A kép elavulási állapotának tulajdonságait ismerteti a képen.

properties.osDiskImage

OSDiskImage

Az operációsrendszer-lemez lemezképének adatait tartalmazza.

properties.plan

PurchasePlan

Bármely harmadik féltől származó összetevő vásárlási környezetének a MarketPlace-en keresztüli létrehozá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ásokrendszerezé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

A nem engedélyezett virtuálisgép-lemeztípusok.

Érték Description
None
Unmanaged