Resource Graph を使用してご利用の Azure リソースを探索する

[アーティクル]
06/19/2024

Azure Resource Graph は、し、Azure リソースを迅速かつ大規模に探して検出するのに役立ちます。迅速に応答するよう設計されており、ご利用の環境のほか、Azure リソース上に存在するプロパティの詳細を確認する優れた手段となっています。

注意

Resource Graph テーブルに応じて、プロパティは Azure portal に表示されるように大文字と小文字が一致するか、小文字になります。たとえば、resourceContainers テーブルをクエリするときのリソースグループの名前はポータルと一致しますが、resources テーブルのリソースの resourceGroup プロパティは小文字になります。これは予期しない結果の原因になる可能性があり、クエリでは、大文字と小文字を区別しない比較演算子 (== の代わりに =~ など) を使い、tolower() 関数と結合してプロパティを小文字に変換することで対処できます。

仮想マシンの詳細を確認する

Azure の一般的なリソースは仮想マシンです。リソースの一種である仮想マシンは、クエリの対象になる多数のプロパティを備えています。各プロパティには、探しているリソースだけをフィルター処理して見つけるためのオプションがあります。

仮想マシンの確認

まずは、環境から 1 つの仮想マシンを取得し、返されるプロパティを確認する簡単なクエリを実行してみましょう。

Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| limit 1

az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | limit 1"

(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | limit 1").Data | ConvertTo-Json -Depth 100

Note

Azure PowerShell の Search-AzGraph コマンドレットは、既定で PSResourceGraphResponse を返します。出力を Azure CLI から返されるものと同じような表示にするため、Data プロパティに対して ConvertTo-Json コマンドレットが使われています。 Depth の既定値は 2 です。 100 に設定すると、返されたすべてのレベルが変換されます。

JSON 結果は次の例のように構成されます。

[
  {
    "id": "/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/ContosoVM1",
    "kind": "",
    "location": "westus2",
    "managedBy": "",
    "name": "ContosoVM1",
    "plan": {},
    "properties": {
      "hardwareProfile": {
        "vmSize": "Standard_B2s"
      },
      "networkProfile": {
        "networkInterfaces": [
          {
            "id": "/subscriptions/<subscriptionId>/MyResourceGroup/providers/Microsoft.Network/networkInterfaces/contosovm2222",
            "resourceGroup": "MyResourceGroup"
          }
        ]
      },
      "osProfile": {
        "adminUsername": "localAdmin",
        "computerName": "ContosoVM1",
        "secrets": [],
        "windowsConfiguration": {
          "enableAutomaticUpdates": true,
          "provisionVMAgent": true
        }
      },
      "provisioningState": "Succeeded",
      "storageProfile": {
        "dataDisks": [],
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-Datacenter",
          "version": "latest"
        },
        "osDisk": {
          "caching": "ReadWrite",
          "createOption": "FromImage",
          "diskSizeGB": 127,
          "managedDisk": {
            "id": "/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111",
            "resourceGroup": "MyResourceGroup",
            "storageAccountType": "Premium_LRS"
          },
          "name": "ContosoVM1_OsDisk_1_11111111111111111111111111111111",
          "osType": "Windows"
        }
      },
      "vmId": "11111111-1111-1111-1111-111111111111"
    },
    "resourceGroup": "MyResourceGroup",
    "sku": {},
    "subscriptionId": "<subscriptionId>",
    "tags": {},
    "type": "microsoft.compute/virtualmachines"
  }
]

プロパティによって、仮想マシンリソース自体に関する追加情報が指定されます。これらのプロパティには、オペレーティングシステム、ディスク、タグ、およびリソースグループとそのメンバーであるサブスクリプションが含まれます。

場所別の仮想マシン

仮想マシンリソースについて学習したことを利用し、location プロパティ使って、すべての仮想マシンを場所別にカウントしてみましょう。クエリを更新するため、制限を削除し、場所の値の数を集計します。

Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by location

az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by location"

