Azure Instance Metadata Service: versión preliminar pública
Azure Instance Metadata Service (IMDS) le proporciona información sobre las instancias de máquina virtual que se ejecutan actualmente. Puede usarlo para administrar y configurar las máquinas virtuales. Esta información incluye las configuraciones de SKU, almacenamiento y red. Para ver una lista completa de los datos disponibles, consulte el resumen de categorías de los puntos de conexión.
IMDS está disponible para ejecutar instancias de máquinas virtuales (VM) e instancias de un conjunto de escalado de máquinas virtuales. Todos los puntos de conexión admiten máquinas virtuales creadas y administradas mediante Azure Resource Manager.
IMDS es una API REST disponible en una dirección IP conocida y no enrutable (169.254.169.254). Solo puede acceder a ella desde la máquina virtual. La comunicación entre la VM e IMDS nunca sale del host. Puede sugerir a sus clientes HTTP que omitan los servidores proxy web dentro de la VM al consultar a IMDS y que consideren a 169.254.169.254 lo mismo que a 168.63.129.16.
Uso
Para más información sobre IMDS y cómo usarlo, consulte la documentación de Azure Instance Metadata Service. Este artículo se centra en las diferencias entre Azure y Azure Stack Hub, ya que el servicio se encuentra en versión preliminar pública.
Diferencias entre Azure y Azure Stack Hub
Categorías de punto de conexión compatibles
La API de IMDS contiene varias categorías de punto de conexión que representan distintos orígenes de datos, cada uno de los cuales contiene uno o varios puntos de conexión. Consulte las categorías para más información.
| Raíz de la categoría | Descripción | Disponible en Azure Stack Hub |
|---|---|---|
| /metadata/attested | Consulte Datos atestiguados | No disponible |
| /metadata/identity | Consulte Identidad administrada mediante IMDS. | No disponible |
| /metadata/instance | Consulte Metadatos de instancia. | Azure Stack Hub 1.2108.2.73 |
| /metadata/loadbalancer | Consulte Recuperación de metadatos de Load Balancer a través de IMDS. | No disponible |
| /metadata/versions | Consulte Versiones. | Azure Stack Hub 1.2108.2.73 |
Respuesta REST
Las propiedades siguientes devuelven un valor diferente o se espera que no devuelvan nada:
| Propiedad | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| customdata | admitido | No compatible |
| plan | admitido | No compatible |
| zona | admitido | No compatible |
Respuesta de ejemplo:
{
"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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"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"
}
]
}
}
Versiones de API admitidas
- "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"