Azure Instance Metadata Service: Public Preview
Der Azure Instance Metadata Service (IMDS) stellt Informationen zu Instanzen virtueller Computer bereit, die derzeit ausgeführt werden. Sie können ihn zur Verwaltung und Konfiguration Ihrer virtuellen Computer verwenden. Diese Informationen umfassen die SKU, den Speicher und Netwerkkonfigurationen. Eine umfassende Liste der verfügbaren Daten finden Sie in der Übersicht über die Endpunktkategorien.
Der IMDS ist für das Ausführen von Instanzen virtueller Computer (VMs) und VM-Skalierungsgruppen verfügbar. Alle Endpunkte unterstützen VMs, die mit Azure Resource Manager erstellt und verwaltet werden.
IMDS ist eine REST-API, die unter einer bekannten, nicht routingfähigen IP-Adresse (169.254.169.254) verfügbar ist. Sie können nur vom virtuellen Computer aus darauf zugreifen. Die Kommunikation zwischen dem virtuellen Computer und IMDS verlässt niemals den Host. Die HTTP-Clients können bei IMDS-Abfragen Webproxys innerhalb der VM umgehen und 169.254.169.254 auf die gleiche Weise behandeln wie 168.63.129.16.
Verwendung
Weitere Informationen zu IMDS und zur Verwendung des Diensts finden Sie in der Dokumentation zu Azure Instance Metadata Service. Dieser Artikel konzentriert sich auf Unterschiede zwischen Azure und Azure Stack Hub, da sich der Dienst in der Public Preview-Phase befindet.
Unterschiede zwischen Azure und Azure Stack Hub
Unterstützte Endpunktkategorien
Die IMDS-API enthält mehrere Endpunktkategorien, die verschiedene Datenquellen darstellen, die jeweils einen oder mehrere Endpunkte enthalten. Ausführlichere Informationen finden Sie in der jeweiligen Kategorie.
| Kategoriestamm | BESCHREIBUNG | Verfügbar im Azure Stack Hub |
|---|---|---|
| /metadata/attested | Siehe Bestätigte Daten | Nicht verfügbar |
| /metadata/identity | Siehe Verwaltete Identität | Nicht verfügbar |
| /metadata/instance | Siehe Instanzmetadaten | Azure Stack Hub 1.2108.2.73 |
| /metadata/loadbalancer | Weitere Informationen finden Sie unter Abrufen von Load Balancer Metadaten über IMDS | Nicht verfügbar |
| /metadata/versions | Siehe Versionen | Azure Stack Hub 1.2108.2.73 |
REST-Antwort
Bei den folgenden Eigenschaften wird entweder ein anderer Wert zurückgegeben oder erwartet, dass nichts zurückgegeben wird:
| Eigenschaft | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| customdata | Unterstützt | Nicht unterstützt |
| Tarif | Unterstützt | Nicht unterstützt |
| Zone | Unterstützt | Nicht unterstützt |
Beispiel für eine Antwort:
{
"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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"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"
}
]
}
}
Unterstützte API-Versionen
- "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"