Azure Instance Metadata Service – パブリック プレビュー
Azure Instance Metadata Service (IMDS) によって、現在実行中の仮想マシン インスタンスに関する情報が提供されます。 これを使用して、仮想マシンの管理と構成を行うことができます。 この情報には、SKU、ストレージ、ネットワーク構成などが含まれています。 使用できるデータの完全な一覧については、エンドポイント カテゴリの概要に関するページを参照してください。
IMDS は、仮想マシン (VM) のインスタンスと仮想マシン スケール セット インスタンスを実行するために使用できます。 Azure Resource Manager を使用して作成および管理されている VM は、すべてのエンドポイントでサポートされます。
IMDS は、既知のルーティング不可能な IP アドレス (169.254.169.254) で使用できる REST API です。 VM 内からのみアクセスできます。 VM と IMDS 間の通信がホストから離れることはありません。 HTTP クライアントに、IMDS に対してクエリを実行するときに VM 内の Web プロキシをバイパスさせ、169.254.169.254 を 168.63.129.16 と同様に扱わせることができます。
使用
IMDS とその使用方法の詳細については、Azure Instance Metadata Service のドキュメントを参照してください。 サービスがパブリック プレビュー段階であるため、この記事では、Azure と Azure Stack Hub の違いに焦点を当てています。
Azure と Azure Stack Hub の違い
サポートされているエンドポイント カテゴリ
IMDS API には、さまざまなデータ ソースを表す複数のエンドポイント カテゴリが含まれており、それぞれに 1 つ以上のエンドポイントが含まれています。 詳細については、各カテゴリを参照してください。
| カテゴリ ルート | 説明 | Azure Stack Hub で使用可能かどうか |
|---|---|---|
| /metadata/attested | 「構成証明済みデータ」をご覧ください | 使用不可 |
| /metadata/identity | IMDS 経由でのマネージド ID に関するページを参照 | 使用不可 |
| /metadata/instance | 「インスタンス メタデータ」を参照 | Azure Stack Hub 1.2108.2.73 |
| /metadata/loadbalancer | 「IMDS を使用した Load Balancer メタデータの取得」を参照 | 使用不可 |
| /metadata/versions | 「バージョン」を参照 | Azure Stack Hub 1.2108.2.73 |
REST 応答
次のプロパティは、別の値を返すか、何も返さないと想定されます。
| プロパティ | Azure | Azure Stack Hub |
|---|---|---|
| azEnvironment | AZUREPUBLICCLOUD | AzureStack |
| customdata | サポート対象 | サポートされていません |
| plan | サポート対象 | サポートされていません |
| ゾーン | サポート対象 | サポートされていません |
応答のサンプル:
{
"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"
}
]
}
}
サポートされる API バージョン
- "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"