Serviço de Metadados do Azure Instance – pré-visualização pública
O Azure Instance Metadata Service (IMDS) disponibiliza informações sobre as instâncias de máquinas virtuais atualmente em execução. Pode utilizá-lo para gerir e configurar as suas máquinas virtuais. Estas informações incluem as configurações de SKU, armazenamento e rede. Para obter uma lista completa dos dados disponíveis, veja o resumo das categorias de pontos finais.
O IMDS está disponível para executar instâncias de máquinas virtuais (VMs) e instâncias de conjuntos de dimensionamento de máquinas virtuais. Todos os pontos finais suportam VMs criadas e geridas com o Azure Resource Manager.
O IMDS é uma API REST que está disponível num endereço IP bem conhecido e não encaminhável (169.254.169.254). Só é possível aceder ao mesmo a partir da VM. A comunicação entre a VM e o IMDS nunca sai do anfitrião. Pode fazer com que os seus clientes HTTP ignorem os proxies Web na VM ao consultar o IMDS e tratem 169.254.169.254 da mesma forma que 168.63.129.16.
Utilização
Para saber mais sobre o IMDS e como utilizá-lo, veja a documentação do Serviço de Metadados do Azure Instance. Este artigo centra-se nas diferenças entre o Azure e o Azure Stack Hub, uma vez que o serviço está em pré-visualização pública.
Diferenças entre o Azure e o Azure Stack Hub
Categorias de pontos finais suportadas
A API IMDS contém várias categorias de pontos finais que representam diferentes origens de dados, cada uma das quais contém um ou mais pontos finais. Veja cada categoria para obter detalhes.
| Raiz da categoria | Descrição | Disponível no Azure Stack Hub |
|---|---|---|
| /metadados/atestados | Ver Dados Atestados | Não disponível |
| /metadados/identidade | Veja Identidade Gerida através do IMDS | Não disponível |
| /metadados/instância | Veja Metadados de instância | Azure Stack Hub 1.2108.2.73 |
| /metadados/balanceador de carga | Veja Obter metadados de Balanceador de Carga através do IMDS | Não disponível |
| /metadados/versões | Ver Versões | Azure Stack Hub 1.2108.2.73 |
Resposta rest
As seguintes propriedades devolvem um valor diferente ou espera-se que não devolvam nada:
| Propriedade | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| customdata | Suportado | Não suportado |
| plano | Suportado | Não suportado |
| zona | Suportado | Não suportado |
Resposta de exemplo:
{
"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"
}
]
}
}
Versões de API suportadas
- "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"