Azure Instance Metadata Service – genel önizleme

Azure Örnek Meta Veri Hizmeti (IMDS), güncel çalışan sanal makine örnekleri hakkında bilgi sağlar. Sanal makinelerinizi yönetmek ve yapılandırmak için bunu kullanabilirsiniz. Bu bilgiler SKU, depolama ve ağ yapılandırmalarını içerir. Kullanılabilir verilerin tam listesi için uç nokta kategorileri özeti bölümüne bakın.

IMDS, çalışan sanal makine (VM) örnekleri ve sanal makine ölçek kümesi örnekleri için kullanılabilir. Tüm uç noktalar, Azure Resource Manager kullanılarak oluşturulan ve yönetilen VM'leri destekler.

IMDS, iyi bilinen, yönlendirilemeyen bir IP adresinde (169.254.169.254) kullanılabilen bir REST API'dir. Yalnızca VM'nin içinden erişebilirsiniz. VM ile IMDS arasındaki iletişim hiçbir zaman konağı terk etmez. IMDS'yi sorgularken HTTP istemcilerinizin VM içindeki web proxy'lerini atlamasına ve 169.254.169.254'e 168.63.129.16 ile aynı şekilde davranmasını sağlayabilirsiniz.

Kullanım

IMDS ve nasıl kullanılacağı hakkında daha fazla bilgi edinmek için Bkz. Azure Örnek Meta Veri Hizmeti belgeleri. Bu makalede, hizmet genel önizleme aşamasında olduğundan Azure ile Azure Stack Hub arasındaki farklar ele alınmaktadır.

Azure ile Azure Stack Hub arasındaki farklar

Desteklenen uç nokta kategorileri

IMDS API'sinde, her biri bir veya daha fazla uç nokta içeren farklı veri kaynaklarını temsil eden birden çok uç nokta kategorisi bulunur. Ayrıntılar için her kategoriye bakın.

Kategori kökü Description Azure Stack Hub'da kullanılabilir
/metadata/attested Bkz . Kanıtlanan Veriler Kullanılamaz
/metadata/identity Bkz. IMDS aracılığıyla Yönetilen Kimlik Kullanılamaz
/metadata/instance Bkz . Örnek meta verileri Azure Stack Hub 1.2108.2.73
/metadata/loadbalancer Bkz. IMDS aracılığıyla Load Balancer meta verileri alma Kullanılamaz
/metadata/versions Bkz. Sürümler Azure Stack Hub 1.2108.2.73

Rest yanıtı

Aşağıdaki özellikler farklı bir değer döndürür veya hiçbir şey döndürmemesi beklenir:

Özellik Azure Azure Stack Hub
azEnvironment AZUREPUBLICCLOUD AzureStack
Customdata destekleniyor Desteklenmez
plan destekleniyor Desteklenmez
bölge destekleniyor Desteklenmez

Örnek yanıt:

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

Desteklenen API sürümleri

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