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”