Azure Instance Metadata Service – 公開預覽

  • 發行項

The Azure Instance Metadata Service (IMDS) 提供目前執行中虛擬機器執行個體的相關資訊。 您可以使用其來管理及設定虛擬機器。 此資訊包括 SKU、儲存體和網路組態。 如需完整的可用資料清單，請參閱端點類別摘要。

IMDS 適用於執行中的虛擬機器 (VM) 執行個體和虛擬機器擴展集執行個體。 所有端點都支援使用 Azure Resource Manager 建立和管理的 VM。

IMDS 是位於已知非路由式 IP 位址 (169.254.169.254) 上的 REST API。 您只能從 VM 存取。 VM 與 IMDS 之間的通訊永遠不會離開主機。 在查詢 IMDS 時，您可以讓 HTTP 用戶端略過 VM 內的 Web Proxy，並將 169.254.169.254 視同 168.63.129.16。

使用方式

若要深入了解 IMDS 及其使用方式，請參閱 Azure Instance Metadata Service 文件。 本文著重於 Azure 與 Azure Stack Hub 之間的差異，因為服務處於公開預覽狀態。

Azure 與 Azure Stack Hub 之間的差異

支援的端點類別

IMDS API 包含代表不同資料來源的多個端點類別，每個類別都包含一或多個端點。 查看每個類別以取得詳細資料。

類別根目錄 描述 可用於 Azure Stack Hub
/metadata/attested 請參閱證明資料 尚未提供
/metadata/identity 請參閱透過 IMDS 的受控識別 尚未提供
/metadata/instance 請參閱執行個體中繼資料 Azure Stack Hub 1.2108.2.73
/metadata/loadbalancer 請參閱透過 IMDS 擷取 Load Balancer 中繼資料 尚未提供
/metadata/versions 請參閱版本 Azure Stack Hub 1.2108.2.73

REST 回應

下列屬性會傳回不同的值，或預計不會傳回任何值：

屬性 Azure Azure Stack Hub
azEnvironment AZUREPUBLICCLOUD AzureStack
customdata 支援 不支援
計劃 支援 不支援
區域 支援 不支援

範例回應：

{
  "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 版本

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