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/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"
                              }
                          ]
            }
}

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"