Delen via


Virtual Machine Images - Get

Hiermee haalt u een installatiekopieën van een virtuele machine op.

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-parameters

Name In Vereist Type Description
location
path True

string

De naam van een ondersteunde Azure-regio.

offer
path True

string

Een geldige aanbieding voor de uitgever van installatiekopieën.

publisherName
path True

string

Een geldige uitgever van installatiekopieën.

skus
path True

string

Een geldige installatiekopieën-SKU.

subscriptionId
path True

string

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

version
path True

string

Een geldige versie van de installatiekopieën-SKU.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

VirtualMachineImage

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AlternativeOption

Beschrijft de alternatieve optie die is opgegeven door publisher voor deze installatiekopieën wanneer deze installatiekopieën zijn afgeschaft.

AlternativeType

Beschrijft het type alternatieve optie.

ApiError

Api-fout.

ApiErrorBase

Api-foutbasis.

ArchitectureTypes

Hiermee geeft u het type architectuur

AutomaticOSUpgradeProperties

Hierin worden de eigenschappen voor automatische upgrade van het besturingssysteem op de installatiekopieën beschreven.

CloudError

Een foutreactie van de Compute-service.

DataDiskImage

Bevat de gegevensschijfinstallatiekopieën.

DisallowedConfiguration

Hiermee geeft u de niet-toegestane configuratie voor een installatiekopieën van een virtuele machine.

ExtendedLocation

Het complexe type van de uitgebreide locatie.

ExtendedLocationTypes

Het type van de uitgebreide locatie.

HyperVGenerationTypes

Hiermee geeft u het Type HyperVGeneratie

ImageDeprecationStatus

Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding.

ImageState

Beschrijft de status van de afbeelding.

InnerError

Interne foutdetails.

OperatingSystemTypes

Het besturingssysteem van osDiskImage.

OSDiskImage

Bevat informatie over de installatiekopieën van de besturingssysteemschijf.

PurchasePlan

Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace.

VirtualMachineImage

Beschrijft een installatiekopieën van een virtuele machine.

VirtualMachineImageFeature

Hiermee geeft u aanvullende mogelijkheden die worden ondersteund door de installatiekopieën

VmDiskTypes

VM-schijftypen die niet zijn toegestaan.

AlternativeOption

Beschrijft de alternatieve optie die is opgegeven door publisher voor deze installatiekopieën wanneer deze installatiekopieën zijn afgeschaft.

Name Type Description
type

AlternativeType

Beschrijft het type alternatieve optie.

value

string

Geeft de alternatieve optiewaarde aan die is opgegeven door publisher. Dit is de naam van de aanbieding wanneer het type Aanbieding of de abonnementsnaam is wanneer het type Abonnement is.

AlternativeType

Beschrijft het type alternatieve optie.

Name Type Description
None

string

Offer

string

Plan

string

ApiError

Api-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

Details van de API-fout

innererror

InnerError

De interne API-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

Api-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ArchitectureTypes

Hiermee geeft u het type architectuur

Name Type Description
Arm64

string

x64

string

AutomaticOSUpgradeProperties

Hierin worden de eigenschappen voor automatische upgrade van het besturingssysteem op de installatiekopieën beschreven.

Name Type Description
automaticOSUpgradeSupported

boolean

Hiermee geeft u op of automatische upgrade van het besturingssysteem wordt ondersteund op de installatiekopieën.

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

Api-fout.

DataDiskImage

Bevat de gegevensschijfinstallatiekopieën.

Name Type Description
lun

integer

Hiermee geeft u het nummer van de logische eenheid van de gegevensschijf. Deze waarde wordt gebruikt om gegevensschijven binnen de VIRTUELE machine te identificeren en moet daarom uniek zijn voor elke gegevensschijf die is gekoppeld aan een VIRTUELE machine.

DisallowedConfiguration

Hiermee geeft u de niet-toegestane configuratie voor een installatiekopieën van een virtuele machine.

Name Type Description
vmDiskType

VmDiskTypes

VM-schijftypen die niet zijn toegestaan.

ExtendedLocation

Het complexe type van de uitgebreide locatie.

Name Type Description
name

string

De naam van de uitgebreide locatie.

type

ExtendedLocationTypes

Het type van de uitgebreide locatie.

ExtendedLocationTypes

Het type van de uitgebreide locatie.

Name Type Description
EdgeZone

string

HyperVGenerationTypes

Hiermee geeft u het Type HyperVGeneratie

Name Type Description
V1

string

V2

string

ImageDeprecationStatus

Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding.

Name Type Description
alternativeOption

AlternativeOption

Beschrijft de alternatieve optie die is opgegeven door publisher voor deze installatiekopieën wanneer deze installatiekopieën zijn afgeschaft.

imageState

ImageState

Beschrijft de status van de afbeelding.

scheduledDeprecationTime

string

De tijd, in de toekomst, waarop deze afbeelding wordt gemarkeerd als afgeschaft. Deze geplande tijd wordt gekozen door de uitgever.

ImageState

Beschrijft de status van de afbeelding.

Name Type Description
Active

string

Deprecated

string

ScheduledForDeprecation

string

InnerError

Interne foutdetails.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

OperatingSystemTypes

Het besturingssysteem van osDiskImage.

Name Type Description
Linux

string

Windows

string

OSDiskImage

Bevat informatie over de installatiekopieën van de besturingssysteemschijf.

Name Type Description
operatingSystem

OperatingSystemTypes

Het besturingssysteem van osDiskImage.

PurchasePlan

Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace.

Name Type Description
name

string

De plan-id.

product

string

Hiermee geeft u het product van de installatiekopieën van de marketplace. Dit is dezelfde waarde als Offer onder het element imageReference.

publisher

string

De uitgever-id.

VirtualMachineImage

Beschrijft een installatiekopieën van een virtuele machine.

Name Type Description
extendedLocation

ExtendedLocation

De uitgebreide locatie van de virtuele machine.

id

string

Resource-id

location

string

De ondersteunde Azure-locatie van de resource.

name

string

De naam van de resource.

properties.architecture

ArchitectureTypes

Hiermee geeft u het type architectuur

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

Hierin worden de eigenschappen voor automatische upgrade van het besturingssysteem op de installatiekopieën beschreven.

properties.dataDiskImages

DataDiskImage[]

Bevat de gegevensschijfinstallatiekopieën.

properties.disallowed

DisallowedConfiguration

Hiermee geeft u niet-toegestane configuratie op voor de virtuele machine die is gemaakt op basis van de installatiekopieën

properties.features

VirtualMachineImageFeature[]

Hiermee geeft u aanvullende mogelijkheden die worden ondersteund door de installatiekopieën

properties.hyperVGeneration

HyperVGenerationTypes

Hiermee geeft u het Type HyperVGeneratie

properties.imageDeprecationStatus

ImageDeprecationStatus

Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding.

properties.osDiskImage

OSDiskImage

Bevat informatie over de installatiekopieën van de besturingssysteemschijf.

properties.plan

PurchasePlan

Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace.

tags

object

Hiermee geeft u de tags op die zijn toegewezen aan de virtuele machine. Zie Tags gebruiken om uw Azure-resources te organiserenvoor meer informatie over het gebruik van tags.

VirtualMachineImageFeature

Hiermee geeft u aanvullende mogelijkheden die worden ondersteund door de installatiekopieën

Name Type Description
name

string

De naam van de functie.

value

string

De bijbehorende waarde voor de functie.

VmDiskTypes

VM-schijftypen die niet zijn toegestaan.

Name Type Description
None

string

Unmanaged

string