Sdílet prostřednictvím


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-07-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 imagí

publisherName
path True

string

Platný vydavatel image.

skus
path True

string

Platná skladová položka image.

subscriptionId
path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří 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

VirtualMachineImage

OK

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
AlternativeOption

Popisuje alternativní možnost určenou publisherem pro tento obrázek, pokud je tato image zastaralá.

AlternativeType

Popisuje typ alternativní možnosti.

ApiError

Chyba rozhraní API

ApiErrorBase

Základ chyb rozhraní API.

ArchitectureTypes

Určuje typ architektury.

AutomaticOSUpgradeProperties

Popisuje vlastnosti automatického upgradu operačního systému na imagi.

CloudError

Odpověď na chybu z výpočetní služby

DataDiskImage

Obsahuje informace o imagích datových disků.

DisallowedConfiguration

Určuje nepovolenou konfiguraci pro image virtuálního počítače.

ExtendedLocation

Komplexní typ rozšířeného umístění.

ExtendedLocationTypes

Typ rozšířeného umístění.

HyperVGenerationTypes

Určuje typ HyperVGeneration.

ImageDeprecationStatus

Popisuje vlastnosti stavu vyřazení obrázku na obrázku.

ImageState

Popisuje stav image.

InnerError

Podrobnosti vnitřní chyby.

OperatingSystemTypes

Operační systém osDiskImage.

OSDiskImage

Obsahuje informace o imagi disku s operačním systémem.

PurchasePlan

Používá se k vytvoření kontextu nákupu jakéhokoli artefaktu třetí strany prostřednictvím MarketPlace.

VirtualMachineImage

Popisuje image virtuálního počítače.

VirtualMachineImageFeature

Určuje další možnosti podporované imagí.

VmDiskTypes

Typy disků virtuálních počítačů, které nejsou zakázány.

AlternativeOption

Popisuje alternativní možnost určenou publisherem pro tento obrázek, pokud je tato image zastaralá.

Name Typ Description
type

AlternativeType

Popisuje typ alternativní možnosti.

value

string

Označuje alternativní hodnotu možnosti určenou vydavatelem. Toto je 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

ApiErrorBase[]

Podrobnosti o chybě rozhraní API

innererror

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 je na imagi podporován automatický upgrade operačního systému.

CloudError

Odpověď na chybu z výpočetní služby

Name Typ Description
error

ApiError

Chyba rozhraní API

DataDiskImage

Obsahuje informace o imagích datových disků.

Name Typ Description
lun

integer

Určuje počet logických jednotek 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 pro image virtuálního počítače.

Name Typ Description
vmDiskType

VmDiskTypes

Typy disků virtuálních počítačů, které nejsou 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

ExtendedLocationTypes

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í obrázku na obrázku.

Name Typ Description
alternativeOption

AlternativeOption

Popisuje alternativní možnost určenou publisherem pro tento obrázek, pokud je tato image zastaralá.

imageState

ImageState

Popisuje stav image.

scheduledDeprecationTime

string

V budoucnu bude tento obrázek označený jako zastaralý. Tento naplánovaný čas zvolí Publisher.

ImageState

Popisuje stav image.

Name Typ Description
Active

string

Deprecated

string

ScheduledForDeprecation

string

InnerError

Podrobnosti vnitřní chyby.

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

OperatingSystemTypes

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 produkt image z marketplace. Jedná se o stejnou hodnotu jako Offer pod elementem imageReference.

publisher

string

ID vydavatele.

VirtualMachineImage

Popisuje image virtuálního počítače.

Name Typ Description
extendedLocation

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

ArchitectureTypes

Určuje typ architektury.

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

Popisuje vlastnosti automatického upgradu operačního systému na imagi.

properties.dataDiskImages

DataDiskImage[]

Obsahuje informace o imagích datových disků.

properties.disallowed

DisallowedConfiguration

Určuje nepovolenou konfiguraci virtuálního počítače vytvořeného z image.

properties.features

VirtualMachineImageFeature[]

Určuje další možnosti podporované imagí.

properties.hyperVGeneration

HyperVGenerationTypes

Určuje typ HyperVGeneration.

properties.imageDeprecationStatus

ImageDeprecationStatus

Popisuje vlastnosti stavu vyřazení obrázku na obrázku.

properties.osDiskImage

OSDiskImage

Obsahuje informace o imagi disku s operačním systémem.

properties.plan

PurchasePlan

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řazeny k 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é imagí.

Name Typ Description
name

string

Název funkce.

value

string

Odpovídající hodnota funkce.

VmDiskTypes

Typy disků virtuálních počítačů, které nejsou zakázány.

Name Typ Description
None

string

Unmanaged

string