Azure 实例元数据服务 - 公共预览版

Azure 实例元数据服务 (IMDS) 提供有关当前正在运行的虚拟机实例的信息。 可以使用它来管理和配置虚拟机。 这些信息包括 SKU、存储和网络配置。 有关可用数据的完整列表,请参阅终结点类别摘要

IMDS 适用于运行虚拟机 (VM) 的实例和虚拟机规模集实例。 所有终结点均支持使用 Azure 资源管理器创建和管理的 VM。

IMDS 是一个 REST API,在已知的、不可路由的 IP 地址 (169.254.169.254) 上提供。 只能从 VM 中访问它。 VM 与 IMDS 之间的通信绝不会离开主机。 可让 HTTP 客户端在查询 IMDS 时绕过 VM 中的 Web 代理并同等对待 169.254.169.254 和 168.63.129.16。

使用情况

若要了解有关 IMDS 以及如何使用它的详细信息,请参阅 Azure 实例元数据服务文档。 本文重点介绍 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 检索负载均衡器元数据 不可用
/metadata/versions 请参阅版本 Azure Stack Hub 1.2108.2.73

REST 响应

以下属性要么返回不同的值,要么不返回任何值:

属性 由世纪互联运营的 Microsoft Azure Azure Stack Hub
azEnvironment AZURECHINACLOUD AzureStack
customData 受支持 不支持
plan 受支持 不支持
区域 受支持 不支持

示例响应:

{
  "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”