Azure Instance Metadata Service – offentlig förhandsversion

Azure Instance Metadata Service (IMDS) innehåller information om instanser av virtuella datorer som körs just nu. Du kan använda den till att hantera och konfigurera dina virtuella datorer. Den här informationen omfattar SKU, lagring och nätverkskonfigurationer. En fullständig lista över tillgängliga data finns i sammanfattningen av slutpunktskategorierna.

IMDS är tillgängligt för att köra instanser av virtuella datorer (VM) och vm-skalningsuppsättningsinstanser. Alla slutpunkter stöder virtuella datorer som skapats och hanteras med hjälp av Azure Resource Manager.

IMDS är ett REST-API som är tillgängligt på en välkänd, icke-dirigerbar IP-adress (169.254.169.254). Du kan bara komma åt den från den virtuella datorn. Kommunikationen mellan den virtuella datorn och IMDS lämnar aldrig värden. Du kan låta HTTP-klienterna kringgå webbproxy i den virtuella datorn när du kör frågor mot IMDS och behandla 169.254.169.254 på samma sätt som 168.63.129.16.

Användning

Mer information om IMDS och hur du använder det finns i dokumentationen för Azure Instance Metadata Service. Den här artikeln fokuserar på skillnader mellan Azure och Azure Stack Hub, eftersom tjänsten är i offentlig förhandsversion.

Skillnader mellan Azure och Azure Stack Hub

Slutpunktskategorier som stöds

IMDS-API:et innehåller flera slutpunktskategorier som representerar olika datakällor, som var och en innehåller en eller flera slutpunkter. Mer information finns i varje kategori.

Kategorirot Description Tillgängligt i Azure Stack Hub
/metadata/attesterad Se Attesterade data Inte tillgängligt
/metadata/identitet Se Hanterad identitet via IMDS Inte tillgängligt
/metadata/instans Se Instansmetadata Azure Stack Hub 1.2108.2.73
/metadata/loadbalancer Se Hämta Load Balancer metadata via IMDS Inte tillgängligt
/metadata/versioner Se versioner Azure Stack Hub 1.2108.2.73

Vilosvar

Följande egenskaper returnerar antingen ett annat värde eller förväntas inte returnera något:

Egenskap Azure Azure Stack Hub
azEnvironment AZUREPUBLICCLOUD AzureStack
customdata stöds Stöds inte
planera stöds Stöds inte
zon stöds Stöds inte

Exempelsvar:

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

API-versioner som stöds

  • "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"