Serviço de Metadados de Instância do Azure – versão prévia pública
O Serviço de Metadados de Instância (IMDS) do Azure fornece informações sobre instâncias da máquina virtual em execução no momento. Você pode usá-lo para gerenciar e configurar suas máquinas virtuais. Essas informações incluem as configurações de SKU, armazenamento e rede. Para obter uma lista completa dos dados disponíveis, consulte o resumo das categorias de ponto de extremidade.
O IMDS está disponível para a execução de instâncias de máquinas virtuais (VMs) e instâncias do conjunto de dimensionamento de máquinas virtuais. Todos os pontos de extremidade dão suporte a VMs criadas e gerenciadas usando o Azure Resource Manager.
O IMDS é uma API REST que está disponível em um endereço IP conhecido e não roteável (169.254.169.254). Você somente pode acessá-lo da VM. A comunicação entre a VM e a IMDS nunca sai do host. Você pode fazer com que seus clientes HTTP ignorem proxies web dentro da VM ao consultar o IMDS e tratar 169.254.169.254 da mesma forma que 168.63.129.16.
Uso
Para saber mais sobre o IMDS e como usá-lo, consulte a documentação do Serviço de Metadados de Instância do Azure. Este artigo se concentra nas diferenças entre o Azure e o Azure Stack Hub, pois o serviço está em versão prévia pública.
Diferenças entre o Azure e o Azure Stack Hub
Categorias de ponto de extremidade com suporte
A API do IMDS contém várias categorias de ponto de extremidade que representam diferentes fontes de dados, cada uma contendo um ou mais pontos de extremidades. Confira cada categoria para obter detalhes.
| Raiz da categoria | DESCRIÇÃO | Disponível no Azure Stack Hub |
|---|---|---|
| /metadata/atestado | Confira Dados Atestados | Não disponível |
| /metadata/identity | Confira Identidade Gerenciada por meio do IMDS | Não disponível |
| /metadata/instance | Consulte Metadados de instância | Azure Stack Hub 1.2108.2.73 |
| /metadata/loadbalancer | Confira Recuperar metadados do Load Balancer por meio do IMDS | Não disponível |
| /metadata/versions | Confira Versões | Azure Stack Hub 1.2108.2.73 |
Resposta rest
As propriedades a seguir retornam um valor diferente ou não devem retornar nada:
| Propriedade | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| Customdata | com suporte | Sem suporte |
| plan | com suporte | Sem suporte |
| zona | com suporte | Sem suporte |
Exemplo de resposta:
{
"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 com suporte
- "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"