(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by location").Data | ConvertTo-Json

JSON 結果は次の例のように構成されます。

[
  {
    "count_": 386,
    "location": "eastus"
  },
  {
    "count_": 215,
    "location": "southcentralus"
  },
  {
    "count_": 59,
    "location": "westus"
  }
]

これで、各 Azure リージョンにある仮想マシンの数を確認できました。

SKU 別の仮想マシン

仮想マシンの元のプロパティに戻って、SKU サイズが Standard_B2s であるすべての仮想マシンを見つけましょう。返された JSON では、値が properties.hardwareprofile.vmsize に格納されていることが示されています。このサイズと一致するすべての仮想マシン (VM) を見つけて、VM とリージョンの名前だけを返すように、クエリを更新します。

Resources
| where type =~ 'Microsoft.Compute/virtualMachines' and properties.hardwareProfile.vmSize == 'Standard_B2s'
| project name, resourceGroup

az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualMachines' and properties.hardwareProfile.vmSize == 'Standard_B2s' | project name, resourceGroup"

(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/virtualMachines' and properties.hardwareProfile.vmSize == 'Standard_B2s' | project name, resourceGroup").Data | ConvertTo-Json

プレミアムマネージドディスクに接続された仮想マシン

これらの Standard_B2s 仮想マシンにアタッチされている Premium マネージドディスクの詳細を得るため、これらのマネージドディスクのリソース ID を返すようにクエリを拡張します。

Resources
| where type =~ 'Microsoft.Compute/virtualmachines' and properties.hardwareProfile.vmSize == 'Standard_B2s'
| extend disk = properties.storageProfile.osDisk.managedDisk
| where disk.storageAccountType == 'Premium_LRS'
| project disk.id

az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualmachines' and properties.hardwareProfile.vmSize == 'Standard_B2s' | extend disk = properties.storageProfile.osDisk.managedDisk | where disk.storageAccountType == 'Premium_LRS' | project disk.id"

(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/virtualmachines' and properties.hardwareProfile.vmSize == 'Standard_B2s' | extend disk = properties.storageProfile.osDisk.managedDisk | where disk.storageAccountType == 'Premium_LRS' | project disk.id").Data | ConvertTo-Json

結果は、ディスク ID の一覧です。

マネージドディスクの確認

前のクエリからの最初のレコードで、最初の仮想マシンにアタッチされていたマネージドディスクに存在するプロパティを調べます。更新されたクエリでは、ディスク ID を使用し、種類を変更します。

前のクエリからの出力例を次に示します。

[
  {
    "disk_id": "/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111"
  }
]

Resources
| where type =~ 'Microsoft.Compute/disks' and id == '/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111'

クエリを実行する前に、type が Microsoft.Compute/disks であることがなぜわかるかを見てみましょう。完全な ID を見ると、文字列の一部が /providers/Microsoft.Compute/disks/ であることがわかります。この文字列の部分から、検索対象となる種類がわかります。別の方法としては、種類による制限を削除し、代わりに ID フィールドだけを使用して検索を行います。 ID は一意なので、1 つのレコードだけが返され、含まれる type プロパティによってその詳細情報が提供されます。

Note

この例を動作させるには、ID フィールドを、独自の環境の結果に置き換える必要があります。

az graph query -q "Resources | where type =~ 'Microsoft.Compute/disks' and id == '/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111'"

(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/disks' and id == '/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111'").Data | ConvertTo-Json

JSON 結果は次の例のように構成されます。

[
  {
    "id": "/subscriptions/<subscriptionId>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/disks/ContosoVM1_OsDisk_1_11111111111111111111111111111111",
    "kind": "",
    "location": "westus2",
    "managedBy": "",
    "name": "ContosoVM1_OsDisk_1_11111111111111111111111111111111",
    "plan": {},
    "properties": {
      "creationData": {
        "createOption": "Empty"
      },
      "diskSizeGB": 127,
      "diskState": "ActiveSAS",
      "provisioningState": "Succeeded",
      "timeCreated": "2018-09-14T12:17:32.2570000Z"
    },
    "resourceGroup": "MyResourceGroup",
    "sku": {
      "name": "Premium_LRS",
      "tier": "Premium"
    },
    "subscriptionId": "<subscriptionId>",
    "tags": {
      "environment": "prod"
    },
    "type": "microsoft.compute/disks"
  }
]

仮想マシンを探索してパブリック IP アドレスを確認する

この一連のクエリでは、最初に、仮想マシンに接続されているすべてのネットワークインターフェイスカード (NIC) リソースが検索されて格納されます。次に、NIC の一覧を使用して、パブリック IP アドレスである各 IP アドレスのリソースが検索され、それらの値が格納されます。最後に、パブリック IP アドレスの一覧が提供されます。

# Use Resource Graph to get all NICs and store in the 'nics.txt' file
az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | project nic = tostring(properties['networkProfile']['networkInterfaces'][0]['id']) | where isnotempty(nic) | distinct nic | limit 20" --output table | tail -n +3 > nics.txt

# Review the output of the query stored in 'nics.txt'
cat nics.txt

# Use Resource Graph to get all NICs and store in the $nics variable
$nics = (Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | project nic = tostring(properties['networkProfile']['networkInterfaces'][0]['id']) | where isnotempty(nic) | distinct nic | limit 20").Data

# Review the output of the query stored in the variable
$nics.nic

次のクエリでは、ファイル (Azure CLI) または変数 (Azure PowerShell) を使って、関連するネットワークインターフェイスカードリソースの詳細情報を取得します。これには、NIC にアタッチされているパブリック IP アドレスが含まれます。

# Use Resource Graph with the 'nics.txt' file to get all related public IP addresses and store in 'publicIp.txt' file
az graph query -q="Resources | where type =~ 'Microsoft.Network/networkInterfaces' | where id in ('$(awk -vORS="','" '{print $0}' nics.txt | sed 's/,$//')') | project publicIp = tostring(properties['ipConfigurations'][0]['properties']['publicIPAddress']['id']) | where isnotempty(publicIp) | distinct publicIp" --output table | tail -n +3 > ips.txt

# Review the output of the query stored in 'ips.txt'
cat ips.txt

# Use Resource Graph  with the $nics variable to get all related public IP addresses and store in $ips variable
$ips = (Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Network/networkInterfaces' | where id in ('$($nics.nic -join "','")') | project publicIp = tostring(properties['ipConfigurations'][0]['properties']['publicIPAddress']['id']) | where isnotempty(publicIp) | distinct publicIp").Data

# Review the output of the query stored in the variable
$ips.publicIp

最後に、ファイル (Azure CLI) または変数 (Azure PowerShell) に格納されているパブリック IP アドレスリソースの一覧を使用して、関連するオブジェクトから実際のパブリック IP アドレスを取得して表示します。

# Use Resource Graph with the 'ips.txt' file to get the IP address of the public IP address resources
az graph query -q="Resources | where type =~ 'Microsoft.Network/publicIPAddresses' | where id in ('$(awk -vORS="','" '{print $0}' ips.txt | sed 's/,$//')') | project ip = tostring(properties['ipAddress']) | where isnotempty(ip) | distinct ip" --output table

# Use Resource Graph with the $ips variable to get the IP address of the public IP address resources
(Search-AzGraph -Query "Resources | where type =~ 'Microsoft.Network/publicIPAddresses' | where id in ('$($ips.publicIp -join "','")') | project ip = tostring(properties['ipAddress']) | where isnotempty(ip) | distinct ip").Data | ConvertTo-Json

join 演算子を使って 1 つのクエリでこれらの手順を行う方法については、「仮想マシンとそのネットワークインターフェイスとパブリック IP を一覧表示する」のサンプルをご覧ください。

次のステップ

クエリ言語の詳細について学習します。
初歩的なクエリで使用されている言語を確認します。
高度なクエリで高度な使用方法を確認します。

次の方法で共有

Resource Graph を使用してご利用の Azure リソースを探索する

仮想マシンの詳細を確認する

仮想マシンの確認

場所別の仮想マシン

SKU 別の仮想マシン

プレミアムマネージドディスクに接続された仮想マシン

マネージドディスクの確認

仮想マシンを探索してパブリック IP アドレスを確認する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Resource Graph を使用してご利用の Azure リソースを探索する

仮想マシンの詳細を確認する

仮想マシンの確認

場所別の仮想マシン

SKU 別の仮想マシン

プレミアム マネージド ディスクに接続された仮想マシン

マネージド ディスクの確認

仮想マシンを探索してパブリック IP アドレスを確認する

次のステップ

フィードバック

その他のリソース

プレミアムマネージドディスクに接続された仮想マシン

マネージドディスクの確認