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-03-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 waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep. |
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
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
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"
}
Definities
Name | Description |
---|---|
Alternative |
Beschrijft de alternatieve optie die is opgegeven door de Uitgever voor deze afbeelding wanneer deze afbeelding wordt afgeschaft. |
Alternative |
Beschrijft het type van de alternatieve optie. |
Api |
API-fout. |
Api |
API-foutbasis. |
Architecture |
Hiermee geeft u het type architectuur op |
Automatic |
Hierin worden de eigenschappen van automatische besturingssysteemupgrade op de installatiekopieën beschreven. |
Cloud |
Een foutreactie van de Compute-service. |
Data |
Bevat de informatie over de installatiekopieën van de gegevensschijf. |
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 HyperVGeneration-type op |
Image |
Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding. |
Image |
Beschrijft de status van de afbeelding. |
Inner |
Details van interne fout. |
Operating |
Het besturingssysteem van osDiskImage. |
OSDisk |
Bevat de informatie over de installatiekopieën van de besturingssysteemschijf. |
Purchase |
Wordt gebruikt voor het vaststellen van de aankoopcontext van een artefact van derden via MarketPlace. |
Virtual |
Beschrijft een installatiekopieën van een virtuele machine. |
Virtual |
Hiermee geeft u aanvullende mogelijkheden op die worden ondersteund door de installatiekopieën |
Vm |
VM-schijftypen die niet zijn toegestaan. |
AlternativeOption
Beschrijft de alternatieve optie die is opgegeven door de Uitgever voor deze afbeelding wanneer deze afbeelding wordt afgeschaft.
Name | Type | Description |
---|---|---|
type |
Beschrijft het type van de alternatieve optie. |
|
value |
string |
Geeft de alternatieve optiewaarde aan die is opgegeven door de uitgever. Dit is de naam van de aanbieding wanneer het type Aanbieding is of de naam van het plan als het type Plan is. |
AlternativeType
Beschrijft het type van de alternatieve optie.
Name | Type | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
API-fout.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
details |
De API-foutdetails |
|
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 op
Name | Type | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
Hierin worden de eigenschappen van automatische besturingssysteemupgrade 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 informatie over de installatiekopieën van de gegevensschijf.
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 VM 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 HyperVGeneration-type op
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 de Uitgever voor deze afbeelding wanneer deze afbeelding wordt afgeschaft. |
|
imageState |
Beschrijft de status van de afbeelding. |
|
scheduledDeprecationTime |
string |
Het tijdstip waarop deze afbeelding in de toekomst als afgeschaft wordt gemarkeerd. 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
Details van interne fout.
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 de informatie over de installatiekopieën van de besturingssysteemschijf.
Name | Type | Description |
---|---|---|
operatingSystem |
Het besturingssysteem van osDiskImage. |
PurchasePlan
Wordt gebruikt voor het vaststellen van de aankoopcontext van een 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 Aanbieding 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 op |
|
properties.automaticOSUpgradeProperties |
Hierin worden de eigenschappen van automatische besturingssysteemupgrade op de installatiekopieën beschreven. |
|
properties.dataDiskImages |
Bevat de informatie over de installatiekopieën van de gegevensschijf. |
|
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 op die worden ondersteund door de installatiekopieën |
|
properties.hyperVGeneration |
Hiermee geeft u het HyperVGeneration-type op |
|
properties.imageDeprecationStatus |
Beschrijft eigenschappen van de afschaffingsstatus van de installatiekopieën op de afbeelding. |
|
properties.osDiskImage |
Bevat de informatie over de installatiekopieën van de besturingssysteemschijf. |
|
properties.plan |
Wordt gebruikt voor het vaststellen van de aankoopcontext van een artefact van derden via MarketPlace. |
|
tags |
object |
Hiermee geeft u de tags die zijn toegewezen aan de virtuele machine. Zie Tags gebruiken om uw Azure-resources te organiseren voor meer informatie over het gebruik van tags. |
VirtualMachineImageFeature
Hiermee geeft u aanvullende mogelijkheden op 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 |