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 le istanze in esecuzione delle macchine virtuali e le istanze dei set di scalabilità delle macchine virtuali. Tutti gli endpoint supportano le macchine virtuali create e gestite con Azure Resource Manager.
IMDS è un'API REST disponibile in un indirizzo IP noto non instradabile (169.254.169.254.169.254). È possibile accedervi solo dall'interno della macchina virtuale. La comunicazione tra la macchina virtuale e IMDS non lascia mai l'host. È possibile che i client HTTP ignorino i proxy Web all'interno della macchina virtuale durante l'esecuzione di query su IMDS e considerino 169.254.169.254 come 168.63.129.16.
Uso
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, perché 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.
| Categoria principale | Descrizione | Disponibile nell'hub di Azure Stack |
|---|---|---|
| /metadata/attestato | Vedere dati attestati | Non disponibile |
| /metadata/identity | Vedere identità gestita di tramite IMDS | Non disponibile |
| /metadata/instance | Consultare metadati dell'istanza | Hub di Azure Stack 1.2108.2.73 |
| /metadata/loadbalancer | Consultare Recuperare i metadati del bilanciatore di carico tramite IMDS | Non disponibile |
| /metadata/versions | Vedere Versioni | Hub di Azure Stack 1.2108.2.73 |
Risposta REST
Le proprietà seguenti restituiscono un valore diverso o non restituiscono nulla:
| Proprietà | Azzurro | Azure Stack Hub |
|---|---|---|
| azEnvironment | Azure Cloud Pubblico | AzureStack |
| dati personalizzati | 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 dell'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",
- "01-05-2021"