Servizio metadati dell'istanza di Azure - anteprima pubblica
Il servizio metadati dell'istanza di Azure (IMDS) fornisce informazioni sulle istanze di macchine virtuali attualmente in esecuzione. È possibile usarlo per gestire e configurare le macchine virtuali. Queste informazioni includono le configurazioni di SKU, archiviazione e rete. Per un elenco completo dei dati disponibili, vedere il riepilogo delle categorie di endpoint.
IMDS è disponibile per l'esecuzione di istanze di macchine virtuali e istanze del set di scalabilità di macchine virtuali. Tutti gli endpoint supportano macchine virtuali create e gestite usando Azure Resource Manager.
IMDS è un'API REST disponibile in un indirizzo IP noto e non instradabile (169.254.169.254.254). È possibile accedervi solo dall'interno della macchina virtuale. La comunicazione tra la macchina virtuale e IMDS non lascia mai l'host. I client HTTP possono ignorare i proxy Web all'interno della macchina virtuale durante la query su IMDS e trattano 169.254.169.254 uguali a 168.63.129.129.16.
Utilizzo
Per altre informazioni su IMDS e su come usarlo, vedere la documentazione del servizio metadati dell'istanza di Azure. Questo articolo è incentrato sulle differenze tra Azure e l'hub di Azure Stack, in quanto il servizio è in anteprima pubblica.
Differenze tra Azure e l'hub di Azure Stack
Categorie di endpoint supportate
L'API IMDS contiene più categorie di endpoint che rappresentano origini dati diverse, ognuna delle quali contiene uno o più endpoint. Per informazioni dettagliate, vedere ogni categoria.
| Radice categoria | Descrizione | Disponibile nell'hub di Azure Stack |
|---|---|---|
| /metadata/attestato | Vedere Dati con attestazione | Non disponibile |
| /metadata/identity | Vedere Identità gestita tramite IMDS | Non disponibile |
| /metadata/instance | Vedere Metadati dell'istanza | Hub di Azure Stack 1.2108.2.73 |
| /metadata/loadbalancer | Vedere Recuperare i metadati Load Balancer tramite IMDS | Non disponibile |
| /metadata/version | Vedere Versioni | Hub di Azure Stack 1.2108.2.73 |
Risposta rest
Le proprietà seguenti restituiscono un valore diverso o non devono restituire nulla:
| Proprietà | Azure | Hub di Azure Stack |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| Customdata | supportato | Non supportato |
| piano | supportato | Non supportato |
| zona | supportato | Non supportato |
Risposta di esempio:
{
"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"
}
]
}
}
Versioni API supportate
- "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"