Azure Instance Metadata Service – openbare preview
De Azure Instance Metadata Service (IMDS) biedt info over momenteel actieve exemplaren van virtuele machines. U kunt dit gebruiken om uw virtuele machines te beheren en te configureren. Deze informatie omvat de SKU, opslag en netwerkconfiguraties. Zie het overzicht van eindpuntcategorieën voor een volledige lijst met beschikbare gegevens.
IMDS is beschikbaar voor actieve exemplaren van virtuele machines (VM's) en instanties van virtuele-machineschaalsets. Alle eindpunten ondersteunen VM's die zijn gemaakt en beheerd met behulp van Azure Resource Manager.
IMDS is een REST API die beschikbaar is op een bekend, niet-routeerbaar IP-adres (169.254.169.254). U kunt dit alleen openen vanuit de virtuele machine. Communicatie tussen VM en IMDS verlaat de host nooit. U kunt uw HTTP-clients webproxy's in de VM laten omzeilen bij het uitvoeren van query's op IMDS en 169.254.169.254 op dezelfde wijze behandelen als 168.63.129.16.
Gebruik
Zie de documentatie voor Azure Instance Metadata Service voor meer informatie over IMDS en hoe u deze kunt gebruiken. Dit artikel is gericht op verschillen tussen Azure en Azure Stack Hub, omdat de service in openbare preview is.
Verschillen tussen Azure en Azure Stack Hub
Ondersteunde eindpuntcategorieën
De IMDS-API bevat meerdere eindpuntcategorieën die verschillende gegevensbronnen vertegenwoordigen, die elk een of meer eindpunten bevatten. Zie elke categorie voor meer informatie.
| Categoriehoofdmap | Beschrijving | Beschikbaar in Azure Stack Hub |
|---|---|---|
| /metadata/attested | Geteste gegevens bekijken | Niet beschikbaar |
| /metagegevens/identiteit | Zie Beheerde identiteit via IMDS | Niet beschikbaar |
| /metagegevens/exemplaar | Zie Metagegevens van exemplaar | Azure Stack Hub 1.2108.2.73 |
| /metadata/loadbalancer | Zie Metagegevens van Load Balancer ophalen via IMDS | Niet beschikbaar |
| /metagegevens/versies | Zie Versies | Azure Stack Hub 1.2108.2.73 |
Rest-antwoord
De volgende eigenschappen retourneren een andere waarde of er wordt verwacht dat ze niets retourneren:
| Eigenschap | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| customdata | Ondersteund | Niet ondersteund |
| plannen | Ondersteund | Niet ondersteund |
| zone | Ondersteund | Niet ondersteund |
Voorbeeldantwoord:
{
"compute": {
"azEnvironment": "AzureStack",
"customData": "",
"evictionPolicy": "",
"extendedLocation": {
"name": "",
"type": ""
},
"isHostCompatibilityLayerVm": "",
"licenseType": "",
"location": "orlando",
"name": "IMDSVALI",
"offer": "WindowsServer",
"osProfile": {
"adminUsername": "sampleuser",
"computerName": "IMDSVALI",
"disablePasswordAuthentication": ""
},
"osType": "Windows",
"placementGroupId": "",
"plan": {
"name": "",
"product": "",
"publisher": ""
},
"platformFaultDomain": "0",
"platformUpdateDomain": "0",
"priority": "",
"provider": "Microsoft.Compute",
"publicKeys": [
],
"publisher": "MicrosoftWindowsServer",
"resourceGroupName": "IMDS",
"resourceId": "/subscriptions/1cf1cb48-fad3-4872-9366-c5c51fe748e6/resourceGroups/IMDS/providers/Microsoft.Compute/virtualMachines/IMDSVALI",
"securityProfile": {
"secureBootEnabled": "",
"virtualTpmEnabled": ""
},
"sku": "2019-Datacenter",
"storageProfile": {
"dataDisks": [
],
"imageReference": {
"id": "",
"offer": "WindowsServer",
"publisher": "MicrosoftWindowsServer",
"sku": "2019-Datacenter",
"version": "17763.2114.2108051826"
},
"osDisk": {
"caching": "ReadWrite",
"createOption": "FromImage",
"diffDiskSettings": {
"option": ""
},
"diskSizeGB": "127",
"encryptionSettings": {
"enabled": "false"
},
"image": {
"uri": ""
},
"managedDisk": {
"id": "/subscriptions/1cf1cb48-fad3-4872-9366-c5c51fe748e6/resourceGroups/IMDS/providers/Mi
crosoft.Compute/disks/IMDSVALI_OsDisk_1_589d8d9cdd8a4c34a004b0dcecd68b05",
"storageAccountType": "Premium_LRS"
},
"name": "IMDSVALI_OsDisk_1_589d8d9cdd8a4c34a004b0dcecd68b05",
"osType": "Windows",
"vhd": {
"uri": ""
},
"writeAcceleratorEnabled": "false"
},
"resourceDisk": {
"size": ""
}
},
"subscriptionId": "1cf1cb48-fad3-4872-9366-c5c51fe748e6",
"tags": "",
"tagsList": [
],
"userData": "",
"version": "17763.2114.2108051826",
"virtualMachineScaleSet": {
"id": ""
},
"vmId": "fa4fb8e6-265d-4d5f-98cd-20b0a68bc678",
"vmScaleSetName": "",
"vmSize": "Standard_DS1_v2",
"zone": ""
},
"network": {
"interface": [
{
"ipv4": {
"ipAddress": [
{
"privateIpAddress": "10.0.2.4",
"publicIpAddress": "10.217.119.162"
}
],
"subnet": [
{
"address": "10.0.2.0",
"prefix": "24"
}
]
},
"ipv6": {
"ipAddress": [
]
},
"macAddress": "001DD8B700C3"
}
]
}
}
Ondersteunde API-versies
- "2017-03-01",
- "2017-04-02",
- "2017-08-01",
- "2017-10-01",
- "2017-12-01",
- "2018-02-01",
- "2018-04-02",
- "2018-10-01",
- "2019-02-01",
- "2019-03-11",
- "2019-04-30",
- "2019-06-01",
- "2019-06-04",
- "2019-08-01",
- "2019-08-15",
- "2019-11-01",
- "2020-06-01",
- "2020-07-15",
- "2020-09-01",
- "2020-10-01",
- "2020-12-01",
- "2021-01-01",
- "2021-02-01",
- "2021-03-01",
- "2021-05-01"