Служба метаданных экземпляров Azure — общедоступная предварительная версия

Служба метаданных экземпляров Azure (IMDS) содержит сведения о текущем выполнении экземпляров виртуальных машин. Ее можно использовать для управления виртуальными машинами и их настройки. Эти сведения включают SKU, конфигурации хранилища и сети. Полный список доступных данных см. в сводке по категориям конечных точек.

Служба IMDS доступна для запущенных экземпляров виртуальных машин и экземпляров масштабируемых наборов виртуальных машин. Все конечные точки поддерживают виртуальные машины, созданные и управляемые с помощью Azure Resource Manager.

IMDS — это REST API, доступный по известному, не маршрутизируемому IP-адресу (169.254.169.254). Доступ к нему можно получить только из виртуальной машины. Обмен данными между виртуальной машиной и службой IMDS никогда не выходит за пределы узла. Http-клиенты могут обходить веб-прокси в виртуальной машине при запросе IMDS и обрабатывать 169.254.169.254 так же, как 168.63.129.16.

Использование

Дополнительные сведения об IMDS и его использовании см. в документации по службе метаданных экземпляров Azure. В этой статье рассматриваются различия между Azure и Azure Stack Hub, так как служба находится в общедоступной предварительной версии.

Различия между Azure и Azure Stack Hub

Поддерживаемые категории конечных точек

В API службы IMDS есть несколько категорий конечных точек, представляющих различные источники данных, каждый из которых содержит одну или несколько конечных точек. Дополнительные сведения см. в описании конкретной категории.

Корень категории Описание Доступно в Azure Stack Hub
/metadata/attested См. раздел Аттестованные данные. Недоступно
/metadata/identity См. раздел Управляемые удостоверения через IMDS. Недоступно
/metadata/instance См. раздел Метаданные экземпляра. Azure Stack Hub 1.2108.2.73
/metadata/loadbalancer См. раздел Получение метаданных Load Balancer через IMDS. Недоступно
/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"