Azure Instance Metadata Service

[アーティクル]
2024/10/15

適用対象: ✔️ Linux VM ✔️ Windows VM ✔️ フレキシブルスケールセット

Azure Instance Metadata Service (IMDS) によって、現在実行中の仮想マシンインスタンスに関する情報が提供されます。これを使用して、仮想マシンの管理と構成を行うことができます。この情報には、SKU、ストレージ、ネットワークの構成、今後のメンテナンスイベントなどがあります。使用できるデータの完全な一覧については、エンドポイントカテゴリの概要に関するページを参照してください。

IMDS は、仮想マシン (VM) のインスタンスとスケールセットインスタンスを実行するために使用できます。 Azure Resource Manager を使用して作成および管理されている VM は、すべてのエンドポイントでサポートされます。クラシックデプロイモデルを使用して作成された VM は、構成証明されたカテゴリと、インスタンスカテゴリのネットワーク部分のみでサポートされます。構成証明されたエンドポイントでのサポートは、制限された範囲内のみとなります。

IMDS は、既知のルーティング不可能な IP アドレス (169.254.169.254) で使用できる REST API です。 VM 内からのみアクセスできます。 VM と IMDS 間の通信がホストから離れることはありません。 IMDS に対してクエリを実行する場合は、HTTP クライアントが VM 内の Web プロキシをバイパスするようにします。

使用方法

Azure Instance Metadata Service にアクセスする

IMDS にアクセスするには、Azure Resource Manager または Azure ポータルから VM を作成し、以下のサンプルを使用します。その他の例については、「Azure Instance Metadata Samples (Azure Instance Metadata のサンプル)」を参照してください。

インスタンスのすべてのメタデータを取得するサンプルコードを次に示します。特定のデータソースにアクセスするには、使用可能なすべての機能の概要について「エンドポイントカテゴリ」を参照してください。

Request

重要

この例では、プロキシをバイパスします。 IMDS に対してクエリを実行する場合は、プロキシをバイパスする必要があります。追加情報については、「プロキシ」を参照してください。

注意

IMDS 要求は VM のプライマリ NIC とプライマリ IP を使用して送信し、かつ DHCP を有効にする必要があります。

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance?api-version=2021-02-01" | ConvertTo-Json -Depth 64

-NoProxy には PowerShell V6 以上が必須です。 PowerShell の旧バージョンでの例が必要であれば、こちらのサンプルリポジトリを参照してください。

Bash

curl -s -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance?api-version=2021-02-01" | jq

jq ユーティリティは多くの場合に使用できますが、すべての場合に使用できるわけではありません。 jq ユーティリティが存在しない場合は、代わりに | python -m json.tool を使用します。

Response

注意

応答は JSON 文字列です。次の例の応答は、読みやすくするために整えられています。

Windows
Linux

JSON

