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. |
publisher
|
path | True |
string |
Een geldige uitgever van installatiekopieën. |
skus
|
path | True |
string |
Een geldige installatiekopieën-SKU. |
subscription
|
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 |
OK |
|
Other Status Codes |
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
Virtual |
Virtual |
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
Voorbeeldrespons
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
Definities
Name | Description |
---|---|
Alternative |
Beschrijft de alternatieve optie die is opgegeven door publisher voor deze installatiekopieën wanneer deze installatiekopieën zijn afgeschaft. |
Alternative |
Beschrijft het type alternatieve optie. |
Api |
Api-fout. |
Api |
Api-foutbasis. |
Architecture |
Hiermee geeft u het type architectuur |
Automatic |
Hierin worden de eigenschappen voor automatische upgrade van het besturingssysteem op de installatiekopieën beschreven. |
Cloud |
Een foutreactie van de Compute-service. |
Data |
Bevat de gegevensschijfinstallatiekopieën. |
Disallowed |
Hiermee geeft u de niet-toegestane configuratie voor een installatiekopieën van een virtuele machine. |
Extended |
Het complexe type van de uitgebreide locatie. |
Extended |
Het type van de uitgebreide locatie. |
Hyper |
Hiermee geeft u het Type HyperVGeneratie |
Image |
Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding. |
Image |
Beschrijft de status van de afbeelding. |
Inner |
Interne foutdetails. |
Operating |
Het besturingssysteem van osDiskImage. |
OSDisk |
Bevat informatie over de installatiekopieën van de besturingssysteemschijf. |
Purchase |
Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace. |
Virtual |
Beschrijft een installatiekopieën van een virtuele machine. |
Virtual |
Hiermee geeft u aanvullende mogelijkheden die worden ondersteund door de installatiekopieën |
Vm |
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 |
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 |
Details van de API-fout |
|
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 |
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 |
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 |
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 |
Beschrijft de alternatieve optie die is opgegeven door publisher voor deze installatiekopieën wanneer deze installatiekopieën zijn afgeschaft. |
|
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 |
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 |
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 |
Hiermee geeft u het type architectuur |
|
properties.automaticOSUpgradeProperties |
Hierin worden de eigenschappen voor automatische upgrade van het besturingssysteem op de installatiekopieën beschreven. |
|
properties.dataDiskImages |
Bevat de gegevensschijfinstallatiekopieën. |
|
properties.disallowed |
Hiermee geeft u niet-toegestane configuratie op voor de virtuele machine die is gemaakt op basis van de installatiekopieën |
|
properties.features |
Hiermee geeft u aanvullende mogelijkheden die worden ondersteund door de installatiekopieën |
|
properties.hyperVGeneration |
Hiermee geeft u het Type HyperVGeneratie |
|
properties.imageDeprecationStatus |
Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding. |
|
properties.osDiskImage |
Bevat informatie over de installatiekopieën van de besturingssysteemschijf. |
|
properties.plan |
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 |