{
    "compute": {
        "azEnvironment": "AZUREPUBLICCLOUD",
        "additionalCapabilities": {
            "hibernationEnabled": "true"
        },
        "hostGroup": {
          "id": "testHostGroupId"
        }, 
        "extendedLocation": {
            "type": "edgeZone",
            "name": "microsoftlosangeles"
        },
        "evictionPolicy": "",
        "isHostCompatibilityLayerVm": "true",
        "licenseType":  "Windows_Client",
        "location": "westus",
        "name": "examplevmname",
        "offer": "WindowsServer",
        "osProfile": {
            "adminUsername": "admin",
            "computerName": "examplevmname",
            "disablePasswordAuthentication": "true"
        },
        "osType": "Windows",
        "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
        "plan": {
            "name": "planName",
            "product": "planProduct",
            "publisher": "planPublisher"
        },
        "platformFaultDomain": "36",
        "platformSubFaultDomain": "",        
        "platformUpdateDomain": "42",
        "priority": "Regular",
        "publicKeys": [{
                "keyData": "ssh-rsa 0",
                "path": "/home/user/.ssh/authorized_keys0"
            },
            {
                "keyData": "ssh-rsa 1",
                "path": "/home/user/.ssh/authorized_keys1"
            }
        ],
        "publisher": "RDFE-Test-Microsoft-Windows-Server-Group",
        "resourceGroupName": "macikgo-test-may-23",
        "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
        "securityProfile": {
            "secureBootEnabled": "true",
            "virtualTpmEnabled": "false",
            "encryptionAtHost": "true",
            "securityType": "TrustedLaunch"
        },
        "sku": "2019-Datacenter",
        "storageProfile": {
            "dataDisks": [{
                "bytesPerSecondThrottle": "979202048",
                "caching": "None",
                "createOption": "Empty",
                "diskCapacityBytes": "274877906944",
                "diskSizeGB": "1024",
                "image": {
                  "uri": ""
                },
                "isSharedDisk": "false",
                "isUltraDisk": "true",
                "lun": "0",
                "managedDisk": {
                  "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampledatadiskname",
                  "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampledatadiskname",
                "opsPerSecondThrottle": "65280",
                "vhd": {
                  "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            }],
            "imageReference": {
                "id": "",
                "offer": "WindowsServer",
                "publisher": "MicrosoftWindowsServer",
                "sku": "2019-Datacenter",
                "version": "latest",
                "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
                "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
                "exactVersion": "1.1686127202.30113"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "createOption": "FromImage",
                "diskSizeGB": "30",
                "diffDiskSettings": {
                    "option": "Local"
                },
                "encryptionSettings": {
                  "enabled": "false",
                  "diskEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  },
                  "keyEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  }
                },
                "image": {
                    "uri": ""
                },
                "managedDisk": {
                    "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                    "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampleosdiskname",
                "osType": "Windows",
                "vhd": {
                    "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            },
            "resourceDisk": {
                "size": "4096"
            }
        },
        "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "tags": "baz:bash;foo:bar",
        "userData": "Zm9vYmFy",
        "version": "15.05.22",
        "virtualMachineScaleSet": {
            "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
        },
        "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
        "vmScaleSetName": "crpteste9vflji9",
        "vmSize": "Standard_A3",
        "zone": ""
    },
    "network": {
        "interface": [{
            "ipv4": {
               "ipAddress": [{
                    "privateIpAddress": "10.144.133.132",
                    "publicIpAddress": ""
                }],
                "subnet": [{
                    "address": "10.144.133.128",
                    "prefix": "26"
                }]
            },
            "ipv6": {
                "ipAddress": [
                 ]
            },
            "macAddress": "0011AAFFBB22"
        }]
    }
}

JSON

{
    "compute": {
        "azEnvironment": "AZUREPUBLICCLOUD",
        "additionalCapabilities": {
            "hibernationEnabled": "true"
        },
        "hostGroup": {
          "id": "testHostGroupId"
        }, 
        "extendedLocation": {
            "type": "edgeZone",
            "name": "microsoftlosangeles"
        },
        "evictionPolicy": "",
        "isHostCompatibilityLayerVm": "true",
        "licenseType":  "",
        "location": "westus",
        "name": "examplevmname",
        "offer": "UbuntuServer",
        "osProfile": {
            "adminUsername": "admin",
            "computerName": "examplevmname",
            "disablePasswordAuthentication": "true"
        },
        "osType": "Linux",
        "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
        "plan": {
            "name": "planName",
            "product": "planProduct",
            "publisher": "planPublisher"
        },
        "platformFaultDomain": "36",
        "platformSubFaultDomain": "",        
        "platformUpdateDomain": "42",
        "priority": "Regular",
        "publicKeys": [{
                "keyData": "ssh-rsa 0",
                "path": "/home/user/.ssh/authorized_keys0"
            },
            {
                "keyData": "ssh-rsa 1",
                "path": "/home/user/.ssh/authorized_keys1"
            }
        ],
        "publisher": "Canonical",
        "resourceGroupName": "macikgo-test-may-23",
        "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
        "securityProfile": {
            "secureBootEnabled": "true",
            "virtualTpmEnabled": "false",
            "encryptionAtHost": "true",
            "securityType": "TrustedLaunch"
        },
        "sku": "18.04-LTS",
        "storageProfile": {
            "dataDisks": [{
                "bytesPerSecondThrottle": "979202048",
                "caching": "None",
                "createOption": "Empty",
                "diskCapacityBytes": "274877906944",
                "diskSizeGB": "1024",
                "image": {
                  "uri": ""
                },
                "isSharedDisk": "false",
                "isUltraDisk": "true",
                "lun": "0",
                "managedDisk": {
                  "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampledatadiskname",
                  "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampledatadiskname",
                "opsPerSecondThrottle": "65280",
                "vhd": {
                  "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            }],
            "imageReference": {
                "id": "",
                "offer": "UbuntuServer",
                "publisher": "Canonical",
                "sku": "16.04.0-LTS",
                "version": "latest",
                "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
                "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
                "exactVersion": "1.1686127202.30113"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "createOption": "FromImage",
                "diskSizeGB": "30",
                "diffDiskSettings": {
                    "option": "Local"
                },
                "encryptionSettings": {
                  "enabled": "false",
                  "diskEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  },
                  "keyEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  }
                },
                "image": {
                    "uri": ""
                },
                "managedDisk": {
                    "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                    "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampleosdiskname",
                "osType": "Linux",
                "vhd": {
                    "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            },
            "resourceDisk": {
                "size": "4096"
            }
        },
        "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "tags": "baz:bash;foo:bar",
        "version": "15.05.22",
        "virtualMachineScaleSet": {
            "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
        },
        "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
        "vmScaleSetName": "crpteste9vflji9",
        "vmSize": "Standard_A3",
        "zone": ""
    },
    "network": {
        "interface": [{
            "ipv4": {
               "ipAddress": [{
                    "privateIpAddress": "10.144.133.132",
                    "publicIpAddress": ""
                }],
                "subnet": [{
                    "address": "10.144.133.128",
                    "prefix": "26"
                }]
            },
            "ipv6": {
                "ipAddress": [
                 ]
            },
            "macAddress": "0011AAFFBB22"
        }]
    }
}

セキュリティと認証

Instance Metadata Service には、実行中の仮想マシンインスタンス内からのみ、ルーティング不可能な IP アドレスでアクセスできます。 VM は、独自のメタデータ/機能だけと対話できます。 API は HTTP のみであり、ホストから出ることはありません。

要求が IMDS に確実に直接送信されるようにし、意図しない、または望ましくない要求のリダイレクトを防ぐには、要求を次のように処理する必要があります。

ヘッダー Metadata: true を含める
ヘッダー X-Forwarded-For を含めない

これらの要件が両方とも満たされていない要求は、サービスによって拒否されます。

重要

IMDS は、機密データ用のチャネルではありません。 API は認証されておらず、VM 上のすべてのプロセスに対してオープン状態になっています。このサービスを通じて公開される情報は、VM 内で実行されているすべてのアプリケーションに対する共有情報と見なす必要があります。

VM 上のすべてのプロセスで IMDS エンドポイントにアクセスする必要がない場合、アクセスを制限するようにローカルのファイアウォール規則を設定できます。たとえば、ある既知のシステムサービスだけがインスタンスメタデータサービスにアクセスする必要がある場合、IMDS エンドポイントでファイアウォール規則を設定し、特定のプロセスにのみアクセスを許可したり、残りのプロセスのアクセスを拒否したりできます。

プロキシ

IMDS をプロキシの背後で使用することは想定されておらず、サポートされていません。ほとんどの HTTP クライアントでは、要求に応じてプロキシを無効にするオプションが提供されています。この機能は、IMDS と通信するときに使用する必要があります。詳細については、クライアントのドキュメントを参照してください。

重要

お使いの環境でプロキシ構成がわからない場合でも、既定のクライアントプロキシ設定をオーバーライドする必要があります。プロキシ構成は自動的に検出され、このような構成をバイパスしないと、コンピューターの構成が将来変更された場合に侵害のリスクが生じます。

レート制限

一般に、IMDS への要求は、(VM ごとに) 1 秒あたり 5 つの要求に制限されます。このしきい値を超える要求は、429 の応答で拒否されます。マネージド ID カテゴリに対する要求は、1 秒あたり 20 件の要求、同時要求数は 5 件 (VM 単位) に制限されます。

HTTP 動詞

現在、次の HTTP 動詞がサポートされています。

動詞	説明
`GET`	要求されたリソースの取得

パラメーター

エンドポイントでは、必須パラメーターまたは省略可能なパラメーターがサポートされる場合があります。詳細については、「スキーマ」と、対象の特定のエンドポイントに関するドキュメントを参照してください。

クエリパラメーター

IMDS エンドポイントでは、HTTP クエリ文字列パラメーターがサポートされています。次に例を示します。

URL

http://169.254.169.254/metadata/instance/compute?api-version=2021-01-01&format=json

パラメーターを指定します。

名前	値
`api-version`	`2021-01-01`
`format`	`json`

クエリパラメーター名が重複している要求は拒否されます。

ルートパラメーター

より大きな JSON BLOB を返す一部のエンドポイントでは、応答のサブセットに絞り込むために、要求エンドポイントへのルートパラメーターの追加がサポートされています。

URL

http://169.254.169.254/metadata/<endpoint>/[<filter parameter>/...]?<query parameters>

パラメーターは、解析された表現を操作する場合に、JSON オブジェクトを処理するのに使用されるインデックスとキーに対応します。

たとえば、/metadata/instance によって JSON オブジェクトが返されます。

JSON

{
    "compute": { ... },
    "network": {
        "interface": [
            {
                "ipv4": {
                   "ipAddress": [{
                        "privateIpAddress": "10.144.133.132",
                        "publicIpAddress": ""
                    }],
                    "subnet": [{
                        "address": "10.144.133.128",
                        "prefix": "26"
                    }]
                },
                "ipv6": {
                    "ipAddress": [
                     ]
                },
                "macAddress": "0011AAFFBB22"
            },
            ...
        ]
    }
}

応答をフィルター処理して compute プロパティのみに絞り込む場合は、次の要求を送信します。

URL

http://169.254.169.254/metadata/instance/compute?api-version=<version>

同様に、入れ子になったプロパティまたは特定の配列要素に絞り込む場合は、次のようにさらにキーを追加します。

URL

http://169.254.169.254/metadata/instance/network/interface/0?api-version=<version>

これにより、Network.interface プロパティの最初の要素に絞り込まれ、次の内容が返されます。

JSON

{
    "ipv4": {
       "ipAddress": [{
            "privateIpAddress": "10.144.133.132",
            "publicIpAddress": ""
        }],
        "subnet": [{
            "address": "10.144.133.128",
            "prefix": "26"
        }]
    },
    "ipv6": {
        "ipAddress": [
         ]
    },
    "macAddress": "0011AAFFBB22"
}

注意

リーフノードに絞り込む場合、format=json は機能しません。これらのクエリでは、既定の形式は json なので、format=text を明示的に指定する必要があります。

スキーマ

データ形式

既定では、IMDS によって JSON 形式 (Content-Type: application/json) でデータが返されます。ただし、応答のフィルター処理をサポートするエンドポイント (「ルートパラメーター」を参照) では、text 形式もサポートされています。

既定以外の応答形式にアクセスするには、要求のクエリ文字列パラメーターとして要求の形式を指定します。次に例を示します。

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance?api-version=2017-08-01&format=text"

Bash

curl -s -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance?api-version=2017-08-01&format=text"

JSON 応答では、すべてのプリミティブは string 型になり、欠損値または対象外の値は常に含まれますが、空の文字列に設定されます。

バージョン管理

IMDS はバージョン管理されており、HTTP 要求での API バージョンの指定は必須です。この要件の唯一の例外はバージョンエンドポイントであり、使用可能な API バージョンを動的に取得するために使用できます。

新しいバージョンが追加されても、特定のデータ形式への依存関係がスクリプトにある場合、互換性を確保するために古いバージョンにもアクセスできます。

バージョンを指定しない場合、エラーが表示され、サポートされている最新バージョンの一覧が示されます。

JSON

{
    "error": "Bad request. api-version was not specified in the request. For more information refer to aka.ms/azureimds",
    "newest-versions": [
        "2020-10-01",
        "2020-09-01",
        "2020-07-15"
    ]
}

サポートされる API バージョン

注意

バージョン 2023-11-15 はまだロールアウトの途中の段階です。一部のリージョンでは使用できない場合があります。

2023-11-15
2023-07-01
2021-12-13
2021-11-15
2021-11-01
2021-10-01
2021-08-01
2021-05-01
2021-03-01
2021-02-01
2021-01-01
2020-12-01
2020-10-01
2020-09-01
2020-07-15
2020-06-01
2019-11-01
2019-08-15
2019-08-01
2019-06-04
2019-06-01
2019-04-30
2019-03-11
2019-02-01
2018-10-01
2018-04-02
2018-02-01
2017-12-01
2017-10-01
2017-08-01
2017-04-02
2017-03-01

Swagger

IMDS の完全な Swagger 定義は、 https://github.com/Azure/azure-rest-api-specs/blob/main/specification/imds/data-plane/readme.md で入手できます。

リージョン別の提供状況

このサービスは、すべての Azure クラウドで一般提供されています。

ルートエンドポイント

ルートエンドポイントは http://169.254.169.254/metadata です。

エンドポイントカテゴリ

IMDS API には、さまざまなデータソースを表す複数のエンドポイントカテゴリが含まれており、それぞれに 1 つ以上のエンドポイントが含まれています。詳細については、各カテゴリを参照してください。

カテゴリルート	説明	導入されたバージョン
`/metadata/attested`	「構成証明済みデータ」をご覧ください	2018-10-01
`/metadata/identity`	IMDS 経由でのマネージド ID に関するページを参照	2018-02-01
`/metadata/instance`	「インスタンスメタデータ」を参照	2017-04-02
`/metadata/loadbalancer`	「IMDS を使用した Load Balancer メタデータの取得」を参照	2020-10-01
`/metadata/scheduledevents`	IMDS 経由のスケジュールされたイベントに関するページを参照	2017-08-01
`/metadata/versions`	「バージョン」を参照	該当なし

Versions

API バージョンの一覧表示

サポートされている API バージョンのセットを返します。

GET /metadata/versions

パラメーター

なし (このエンドポイントはバージョン管理されていません)。

Response

JSON

{
  "apiVersions": [
    "2017-03-01",
    "2017-04-02",
    ...
  ]
}

インスタンスメタデータ

VM メタデータの取得

コンピューティング、ネットワーク、ストレージなど、VM インスタンスの重要なメタデータを公開します。

GET /metadata/instance

パラメーター

名前	必須/任意	内容
`api-version`	必須	要求を処理するために使用されるバージョン。
`format`	省略可能*	応答の形式 (`json` または `text`)。 *注:要求パラメーターを使用するときに必要になる場合があります。

このエンドポイントでは、ルートパラメーターを使用した応答フィルター処理がサポートされています。

JSON

{
    "compute": {
        "azEnvironment": "AZUREPUBLICCLOUD",
        "additionalCapabilities": {
            "hibernationEnabled": "true"
        },
        "hostGroup": {
          "id": "testHostGroupId"
        }, 
        "extendedLocation": {
            "type": "edgeZone",
            "name": "microsoftlosangeles"
        },
        "evictionPolicy": "",
        "isHostCompatibilityLayerVm": "true",
        "licenseType":  "Windows_Client",
        "location": "westus",
        "name": "examplevmname",
        "offer": "WindowsServer",
        "osProfile": {
            "adminUsername": "admin",
            "computerName": "examplevmname",
            "disablePasswordAuthentication": "true"
        },
        "osType": "Windows",
        "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
        "plan": {
            "name": "planName",
            "product": "planProduct",
            "publisher": "planPublisher"
        },
        "platformFaultDomain": "36",
        "platformSubFaultDomain": "",        
        "platformUpdateDomain": "42",
        "priority": "Regular",
        "publicKeys": [{
                "keyData": "ssh-rsa 0",
                "path": "/home/user/.ssh/authorized_keys0"
            },
            {
                "keyData": "ssh-rsa 1",
                "path": "/home/user/.ssh/authorized_keys1"
            }
        ],
        "publisher": "RDFE-Test-Microsoft-Windows-Server-Group",
        "resourceGroupName": "macikgo-test-may-23",
        "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
        "securityProfile": {
            "secureBootEnabled": "true",
            "virtualTpmEnabled": "false",
            "encryptionAtHost": "true",
            "securityType": "TrustedLaunch"
        },
        "sku": "2019-Datacenter",
        "storageProfile": {
            "dataDisks": [{
                "bytesPerSecondThrottle": "979202048",
                "caching": "None",
                "createOption": "Empty",
                "diskCapacityBytes": "274877906944",
                "diskSizeGB": "1024",
                "image": {
                  "uri": ""
                },
                "isSharedDisk": "false",
                "isUltraDisk": "true",
                "lun": "0",
                "managedDisk": {
                  "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampledatadiskname",
                  "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampledatadiskname",
                "opsPerSecondThrottle": "65280",
                "vhd": {
                  "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            }],
            "imageReference": {
                "id": "",
                "offer": "WindowsServer",
                "publisher": "MicrosoftWindowsServer",
                "sku": "2019-Datacenter",
                "version": "latest",
                "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
                "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
                "exactVersion": "1.1686127202.30113"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "createOption": "FromImage",
                "diskSizeGB": "30",
                "diffDiskSettings": {
                    "option": "Local"
                },
                "encryptionSettings": {
                  "enabled": "false",
                  "diskEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  },
                  "keyEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  }
                },
                "image": {
                    "uri": ""
                },
                "managedDisk": {
                    "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                    "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampleosdiskname",
                "osType": "Windows",
                "vhd": {
                    "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            },
            "resourceDisk": {
                "size": "4096"
            }
        },
        "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "tags": "baz:bash;foo:bar",
        "userData": "Zm9vYmFy",
        "version": "15.05.22",
        "virtualMachineScaleSet": {
            "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
        },
        "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
        "vmScaleSetName": "crpteste9vflji9",
        "vmSize": "Standard_A3",
        "zone": ""
    },
    "network": {
        "interface": [{
            "ipv4": {
               "ipAddress": [{
                    "privateIpAddress": "10.144.133.132",
                    "publicIpAddress": ""
                }],
                "subnet": [{
                    "address": "10.144.133.128",
                    "prefix": "26"
                }]
            },
            "ipv6": {
                "ipAddress": [
                 ]
            },
            "macAddress": "0011AAFFBB22"
        }]
    }
}

JSON

{
    "compute": {
        "azEnvironment": "AZUREPUBLICCLOUD",
        "additionalCapabilities": {
            "hibernationEnabled": "true"
        },
        "hostGroup": {
          "id": "testHostGroupId"
        }, 
        "extendedLocation": {
            "type": "edgeZone",
            "name": "microsoftlosangeles"
        },
        "evictionPolicy": "",
        "isHostCompatibilityLayerVm": "true",
        "licenseType":  "",
        "location": "westus",
        "name": "examplevmname",
        "offer": "UbuntuServer",
        "osProfile": {
            "adminUsername": "admin",
            "computerName": "examplevmname",
            "disablePasswordAuthentication": "true"
        },
        "osType": "Linux",
        "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
        "plan": {
            "name": "planName",
            "product": "planProduct",
            "publisher": "planPublisher"
        },
        "platformFaultDomain": "36",
        "platformSubFaultDomain": "",        
        "platformUpdateDomain": "42",
        "priority": "Regular",
        "publicKeys": [{
                "keyData": "ssh-rsa 0",
                "path": "/home/user/.ssh/authorized_keys0"
            },
            {
                "keyData": "ssh-rsa 1",
                "path": "/home/user/.ssh/authorized_keys1"
            }
        ],
        "publisher": "Canonical",
        "resourceGroupName": "macikgo-test-may-23",
        "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
        "securityProfile": {
            "secureBootEnabled": "true",
            "virtualTpmEnabled": "false",
            "encryptionAtHost": "true",
            "securityType": "TrustedLaunch"
        },
        "sku": "18.04-LTS",
        "storageProfile": {
            "dataDisks": [{
                "bytesPerSecondThrottle": "979202048",
                "caching": "None",
                "createOption": "Empty",
                "diskCapacityBytes": "274877906944",
                "diskSizeGB": "1024",
                "image": {
                  "uri": ""
                },
                "isSharedDisk": "false",
                "isUltraDisk": "true",
                "lun": "0",
                "managedDisk": {
                  "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampledatadiskname",
                  "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampledatadiskname",
                "opsPerSecondThrottle": "65280",
                "vhd": {
                  "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            }],
            "imageReference": {
                "id": "",
                "offer": "UbuntuServer",
                "publisher": "Canonical",
                "sku": "16.04.0-LTS",
                "version": "latest",
                "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
                "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
                "exactVersion": "1.1686127202.30113"
            },
            "osDisk": {
                "caching": "ReadWrite",
                "createOption": "FromImage",
                "diskSizeGB": "30",
                "diffDiskSettings": {
                    "option": "Local"
                },
                "encryptionSettings": {
                  "enabled": "false",
                  "diskEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  },
                  "keyEncryptionKey": {
                    "sourceVault": {
                      "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                    },
                    "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                  }
                },
                "image": {
                    "uri": ""
                },
                "managedDisk": {
                    "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                    "storageAccountType": "StandardSSD_LRS"
                },
                "name": "exampleosdiskname",
                "osType": "Linux",
                "vhd": {
                    "uri": ""
                },
                "writeAcceleratorEnabled": "false"
            },
            "resourceDisk": {
                "size": "4096"
            }
        },
        "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "tags": "baz:bash;foo:bar",
        "version": "15.05.22",
        "virtualMachineScaleSet": {
            "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
        },
        "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
        "vmScaleSetName": "crpteste9vflji9",
        "vmSize": "Standard_A3",
        "zone": ""
    },
    "network": {
        "interface": [{
            "ipv4": {
               "ipAddress": [{
                    "privateIpAddress": "10.144.133.132",
                    "publicIpAddress": ""
                }],
                "subnet": [{
                    "address": "10.144.133.128",
                    "prefix": "26"
                }]
            },
            "ipv6": {
                "ipAddress": [
                 ]
            },
            "macAddress": "0011AAFFBB22"
        }]
    }
}

スキーマの内訳:

Compute

Data	説明	導入されたバージョン
`azEnvironment`	VM が実行されている Azure 環境	2018-10-01
`additionalCapabilities.hibernationEnabled`	VM で休止状態が有効になっているかどうかを識別します	2021-11-01
`customData`	IMDS では、この機能は非推奨とされ、無効になっています。 `userData` に置き換えられています。	2019-02-01
`evictionPolicy`	スポット VM を削除する方法を設定します。	2020-12-01
`extendedLocation.type`	VM の拡張された場所の種類。	2021-03-01
`extendedLocation.name`	VM の拡張された場所の名前	2021-03-01
`host.id`	VM のホストの名前。 VM にはホストまたは hostGroup がありますが、両方は存在しないことに注意してください。	2021-11-15
`hostGroup.id`	VM の hostGroup の名前。 VM にはホストまたは hostGroup がありますが、両方は存在しないことに注意してください。	2021-11-15
`isHostCompatibilityLayerVm`	ホストの互換性レイヤーで VM が実行されているかどうかを示します	2020-06-01
`licenseType`	Azure ハイブリッド特典のライセンスの種類。これは AHB 対応 VM でのみ利用できます。	2020-09-01
`location`	VM を実行中の Azure リージョン	2017-04-02
`name`	VM の名前	2017-04-02
`offer`	VM イメージのオファーの情報。Azure イメージギャラリーからデプロイされるイメージについてのみ存在します。	2017-04-02
`osProfile.adminUsername`	管理者アカウントの名前を指定します。	2020-07-15
`osProfile.computerName`	コンピューターの名前を指定します。	2020-07-15
`osProfile.disablePasswordAuthentication`	パスワード認証が無効かどうかを指定します。これは Linux VM でのみ利用できます。	2020-10-01
`osType`	Linux または Windows	2017-04-02
`physicalZone`	VM の物理ゾーン	2023-11-15
`placementGroupId`	スケールセットの配置グループ	2017-08-01
`plan`	VM が Azure Marketplace イメージである場合、プランにはその名前、製品、発行元が含まれています	2018-04-02
`platformUpdateDomain`	VM を実行中の更新ドメイン	2017-04-02
`platformFaultDomain`	VM を実行中の障害ドメイン	2017-04-02
`platformSubFaultDomain`	VM が実行されているサブ障害ドメイン (該当する場合)。	2021-10-01
`priority`	VM の優先度。詳細については、「スポット VM」を参照してください	2020-12-01
`provider`	VM のプロバイダー	2018-10-01
`publicKeys`	VM とパスに割り当てられた公開キーのコレクション	2018-04-02
`publisher`	VM イメージの発行元	2017-04-02
`resourceGroupName`	お使いの仮想マシンのリソースグループ	2017-08-01
`resourceId`	リソースの完全修飾 ID	2019-03-11
`sku`	VM イメージの特定の SKU	2017-04-02
`securityProfile.secureBootEnabled`	VM で UEFI セキュアブートが有効になっているかどうかを示します	2020-06-01
`securityProfile.virtualTpmEnabled`	VM で仮想トラステッドプラットフォームモジュール (TPM) が有効になっているかどうかを示します	2020-06-01
`securityProfile.encryptionAtHost`	VM でホストでの暗号化が有効になっているかどうかを識別します	2021-11-01
`securityProfile.securityType`	VM が信頼された VM または機密 VM であるかどうかを識別します	2021-12-13
`storageProfile`	下記の「ストレージプロファイル」を参照してください	2019-06-01
`subscriptionId`	仮想マシンの Azure サブスクリプション	2017-08-01
`tags`	お使いの仮想マシンのタグ	2017-08-01
`tagsList`	プログラムによる解析を簡単にするために JSON 配列として書式設定されたタグ	2019-06-04
`userData`	プロビジョニング中またはプロビジョニング後に使用するために VM が作成されたときに指定されたデータのセット (Base64 エンコード)	2021-01-01
`version`	VM イメージのバージョン	2017-04-02
`virtualMachineScaleSet.id`	仮想マシンが含まれているフレキシブルオーケストレーションで作成された仮想マシンスケールセットの ID。このフィールドは、均一オーケストレーションで作成された仮想マシンスケールセットには使用できません。	2021-03-01
`vmId`	VM の一意の識別子。参照されているブログは、SMBIOS が 2.6 未満である VM にのみ適しています。 SMBIOS が 2.6 以上である VM の場合、DMI からの UUID はリトルエンディアン形式で表示されるため、バイトを切り替える必要はありません。	2017-04-02
`vmScaleSetName`	お使いのスケールセットの仮想マシンスケールセット名	2017-12-01
`vmSize`	VM サイズ	2017-04-02
`zone`	仮想マシンの可用性ゾーン	2017-12-01

† このバージョンはまだ完全には利用できないため、一部のリージョンではサポートされていない場合があります。

ストレージプロファイル

VM のストレージプロファイルは、イメージ参照、OS ディスク、データディスクの 3 つのカテゴリに分けられ、さらにローカル一時ディスク用の追加オブジェクトがあります。

イメージ参照オブジェクトには、OS イメージに関する次の情報が含まれており、イメージは、プラットフォーム、マーケットプレース、コミュニティギャラリー、または直接共有ギャラリーのいずれかから取得できますが、両方から取得することはできないことにご注意ください。

データ	説明	導入されたバージョン
`id`	Resource ID	2019-06-01
`offer`	プラットフォームまたは marketplace イメージのオファー	2019-06-01
`publisher`	プラットフォームまたはマーケットプレースイメージのパブリッシャー	2019-06-01
`sku`	プラットフォームまたはマーケットプレースイメージの Sku	2019-06-01
`version`	イメージのバージョン	2019-06-01
`communityGalleryImageId`	コミュニティイメージのリソース ID。それ以外の場合は空	2023-07-01
`sharedGalleryImageId`	直接共有イメージのリソース ID。それ以外の場合は空	2023-07-01
`exactVersion`	コミュニティまたは直接共有イメージのバージョン	2023-07-01

OS ディスクオブジェクトには、VM によって使用される OS ディスクに関する次の情報が含まれています。

Data	説明
`caching`	キャッシュの要件
`createOption`	VM が作成された方法に関する情報
`diffDiskSettings`	一時ディスクの設定
`diskSizeGB`	ディスクのサイズ (GB)
`image`	ソースユーザーイメージの仮想ハードディスク
`managedDisk`	マネージドディスクのパラメーター
`name`	ディスク名
`vhd`	仮想ハードディスク
`writeAcceleratorEnabled`	ディスクで writeAccelerator が有効になっているかどうか

データディスクアレイには、VM に接続されているデータディスクの一覧が含まれています。各データディスクオブジェクトには、次の情報が含まれています。

Data	説明	導入されたバージョン
`bytesPerSecondThrottle`*	ディスクの読み取り/書き込みクォータ (バイト単位)	2021-05-01
`caching`	キャッシュの要件	2019-06-01
`createOption`	VM が作成された方法に関する情報	2019-06-01
`diffDiskSettings`	一時ディスクの設定	2019-06-01
`diskCapacityBytes`*	ディスクサイズ (バイト単位)	2021-05-01
`diskSizeGB`	ディスクのサイズ (GB)	2019-06-01
`encryptionSettings`	ディスクの暗号化の設定	2019-06-01
`image`	ソースユーザーイメージの仮想ハードディスク	2019-06-01
`isSharedDisk`*	ディスクがリソース間で共有されるか特定します	2021-05-01
`isUltraDisk`	データディスクが Ultra Disk かどうかを特定します	2021-05-01
`lun`	ディスクの論理ユニット番号	2019-06-01
`managedDisk`	マネージドディスクのパラメーター	2019-06-01
`name`	ディスク名	2019-06-01
`opsPerSecondThrottle`*	ディスクの読み取り/書き込みクォータ (IOPS)	2021-05-01
`osType`	ディスクに含まれている OS の種類	2019-06-01
`vhd`	仮想ハードディスク	2019-06-01
`writeAcceleratorEnabled`	ディスクで writeAccelerator が有効になっているかどうか	2019-06-01

*これらのフィールドは Ultra Disk の場合にのみ入力されます。Ultra Disk ではない場合、空の文字列になります。

暗号化設定 BLOB には、ディスクの暗号化方法に関する以下のデータが含まれています (暗号化されている場合)。

Data	説明	導入されたバージョン
`diskEncryptionKey.sourceVault.id`	ディスク暗号化キーの場所	2021-11-01
`diskEncryptionKey.secretUrl`	シークレットの場所	2021-11-01
`keyEncryptionKey.sourceVault.id`	キー暗号化キーの場所	2021-11-01
`keyEncryptionKey.keyUrl`	キーの場所	2021-11-01

リソースディスクオブジェクトには、VM に接続されているローカル一時ディスク (ある場合) のサイズ (KB 単位) が格納されます。 VM のローカル一時ディスクがない場合、この値は 0 です。

Data	説明	導入されたバージョン
`resourceDisk.size`	VM のローカル一時ディスクのサイズ (KB 単位)	2021-02-01

Network

Data	説明	導入されたバージョン
`ipv4.privateIpAddress`	VM のローカル IPv4 アドレス	2017-04-02
`ipv4.publicIpAddress`	VM のパブリック IPv4 アドレス	2017-04-02
`subnet.address`	VM のサブネットアドレス	2017-04-02
`subnet.prefix`	サブネットのプレフィックス (24 など)	2017-04-02
`ipv6.ipAddress`	VM のローカル IPv6 アドレス	2017-04-02
`macAddress`	VM の mac アドレス	2017-04-02

注意

ネットワーク呼び出しによって返される NIC は順序どおりになることは保証されていません。

ユーザーデータを取得する

新しい VM を作成するときに、VM のプロビジョニング中またはプロビジョニング後に使用されるデータのセットを指定し、IMDS を通じて取得することができます。エンドツーエンドのユーザーデータ体験はこちらをご覧ください。

ユーザーデータを設定するには、こちらのクイックスタートテンプレートを利用します。次のサンプルは、IMDS を介してこのデータを取得する方法を示しています。この機能はバージョン 2021-01-01 以上でリリースされます。

注意

セキュリティに関する通知: IMDS は VM 上のすべてのアプリケーションに対して開かれているため、機密データをユーザーデータに配置しないでください。

Windows
Linux

PowerShell

$userData = Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/userData?api-version=2021-01-01&format=text"
[System.Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($userData))

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/userData?api-version=2021-01-01&format=text" | base64 --decode

サンプル 1:Azure で動作している VM の追跡

サービスプロバイダーは、ソフトウェアを実行している VM の数を追跡する必要があったり、VM の一意性を追跡する必要のあるエージェントを使用していたりする場合があります。 VM の一意の ID を取得できるようにするには、Instance Metadata Service から vmId フィールドを使用します。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/vmId?api-version=2017-08-01&format=text"

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/vmId?api-version=2017-08-01&format=text"

Response

出力

5c08b38e-4d57-4c23-ac45-aca61037f084

サンプル 2:異なるデータレプリカの配置

特定のシナリオでは、異なるレプリカの配置が非常に重要です。たとえば、Orchestrator を介した HDFS レプリカの配置またはコンテナーの配置では、VM が実行されている platformFaultDomain と platformUpdateDomain を把握しておく必要がある場合があります。これらの決定を行うために、インスタンスの可用性ゾーンを使用することもできます。 IMDS を介して、このデータに直接クエリを実行できます。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/platformFaultDomain?api-version=2017-08-01&format=text"

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/platformFaultDomain?api-version=2017-08-01&format=text"

Response

出力

サンプル 3: VM タグを取得する

VM タグは、instance/compute/tags エンドポイントの下にあるインスタンス API に含まれています。論理的に分類するために Azure VM にタグが適用されている場合があります。次の要求を使用して、VM に割り当てられたタグを取得できます。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/tags?api-version=2017-08-01&format=text"

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/tags?api-version=2017-08-01&format=text"

Response

出力

Department:IT;ReferenceNumber:123456;TestStatus:Pending

tags フィールドは、セミコロンで区切られたタグを含む文字列です。この出力は、タグ自体でセミコロンが使用されている場合に問題になることがあります。プログラムでタグを抽出するようにパーサーが作成されている場合は、tagsList フィールドを使用する必要があります。 tagsList フィールドは区切り記号のない JSON 配列であるため、解析が容易になります。次の要求を使用して、VM に割り当てられた tagsList を取得できます。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/tagsList?api-version=2019-06-04" | ConvertTo-Json -Depth 64

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/tagsList?api-version=2019-06-04" | jq

Response

Windows
Linux

JSON

{
    "value":  [
                  {
                      "name":  "Department",
                      "value":  "IT"
                  },
                  {
                      "name":  "ReferenceNumber",
                      "value":  "123456"
                  },
                  {
                      "name":  "TestStatus",
                      "value":  "Pending"
                  }
              ],
    "Count":  3
}

JSON

[
  {
    "name": "Department",
    "value": "IT"
  },
  {
    "name": "ReferenceNumber",
    "value": "123456"
  },
  {
    "name": "TestStatus",
    "value": "Pending"
  }
]

サンプル 4: サポートケースの際の VM に関する詳細情報を取得する

サービスプロバイダーとして、VM の詳細情報を得る必要があるサポートコールを受けることがあります。顧客にコンピューティングメタデータの共有を依頼すると、サポート担当者が Azure 上の VM の種類を確認するための基本情報を得られる場合があります。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute?api-version=2020-09-01" | ConvertTo-Json -Depth 64

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute?api-version=2020-09-01"

Response

注意

応答は JSON 文字列です。次の例の応答は、読みやすくするために整えられています。

Windows
Linux

JSON

{
    "azEnvironment": "AZUREPUBLICCLOUD",
    "extendedLocation": {
      "type": "edgeZone",
      "name": "microsoftlosangeles"
    },
    "evictionPolicy": "",
    "additionalCapabilities": {
        "hibernationEnabled": "false"
    },
    "hostGroup": {
      "id": "testHostGroupId"
    },
    "isHostCompatibilityLayerVm": "true",
    "licenseType":  "Windows_Client",
    "location": "westus",
    "name": "examplevmname",
    "offer": "WindowsServer",
    "osProfile": {
        "adminUsername": "admin",
        "computerName": "examplevmname",
        "disablePasswordAuthentication": "true"
    },
    "osType": "Windows",
    "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
    "plan": {
        "name": "planName",
        "product": "planProduct",
        "publisher": "planPublisher"
    },
    "platformFaultDomain": "36",
    "platformUpdateDomain": "42",
    "priority": "Regular",
    "publicKeys": [{
            "keyData": "ssh-rsa 0",
            "path": "/home/user/.ssh/authorized_keys0"
        },
        {
            "keyData": "ssh-rsa 1",
            "path": "/home/user/.ssh/authorized_keys1"
        }
    ],
    "publisher": "RDFE-Test-Microsoft-Windows-Server-Group",
    "physicalZone": "useast-AZ01",
    "resourceGroupName": "macikgo-test-may-23",
    "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
    "securityProfile": {
        "secureBootEnabled": "true",
        "virtualTpmEnabled": "false",
        "encryptionAtHost": "true",
        "securityType": "TrustedLaunch"
    },
    "sku": "2019-Datacenter",
    "storageProfile": {
        "dataDisks": [{
            "bytesPerSecondThrottle": "979202048",
            "caching": "None",
            "createOption": "Empty",
            "diskCapacityBytes": "274877906944",
            "diskSizeGB": "1024",
            "image": {
              "uri": ""
            },
            "isSharedDisk": "false",
            "isUltraDisk": "true",
            "lun": "0",
            "managedDisk": {
              "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/MicrosoftCompute/disks/exampledatadiskname",
              "storageAccountType": "StandardSSD_LRS"
            },
            "name": "exampledatadiskname",
            "opsPerSecondThrottle": "65280",
            "vhd": {
              "uri": ""
            },
            "writeAcceleratorEnabled": "false"
        }],
        "imageReference": {
            "id": "",
            "offer": "WindowsServer",
            "publisher": "MicrosoftWindowsServer",
            "sku": "2019-Datacenter",
            "version": "latest",
            "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
            "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
            "exactVersion": "1.1686127202.30113"
        },
        "osDisk": {
            "caching": "ReadWrite",
            "createOption": "FromImage",
            "diskSizeGB": "30",
            "diffDiskSettings": {
                "option": "Local"
            },
            "encryptionSettings": {
              "enabled": "false",
              "diskEncryptionKey": {
                "sourceVault": {
                  "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                },
                "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
              },
              "keyEncryptionKey": {
                "sourceVault": {
                  "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                },
                "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
              }
            },
            "image": {
                "uri": ""
            },
            "managedDisk": {
                "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                "storageAccountType": "StandardSSD_LRS"
            },
            "name": "exampleosdiskname",
            "osType": "Windows",
            "vhd": {
                "uri": ""
            },
            "writeAcceleratorEnabled": "false"
        },
        "resourceDisk": {
            "size": "4096"
        }
    },
    "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
    "tags": "baz:bash;foo:bar",
    "version": "15.05.22",
    "virtualMachineScaleSet": {
      "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
    },
    "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
    "vmScaleSetName": "crpteste9vflji9",
    "vmSize": "Standard_A3",
    "zone": "3"
}

JSON

{
    "azEnvironment": "AZUREPUBLICCLOUD",
    "extendedLocation": {
      "type": "edgeZone",
      "name": "microsoftlosangeles"
    },
    "evictionPolicy": "",
    "additionalCapabilities": {
        "hibernationEnabled": "false"
    },
    "hostGroup": {
      "id": "testHostGroupId"
    },
    "isHostCompatibilityLayerVm": "true",
    "licenseType":  "Windows_Client",
    "location": "westus",
    "name": "examplevmname",
    "offer": "UbuntuServer",
    "osProfile": {
        "adminUsername": "admin",
        "computerName": "examplevmname",
        "disablePasswordAuthentication": "true"
    },
    "osType": "Linux",
    "physicalZone": "useast-AZ01",
    "placementGroupId": "f67c14ab-e92c-408c-ae2d-da15866ec79a",
    "plan": {
        "name": "planName",
        "product": "planProduct",
        "publisher": "planPublisher"
    },
    "platformFaultDomain": "36",
    "platformUpdateDomain": "42",
    "Priority": "Regular",
    "publicKeys": [{
            "keyData": "ssh-rsa 0",
            "path": "/home/user/.ssh/authorized_keys0"
        },
        {
            "keyData": "ssh-rsa 1",
            "path": "/home/user/.ssh/authorized_keys1"
        }
    ],
    "publisher": "Canonical",
    "resourceGroupName": "macikgo-test-may-23",
    "resourceId": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/virtualMachines/examplevmname",
    "securityProfile": {
        "secureBootEnabled": "true",
        "virtualTpmEnabled": "false",
        "encryptionAtHost": "true",
        "securityType": "TrustedLaunch"
    },
    "sku": "18.04-LTS",
    "storageProfile": {
        "dataDisks": [{
            "bytesPerSecondThrottle": "979202048",
            "caching": "None",
            "createOption": "Empty",
            "diskCapacityBytes": "274877906944",
            "diskSizeGB": "1024",
            "image": {
              "uri": ""
            },
            "isSharedDisk": "false",
            "isUltraDisk": "true",
            "lun": "0",
            "managedDisk": {
              "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampledatadiskname",
              "storageAccountType": "StandardSSD_LRS"
            },
            "name": "exampledatadiskname",
            "opsPerSecondThrottle": "65280",
            "vhd": {
              "uri": ""
            },
            "writeAcceleratorEnabled": "false"
        }],
        "imageReference": {
            "id": "",
            "offer": "UbuntuServer",
            "publisher": "Canonical",
            "sku": "16.04.0-LTS",
            "version": "latest",
            "communityGalleryImageId": "/CommunityGalleries/testgallery/Images/1804Gen2/Versions/latest",
            "sharedGalleryImageId": "/SharedGalleries/1P/Images/gen2/Versions/latest",
            "exactVersion": "1.1686127202.30113"
        },
        "osDisk": {
            "caching": "ReadWrite",
            "createOption": "FromImage",
            "diskSizeGB": "30",
            "diffDiskSettings": {
                "option": "Local"
            },
            "encryptionSettings": {
              "enabled": "false",
              "diskEncryptionKey": {
                "sourceVault": {
                  "id": "/subscriptions/test-source-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                },
                "secretUrl": "https://test-disk.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
              },
              "keyEncryptionKey": {
                "sourceVault": {
                  "id": "/subscriptions/test-key-guid/resourceGroups/testrg/providers/Microsoft.KeyVault/vaults/test-kv"
                },
                "keyUrl": "https://test-key.vault.azure.net/secrets/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
              }
            },
            "image": {
                "uri": ""
            },
            "managedDisk": {
                "id": "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/macikgo-test-may-23/providers/Microsoft.Compute/disks/exampleosdiskname",
                "storageAccountType": "StandardSSD_LRS"
            },
            "name": "exampleosdiskname",
            "osType": "linux",
            "vhd": {
                "uri": ""
            },
            "writeAcceleratorEnabled": "false"
        },
        "resourceDisk": {
            "size": "4096"
        }
    },
    "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
    "tags": "baz:bash;foo:bar",
    "version": "15.05.22",
    "virtualMachineScaleSet": {
      "id": "/subscriptions/xxxxxxxx-xxxxx-xxx-xxx-xxxx/resourceGroups/resource-group-name/providers/Microsoft.Compute/virtualMachineScaleSets/virtual-machine-scale-set-name"
    },
    "vmId": "02aab8a4-74ef-476e-8182-f6d2ba4166a6",
    "vmScaleSetName": "crpteste9vflji9",
    "vmSize": "Standard_A3",
    "zone": "3"
}

サンプル 5: VM が実行されている Azure 環境を取得する

Azure には、Azure Government など多数のソブリンクラウドがあります。ランタイムの決定を行うために、Azure 環境が必要な場合があります。次の例では、この動作を実現する方法を示します。

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/compute/azEnvironment?api-version=2018-10-01&format=text"

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/compute/azEnvironment?api-version=2018-10-01&format=text"

Response

出力

AzurePublicCloud

クラウドと Azure 環境の値を次に示します。

クラウド	Azure 環境
一般公開されている全世界のすべての Azure リージョン	AzurePublicCloud
Azure Government	AzureUSGovernmentCloud
21Vianet によって運営される Microsoft Azure	AzureChinaCloud
Azure Germany	AzureGermanCloud

サンプル 6: ネットワーク情報を取得する

Request

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/network?api-version=2017-08-01" | ConvertTo-Json  -Depth 64

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/network?api-version=2017-08-01"

Response

JSON

{
  "interface": [
    {
      "ipv4": {
        "ipAddress": [
          {
            "privateIpAddress": "10.1.0.4",
            "publicIpAddress": "X.X.X.X"
          }
        ],
        "subnet": [
          {
            "address": "10.1.0.0",
            "prefix": "24"
          }
        ]
      },
      "ipv6": {
        "ipAddress": []
      },
      "macAddress": "000D3AF806EC"
    }
  ]
}

サンプル 7: パブリック IP アドレスを取得する

Windows
Linux

PowerShell

Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri "http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/publicIpAddress?api-version=2017-08-01&format=text"

Bash

curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/publicIpAddress?api-version=2017-08-01&format=text"

注意

Standard SKU パブリック IP アドレスの IMDS 情報を取得する場合の詳細については、ロードバランサーのメタデータ API に関する記事をレビューしてください。

構成証明済みデータ

構成証明済みデータの取得

IMDS は、提供されるデータが Azure から送信されることを保証するために役立ちます。 Microsoft によってこの情報の一部に署名が行われるため、Azure Marketplace のイメージが Azure で実行されているものであることを確認できます。

GET /metadata/attested/document

パラメーター

名前	必須/任意	内容
`api-version`	必須	要求を処理するために使用されるバージョン。
`nonce`	Optional	暗号化 nonce として機能する 10 桁の文字列。値が指定されていない場合、IMDS では現在の UTC タイムスタンプが使用されます。

Response

JSON

{
    "encoding":"pkcs7",
    "signature":"MIIEEgYJKoZIhvcNAQcCoIIEAzCCA/8CAQExDzANBgkqhkiG9w0BAQsFADCBugYJKoZIhvcNAQcBoIGsBIGpeyJub25jZSI6IjEyMzQ1NjY3NjYiLCJwbGFuIjp7Im5hbWUiOiIiLCJwcm9kdWN0IjoiIiwicHVibGlzaGVyIjoiIn0sInRpbWVTdGFtcCI6eyJjcmVhdGVkT24iOiIxMS8yMC8xOCAyMjowNzozOSAtMDAwMCIsImV4cGlyZXNPbiI6IjExLzIwLzE4IDIyOjA4OjI0IC0wMDAwIn0sInZtSWQiOiIifaCCAj8wggI7MIIBpKADAgECAhBnxW5Kh8dslEBA0E2mIBJ0MA0GCSqGSIb3DQEBBAUAMCsxKTAnBgNVBAMTIHRlc3RzdWJkb21haW4ubWV0YWRhdGEuYXp1cmUuY29tMB4XDTE4MTEyMDIxNTc1N1oXDTE4MTIyMDIxNTc1NlowKzEpMCcGA1UEAxMgdGVzdHN1YmRvbWFpbi5tZXRhZGF0YS5henVyZS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAML/tBo86ENWPzmXZ0kPkX5dY5QZ150mA8lommszE71x2sCLonzv4/UWk4H+jMMWRRwIea2CuQ5RhdWAHvKq6if4okKNt66fxm+YTVz9z0CTfCLmLT+nsdfOAsG1xZppEapC0Cd9vD6NCKyE8aYI1pliaeOnFjG0WvMY04uWz2MdAgMBAAGjYDBeMFwGA1UdAQRVMFOAENnYkHLa04Ut4Mpt7TkJFfyhLTArMSkwJwYDVQQDEyB0ZXN0c3ViZG9tYWluLm1ldGFkYXRhLmF6dXJlLmNvbYIQZ8VuSofHbJRAQNBNpiASdDANBgkqhkiG9w0BAQQFAAOBgQCLSM6aX5Bs1KHCJp4VQtxZPzXF71rVKCocHy3N9PTJQ9Fpnd+bYw2vSpQHg/AiG82WuDFpPReJvr7Pa938mZqW9HUOGjQKK2FYDTg6fXD8pkPdyghlX5boGWAMMrf7bFkup+lsT+n2tRw2wbNknO1tQ0wICtqy2VqzWwLi45RBwTGB6DCB5QIBATA/MCsxKTAnBgNVBAMTIHRlc3RzdWJkb21haW4ubWV0YWRhdGEuYXp1cmUuY29tAhBnxW5Kh8dslEBA0E2mIBJ0MA0GCSqGSIb3DQEBCwUAMA0GCSqGSIb3DQEBAQUABIGAld1BM/yYIqqv8SDE4kjQo3Ul/IKAVR8ETKcve5BAdGSNkTUooUGVniTXeuvDj5NkmazOaKZp9fEtByqqPOyw/nlXaZgOO44HDGiPUJ90xVYmfeK6p9RpJBu6kiKhnnYTelUk5u75phe5ZbMZfBhuPhXmYAdjc7Nmw97nx8NnprQ="
}

signature BLOB は、ドキュメントの pkcs7 で署名されたバージョンです。特定の VM 固有の詳細と共に署名に使用される証明書が含まれています。

Azure Resource Manager を使用して作成された VM の場合、ドキュメントには、ドキュメントの作成と有効期限のための vmId、sku、nonce、subscriptionId、timeStamp とイメージに関するプラン情報が含まれています。プラン情報は Azure Marketplace のイメージにのみ設定されます。

クラシックデプロイモデルを使用して作成された VM の場合、設定されることが保証されているのは vmId と subscriptionId のみです。応答から証明書を抽出し、応答が有効で Azure から送られたものであることを確認するために使用できます。

デコードされたドキュメントには、次のフィールドが含まれています。

Data	説明	導入されたバージョン
`licenseType`	Azure ハイブリッド特典のライセンスの種類。これは AHB 対応 VM でのみ利用できます。	2020-09-01
`nonce`	必要に応じて、要求で指定できる文字列。 `nonce` が指定されていない場合は、現在の協定世界時のタイムスタンプが使用されます。	2018-10-01
`plan`	Azure Marketplace イメージプラン。プラン ID (名前)、製品イメージまたはオファー (製品)、およびパブリッシャー ID (パブリッシャー) が含まれます。	2018-10-01
`timestamp.createdOn`	署名されたドキュメントが作成されたときの UTC タイムスタンプ	2018-20-01
`timestamp.expiresOn`	署名されたドキュメントの有効期限が切れるときの UTC タイムスタンプ	2018-10-01
`vmId`	VM の一意の識別子	2018-10-01
`subscriptionId`	仮想マシンの Azure サブスクリプション	2019-04-30
`sku`	VM イメージの特定の SKU (Instance Metadata エンドポイント [`/metadata/instance`] の `compute/sku` プロパティに対応)	2019-11-01

注意

従来の (Azure Resource Manager 以外の) VM の場合は、vmId の設定のみが保証されます。

ドキュメントのサンプル:

JSON

{
   "nonce":"20201130-211924",
   "plan":{
      "name":"planName",
      "product":"planProduct",
      "publisher":"planPublisher"
   },
   "sku":"Windows-Server-2012-R2-Datacenter",
   "subscriptionId":"8d10da13-8125-4ba9-a717-bf7490507b3d",
   "timeStamp":{
      "createdOn":"11/30/20 21:19:19 -0000",
      "expiresOn":"11/30/20 21:19:24 -0000"
   },
   "vmId":"02aab8a4-74ef-476e-8182-f6d2ba4166a6"
}

署名の検証ガイダンス

署名を検証するときは、署名が Azure の証明書を使用して作成されていることを確認する必要があります。これは、証明書サブジェクトの別名 (SAN) を検証することによって行います。

SAN DNS Name=eastus.metadata.azure.com, DNS Name=metadata.azure.com の例

注意

パブリッククラウドと各ソブリンクラウドのドメインは異なります。

クラウド	SAN のドメイン
一般公開されている全世界のすべての Azure リージョン	*.metadata.azure.com
Azure Government	*.metadata.azure.us
21Vianet によって運営される Azure	*.metadata.azure.cn
Azure Germany	*.metadata.microsoftazure.de

注意

証明書は、ドメインと完全には一致しない場合があります。このため、認定の検証では、サブドメインを受け入れる必要があります (たとえば、パブリッククラウドの一般提供リージョンでは、*.metadata.azure.com を受け入れます)。

中間証明書では証明書のピン留めをお勧めしていません。詳細なガイダンスについては、証明書のピン留め - 証明書のピン留めと Azure サービスに関する記事を参照してください。 Azure Instance Metadata Service では、証明機関の今後の変更に関する通知が行われないことに注意してください。代わりに、今後のすべての更新については、一元的にまとめた記事「Azure 証明機関の詳細」を参照してください。

サンプル 1:VM が Azure で実行されていることの検証

Azure Marketplace のベンダーは、自分たちのソフトウェアが Azure でのみ実行されるようにライセンスされていることを確認することを望みます。だれかが VHD をオンプレミスの環境にコピーする場合、ベンダーはそれを検出できる必要があります。これらのベンダーは、IMDS を介して、応答が Azure のみからであることを保証する署名付きデータを取得できます。

注意

このサンプルを実行するには、jq ユーティリティがインストールされている必要があります。

検証

Windows
Linux

PowerShell

# Get the signature
$attestedDoc = Invoke-RestMethod -Headers @{"Metadata"="true"} -Method GET -NoProxy -Uri http://169.254.169.254/metadata/attested/document?api-version=2020-09-01
# Decode the signature
$signature = [System.Convert]::FromBase64String($attestedDoc.signature)

シグネチャが Microsoft Azure からのものであることを確認し、証明書チェーンにエラーがないか検査します。

PowerShell

# Get certificate chain
$cert = [System.Security.Cryptography.X509Certificates.X509Certificate2]($signature)
$chain = New-Object -TypeName System.Security.Cryptography.X509Certificates.X509Chain
$chain.Build($cert)
# Print the Subject of each certificate in the chain
foreach($element in $chain.ChainElements)
{
    Write-Host $element.Certificate.Subject
}

# Get the content of the signed document
Add-Type -AssemblyName System.Security
$signedCms = New-Object -TypeName System.Security.Cryptography.Pkcs.SignedCms
$signedCms.Decode($signature);
$content = [System.Text.Encoding]::UTF8.GetString($signedCms.ContentInfo.Content)
Write-Host "Attested data: " $content
$json = $content | ConvertFrom-Json
# Do additional validation here

Bash

# Get the signature
curl --silent -H Metadata:True --noproxy "*" "http://169.254.169.254/metadata/attested/document?api-version=2020-09-01" | jq -r '.["signature"]' > signature
# Decode the signature
base64 -d signature > decodedsignature
# Get PKCS7 format
openssl pkcs7 -in decodedsignature -inform DER -out sign.pk7
# Get Public key out of pkc7
openssl pkcs7 -in decodedsignature -inform DER  -print_certs -out signer.pem
# Get the intermediate certificate
curl -s -o intermediate.cer "$(openssl x509 -in signer.pem -text -noout | grep " CA Issuers -" | awk -FURI: '{print $2}')"
openssl x509 -inform der -in intermediate.cer -out intermediate.pem
# Verify the contents
openssl smime -verify -in sign.pk7 -inform pem -noverify

結果

JSON

Verification successful
{
  "nonce": "20181128-001617",
  "plan":
    {
      "name": "",
      "product": "",
      "publisher": ""
    },
  "timeStamp":
    {
      "createdOn": "11/28/18 00:16:17 -0000",
      "expiresOn": "11/28/18 06:16:17 -0000"
    },
  "vmId": "d3e0e374-fda6-4649-bbc9-7f20dc379f34",
  "licenseType": "Windows_Client",
  "subscriptionId": "xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "sku": "RS3-Pro"
}

署名が Microsoft Azure からのものであることを確認し、証明書チェーンにエラーがないか確認します。

Bash

# Verify the subject name for the main certificate
openssl x509 -noout -subject -in signer.pem
# Verify the issuer for the main certificate
openssl x509 -noout -issuer -in signer.pem
#Validate the subject name for intermediate certificate
openssl x509 -noout -subject -in intermediate.pem
# Verify the issuer for the intermediate certificate
openssl x509 -noout -issuer -in intermediate.pem
# Verify the certificate chain, for Microsoft Azure operated by 21Vianet the intermediate certificate will be from DigiCert Global Root CA
openssl verify -verbose -CAfile /etc/ssl/certs/DigiCert_Global_Root.pem -untrusted intermediate.pem signer.pem

最初の要求で nonce パラメーターを指定した場合、署名されたドキュメントの nonce を比較できます。

マネージド ID

システムによって割り当てられたマネージド ID は、VM 上で有効にすることができます。 1 つ以上のユーザー割り当てのマネージド ID を VM に割り当てることもできます。その後、IMDS からマネージド ID のトークンを要求できます。これらのトークンは、Azure Key Vault などの他の Azure サービスで認証するために使用します。

この機能を有効にするための詳細な手順については、アクセストークンの取得に関するページを参照してください。

Load Balancer メタデータ

仮想マシンまたは仮想マシンセットのインスタンスを Azure Standard Load Balancer の背後に配置する場合は、IMDS を使用して、ロードバランサーとインスタンスに関連するメタデータを取得できます。詳細については、ロードバランサー情報の取得に関する記事を参照してください。

スケジュールされたイベント

IMDS を使用すると、スケジュールされたイベントの状態を取得できます。その後、ユーザーは、これらのイベントに対して実行する一連のアクションを指定できます。詳細については、Linux のスケジュールされたイベントまたは Windows のスケジュールされたイベントに関する記事を参照してください。

さまざまな言語のサンプルコード

次の表に、VM 内で各種の言語を使用して IMDS を呼び出す例を示します。

Language	例
Bash	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.sh
C#	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.cs
Go	https://github.com/Microsoft/azureimds/blob/master/imdssample.go
Java	https://github.com/Microsoft/azureimds/blob/master/imdssample.java
NodeJS	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.js
Perl	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.pl
PowerShell	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.ps1
Puppet	https://github.com/keirans/azuremetadata
Python	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.py
Ruby	https://github.com/Microsoft/azureimds/blob/master/IMDSSample.rb

エラーとデバッグ

見つからないデータ要素または形式に誤りがある要求が存在する場合、Instance Metadata Service は標準 HTTP エラーを返します。次に例を示します。

HTTP 状態コード	理由
`200 OK`	要求は成功しました。
`400 Bad Request`	リーフノードのクエリ時に `Metadata: true` ヘッダーがないか、パラメーター `format=json` がありません
`404 Not Found`	要求された要素は存在しません
`405 Method Not Allowed`	このエンドポイントでは、HTTP メソッド (Verb) はサポートされていません。
`410 Gone`	しばらくしてから再試行してください (最長 70 秒)
`429 Too Many Requests`	API の転送率の制限を超えました
`500 Service Error`	しばらくしてからやり直してください

よく寄せられる質問

エラー 400 Bad Request, Required metadata header not specified を取得しています。これはどういう意味でしょうか。
- IMDS では、要求に Metadata: true ヘッダーを渡す必要があります。このヘッダーを REST 呼び出しに渡すと、IMDS へのアクセスが許可されます。
使用している VM に関するコンピューティング情報を取得できないのはなぜですか。
- 現在、IMDS では、Azure Resource Manager で作成されたインスタンスのみがサポートされます。
しばらく前に Azure Resource Manager で VM を作成しました。コンピューティングメタデータ情報が表示されないのはなぜですか。
- 2016 年 9 月以降に VM を作成した場合は、タグを追加して、コンピューティングメタデータの表示を開始してください。 2016 年 9 月より前に VM を作成した場合は、VM インスタンスに対して拡張機能またはデータディスクを追加/削除して、メタデータを更新してください。
ユーザーデータはカスタムデータと同じですか?
- ユーザーデータには、カスタムデータと同様の機能が用意されているため、独自のメタデータを VM インスタンスに渡すことができます。違いは、ユーザーデータが IMDS を通じて取得され、VM インスタンスの有効期間全体にわたって永続的であることです。既存のカスタムデータ機能は、この記事で説明されているように機能し続けます。ただし、カスタムデータは、IMDS ではなくローカルシステムフォルダーからのみ取得できます。
新しいバージョンに入力されたすべてのデータが表示されないのはなぜですか。
- 2016 年 9 月以降に VM を作成した場合は、タグを追加して、コンピューティングメタデータの表示を開始してください。 2016 年 9 月より前に VM を作成した場合は、VM インスタンスに対して拡張機能またはデータディスクを追加/削除して、メタデータを更新してください。
エラー 500 Internal Server Error または 410 Resource Gone が発生するのはなぜですか。
- 要求を再試行してください。詳細については、「一時的な障害の処理」を参照してください。問題が解決しない場合は、VM の Azure portal でサポートの問題を作成してください。
これはスケールセットインスタンスで機能しますか。
- はい。IMDS はスケールセットインスタンスで使用できます。
スケールセットでタグを更新しましたが、(単一インスタンスの VM とは異なり) インスタンスにタグが表示されません。操作方法に何か間違いがありますか。
- 現時点では、スケールセットのタグは、再起動、再イメージ化、またはインスタンスに対するディスクの変更の際に VM に対してのみ表示されます。
VM の SKU 情報が instance/compute の詳細に表示されないのはなぜですか。
- Azure Marketplace から作成されたカスタムイメージの場合、Azure プラットフォームではカスタムイメージの SKU 情報と、カスタムイメージから作成された VM の詳細は保持されません。これは仕様であるため、VM instance/compute 詳細には表示されません。
サービスの呼び出しの要求がタイムアウト (または接続に失敗) するのはなぜですか。
- メタデータの呼び出しは、VM のプライマリネットワークカードに割り当てられたプライマリ IP アドレスから行う必要があります。さらに、ルートを変更した場合、VM のローカルルーティングテーブルにアドレスが 169.254.169.254/32 のルートが存在する必要があります。
  - Windows
  - Linux
  1. ローカルルーティングテーブルをダンプし、IMDS エントリを探します。次に例を示します。
    
    コンソール
    route print
    
    出力
    IPv4 Route Table =========================================================================== Active Routes: Network Destination Netmask Gateway Interface Metric 0.0.0.0 0.0.0.0 172.16.69.1 172.16.69.7 10 127.0.0.0 255.0.0.0 On-link 127.0.0.1 331 127.0.0.1 255.255.255.255 On-link 127.0.0.1 331 127.255.255.255 255.255.255.255 On-link 127.0.0.1 331 168.63.129.16 255.255.255.255 172.16.69.1 172.16.69.7 11 169.254.169.254 255.255.255.255 172.16.69.1 172.16.69.7 11 ... (continues) ...
  2. 169.254.169.254 のルートが存在することを確認し、対応するネットワークインターフェイス (172.16.69.7 など) をメモします。
  3. インターフェイス構成をダンプし、ルーティングテーブルで参照されているものに対応するインターフェイスを見つけ、MAC (物理) アドレスをメモします。
    
    コンソール
    ipconfig /all
    
    出力
    ... (continues) ... Ethernet adapter Ethernet: Connection-specific DNS Suffix . : xic3mnxjiefupcwr1mcs1rjiqa.cx.internal.cloudapp.net Description . . . . . . . . . . . : Microsoft Hyper-V Network Adapter Physical Address. . . . . . . . . : 00-0D-3A-E5-1C-C0 DHCP Enabled. . . . . . . . . . . : Yes Autoconfiguration Enabled . . . . : Yes Link-local IPv6 Address . . . . . : fe80::3166:ce5a:2bd5:a6d1%3(Preferred) IPv4 Address. . . . . . . . . . . : 172.16.69.7(Preferred) Subnet Mask . . . . . . . . . . . : 255.255.255.0 ... (continues) ...
  4. インターフェイスが VM のプライマリ NIC とプライマリ IP に対応していることを確認します。 Azure portal でネットワーク構成を確認するか、Azure CLI を使用して調べることで、プライマリ NIC および IP を見つけることができます。プライベート IP (および CLI を使用している場合は MAC アドレス) をメモします。 PowerShell CLI の例を次に示します。
    
    Azure PowerShell
    $ResourceGroup = '<Resource_Group>' $VmName = '<VM_Name>' $NicNames = az vm nic list --resource-group $ResourceGroup --vm-name $VmName | ConvertFrom-Json | Foreach-Object { $_.id.Split('/')[-1] } foreach($NicName in $NicNames) { $Nic = az vm nic show --resource-group $ResourceGroup --vm-name $VmName --nic $NicName | ConvertFrom-Json Write-Host $NicName, $Nic.primary, $Nic.macAddress }
    
    出力
    wintest767 True 00-0D-3A-E5-1C-C0
  5. 一致しない場合は、プライマリ NIC および IP がターゲットになるようにルーティングテーブルを更新します。
  1. netstat -r などのコマンドを使用してローカルルーティングテーブルをダンプし、IMDS エントリを探します (例)。
    
    Bash
    netstat -r
    
    出力
    Kernel IP routing table Destination Gateway Genmask Flags MSS Window irtt Iface default _gateway 0.0.0.0 UG 0 0 0 eth0 168.63.129.16 _gateway 255.255.255.255 UGH 0 0 0 eth0 169.254.169.254 _gateway 255.255.255.255 UGH 0 0 0 eth0 172.16.69.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
  2. 169.254.169.254 のルートが存在することを確認し、対応するネットワークインターフェイス (eth0 など) をメモします。
  3. ルーティングテーブル内の対応するインターフェイスのインターフェイス構成をダンプします (構成ファイルの正確な名前は異なっている場合があることに注意してください)。
    
    Bash
    cat /etc/netplan/50-cloud-init.yaml
    
    出力
    network: ethernets: eth0: dhcp4: true dhcp4-overrides: route-metric: 100 dhcp6: false match: macaddress: 00:0d:3a:e4:c7:2e set-name: eth0 version: 2
  4. 動的 IP を使用している場合は、MAC アドレスをメモします。静的 IP を使用している場合は、リストされている IP アドレスや MAC アドレスをメモできます。
  5. インターフェイスが VM のプライマリ NIC とプライマリ IP に対応していることを確認します。 Azure portal でネットワーク構成を確認するか、Azure CLI を使用して調べることで、プライマリ NIC および IP を見つけることができます。プライベート IP (および CLI を使用している場合は MAC アドレス) をメモします。 PowerShell CLI の例を次に示します。
    
    Azure PowerShell
    $ResourceGroup = '<Resource_Group>' $VmName = '<VM_Name>' $NicNames = az vm nic list --resource-group $ResourceGroup --vm-name $VmName | ConvertFrom-Json | Foreach-Object { $_.id.Split('/')[-1] } foreach($NicName in $NicNames) { $Nic = az vm nic show --resource-group $ResourceGroup --vm-name $VmName --nic $NicName | ConvertFrom-Json Write-Host $NicName, $Nic.primary, $Nic.macAddress }
    
    出力
    ipexample606 True 00-0D-3A-E4-C7-2E
  6. 一致しない場合は、プライマリ NIC/IP がターゲットになるようにルーティングテーブルを更新します。

Windows Server でのフェールオーバークラスタリング

フェールオーバークラスタリングを使用して IMDS に対してクエリを実行する場合は、ルーティングテーブルにルートを追加する必要がある場合があります。その方法は次のとおりです。

管理者特権でコマンドプロンプトを開きます。
次のコマンドを実行し、IPv4 ルーティングテーブルのネットワーク宛先 (0.0.0.0) のインターフェイスのアドレスをメモします。

bat

route print

注意

次の出力例は、フェールオーバークラスターが有効になっている Windows Server VM からのものです。わかりやすくするために、出力には IPv4 ルートテーブルだけが含まれています。

出力

IPv4 Route Table
===========================================================================
Active Routes:
Network Destination        Netmask          Gateway       Interface  Metric
        0.0.0.0          0.0.0.0         10.0.1.1        10.0.1.10    266
        10.0.1.0  255.255.255.192         On-link         10.0.1.10    266
        10.0.1.10  255.255.255.255         On-link         10.0.1.10    266
        10.0.1.15  255.255.255.255         On-link         10.0.1.10    266
        10.0.1.63  255.255.255.255         On-link         10.0.1.10    266
        127.0.0.0        255.0.0.0         On-link         127.0.0.1    331
        127.0.0.1  255.255.255.255         On-link         127.0.0.1    331
127.255.255.255  255.255.255.255         On-link         127.0.0.1    331
    169.254.0.0      255.255.0.0         On-link     169.254.1.156    271
    169.254.1.156  255.255.255.255         On-link     169.254.1.156    271
169.254.255.255  255.255.255.255         On-link     169.254.1.156    271
        224.0.0.0        240.0.0.0         On-link         127.0.0.1    331
        224.0.0.0        240.0.0.0         On-link     169.254.1.156    271
255.255.255.255  255.255.255.255         On-link         127.0.0.1    331
255.255.255.255  255.255.255.255         On-link     169.254.1.156    271
255.255.255.255  255.255.255.255         On-link         10.0.1.10    266

次のコマンドを実行し、ネットワーク宛先 (0.0.0.0) のインターフェイスのアドレスを使用します。この例では 10.0.1.10 です。

bat

route add 169.254.169.254/32 10.0.1.10 metric 1 -p

サポート

複数回試行してもメタデータの応答を取得できない場合は、Azure portal でサポートの問題を作成できます。

製品フィードバック

製品のフィードバックとアイデアは、[Virtual Machines] > [Instance Metadata Service] にあるユーザーフィードバックチャネル (>) にお寄せください

次の方法で共有

Azure Instance Metadata Service

使用方法

Azure Instance Metadata Service にアクセスする

セキュリティと認証

プロキシ

レート制限

HTTP 動詞

パラメーター

クエリ パラメーター

ルート パラメーター

スキーマ

データ形式

バージョン管理

サポートされる API バージョン

Swagger

リージョン別の提供状況

ルート エンドポイント

エンドポイント カテゴリ

Versions

API バージョンの一覧表示

パラメーター

Response

インスタンス メタデータ

VM メタデータの取得

パラメーター

Response

ユーザー データを取得する

サンプル 1:Azure で動作している VM の追跡

サンプル 2:異なるデータ レプリカの配置

サンプル 3: VM タグを取得する

サンプル 4: サポート ケースの際の VM に関する詳細情報を取得する

サンプル 5: VM が実行されている Azure 環境を取得する

サンプル 6: ネットワーク情報を取得する

サンプル 7: パブリック IP アドレスを取得する

構成証明済みデータ

構成証明済みデータの取得

パラメーター

Response

署名の検証ガイダンス

サンプル 1:VM が Azure で実行されていることの検証

マネージド ID

Load Balancer メタデータ

スケジュールされたイベント

さまざまな言語のサンプル コード

エラーとデバッグ

よく寄せられる質問

サポート

製品フィードバック

次のステップ

フィードバック

その他のリソース

クエリパラメーター

ルートパラメーター

ルートエンドポイント

エンドポイントカテゴリ

インスタンスメタデータ

ユーザーデータを取得する

サンプル 2:異なるデータレプリカの配置

サンプル 4: サポートケースの際の VM に関する詳細情報を取得する

さまざまな言語のサンプルコード