チュートリアル: Azure portal でのクエリの管理 - Azure Resource Graph

[アーティクル]
06/01/2023

Azure Resource Graph エクスプローラーを使うと、Azure portal で直接 Resource Graph クエリを保存できます。クエリには次の 2 種類があります: "プライベート" と "共有"。プライベートクエリは、自分の Azure portal の設定に保存されます。一方、共有クエリは、Azure ロールベースのアクセス制御 (Azure RBAC) による管理とリソースロックによる保護が可能な Azure Resource Manager リソースです。どちらの種類のクエリも、保存時に暗号化されます。

お気に入りのクエリやよく使用するクエリを Azure portal に保存しておくと、探す時間を節約できます。クエリを共有すると、一貫性と効率性というチームの目標を、繰り返しによって実現することができます。

このチュートリアルでは、次のタスクを実行します。

プライベートクエリを作成および削除する
共有クエリを作成する
共有クエリを見つける
共有クエリを削除する

前提条件

このチュートリアルを完了するには、Azure サブスクリプションが必要です。お持ちでない場合は、開始する前に無料アカウントを作成してください。

プライベートクエリを作成および削除する

プライベートクエリにアクセスしてそれを表示できるのは、クエリを作成したアカウントだけです。それらは Azure portal のアカウントの設定に保存されるので、Azure portal の内部からのみ、作成、使用、削除することができます。プライベートクエリは、Resource Manager のリソースではありません。新しいプライベートクエリを作成するには、次の手順のようにします。

ポータルのメニューから、 [すべてのサービス] を選択するか、すべてのページの上部にある Azure 検索ボックスを使用します。 [Resource Graph エクスプローラー] を探して選択します。
Azure Resource Graph エクスプローラーページの [クエリ 1] タブで、次のクエリを入力します。
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
[クエリの実行] を選択すると、下のウィンドウにクエリの結果が表示されます。

このクエリについて詳しくは、サンプル - 仮想マシンの数の取得 (OS の種類別) に関する記事をご覧ください。
[保存] または [名前を付けて保存] を選択します。 [クエリの保存] ウィンドウで、名前に「Count VMs by OS」と入力し、種類は [プライベートクエリ] のままにして、下部にある [保存] を選択します。タブのタイトルが、 [クエリ 1] から [Count VMs by OS] に変わります。
Azure portal で Azure Resource Graph エクスプローラーから別の場所に移動し、再びエクスプローラーに戻ります。保存したクエリが表示されなくなり、 [クエリ 1] タブに戻っていることに注意してください。
[クエリを開く] を選択します。種類が [プライベートクエリ] であることを確認します。保存した名前 "Count VMs by OS" が、 [クエリ名] の一覧に表示されるようになります。保存したクエリのタイトルリンクを選択すると、そのクエリの名前の新しいタブに読み込まれます。

Note

保存されているクエリを開き、タブにその名前が表示されている状態で、 [保存] ボタンを選択すると、行った変更でクエリが更新されます。この開いているクエリから新しいクエリを作成して保存するには、 [名前を付けて保存] を選択して、新しいクエリを保存したときと同じようにします。
保存したクエリを削除するには、 [クエリを開く] を再び選択し、 [種類] フィールドが [プライベートクエリ] に設定されていることを確認します。保存されている Count VMs by OS クエリの行で、 [削除] (ごみ箱アイコン) を選択します。確認ダイアログボックスで、 [はい] を選択してクエリの削除を完了します。次に、 [クエリを開く] ウィンドウを閉じます。

共有クエリを作成する

プライベートクエリとは異なり、共有クエリは Resource Manager リソースです。つまり、クエリをリソースグループに保存し、Azure RBAC で管理および制御し、リソースロックを使用して保護さえできることを意味します。適切なアクセス許可を持つすべてのユーザーが、リソースとしてそれを参照し、使用することができます。新しい共有クエリを作成するには、次の手順のようにします。

ポータルのメニューから [すべてのサービス] を選択するか、すべてのページの上部にある Azure 検索ボックスを使用し、 [Resource Graph エクスプローラー] を探して選択します。
Azure Resource Graph エクスプローラーページの [クエリ 1] タブで、次のクエリを入力します。
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
[クエリの実行] を選択すると、下のウィンドウにクエリの結果が表示されます。

このクエリについて詳しくは、サンプル - 仮想マシンの数の取得 (OS の種類別) に関する記事をご覧ください。
[保存] または [名前を付けて保存] を選択します。
[クエリの保存] ウィンドウで、名前に「Count VMs by OS」と入力します。
種類を [共有クエリ] に変更し、[説明] に「OS の種類別の仮想マシンの数」と入力し、 [サブスクリプション] を設定してクエリリソースを作成する場所を指定します。
['resource-graph-queries' リソースグループに発行します] チェックボックスをオンのままにし、 [リソースグループの場所] を [(米国) 米国中西部] に設定します。
[クエリの保存] ウィンドウの下部にある [保存] を選択します。タブのタイトルが、 [クエリ 1] から [Count VMs by OS] に変わります。 resource-graph-queries リソースグループを初めて使うときは、リソースグループが作成されるので、保存に予想以上の時間がかかります。

Note

既存のリソースグループの名前を指定して共有クエリをそこに保存する場合は、 ['resource-graph-queries' リソースグループに発行します] チェックボックスをオフにすることができます。クエリに既定の名前のリソースグループを使用すると、共有クエリを探すのが容易になります。また、そのリソースグループの目的もより明確になります。ただし、既存のアクセス許可に基づくセキュリティ上の理由から、既存のリソースグループを選択することもあります。
Azure portal で Azure Resource Graph エクスプローラーから別の場所に移動し、再びエクスプローラーに戻ります。保存したクエリが表示されなくなり、 [クエリ 1] タブに戻っていることに注意してください。
[クエリを開く] を選択します。種類が [共有クエリ] に設定されていること、および [サブスクリプション] と [リソースグループ] の組み合わせが、クエリを保存した場所と一致していることを確認します。保存した "Count VMs by OS" 項目が、 [クエリ名] の一覧に表示されるようになります。保存したクエリのタイトルリンクを選択して、そのクエリの名前の新しいタブに読み込まれます。共有クエリなので、タブのタイトルの横にアイコンが表示され、共有されていることが示されます。

Note

保存されているクエリを開き、タブにその名前が表示されている状態では、 [保存] ボタンにより、行った変更でクエリが更新されます。新しいクエリを作成して保存するには、 [名前を付けて保存] を選択して、新しいクエリを保存したときと同じようにします。

共有クエリを見つける

共有クエリは Resource Manager リソースであるため、いくつかの方法で検索できます。

Resource Graph Explorer で、 [クエリを開く] を選択し、種類を [共有クエリ] に設定します。
Resource Graph クエリのポータルページから。
共有クエリが保存されているリソースグループから。
Resource Graph に対するクエリにより。

Resource Graph クエリを表示する

Azure portal の Resource Graph クエリページには、ログインしているアカウントでアクセスできる共有クエリが表示されます。このページでは、Resource Graph クエリの名前、サブスクリプション、リソースグループ、その他のプロパティを使用して、フィルター処理を行うことができます。このインターフェイスを使用して、Resource Graph クエリのタグ付け、エクスポート、削除を行うこともできます。

いずれかのクエリを選択すると、Resource Graph クエリのページが開きます。他の Resource Manager リソースと同様に、このページには、アクティビティログ、アクセス制御、タグと共に対話形式の概要が表示されます。また、このページから直接リソースロックを適用することもできます。

ポータルのメニューから Resource Graph クエリページに移動するには、 [すべてのサービス] を選択するか、すべてのページの上部にある Azure 検索ボックスを使用します。 [Resource Graph エクスプローラー] を探して選択します。

リソースグループのリソースの一覧を表示する

Resource Graph クエリは、リソースグループの一部である他のリソースと共に一覧表示されます。 Resource Graph クエリを選択すると、そのクエリのページが開きます。省略記号およびショートカットメニューオプション (選択したままにするか、右クリックによって起動) は、Resource Graph クエリページと同じように動作します。

Resource Graph のクエリを実行する

Resource Graph のクエリを実行することで、Resource Graph クエリを見つけることができます。次の Resource Graph クエリでは、種類 Microsoft.ResourceGraph/queries によって制限した後、project を使用して名前、変更日時、およびクエリ自体のみを一覧表示しています。

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

共有クエリを実行する

Resource Graph 共有クエリは、{{shared-query-uri}} 構文 (プレビュー) を使用して実行できます。詳細については、共有クエリの構文に関するセクションを参照してください。

共有クエリを削除する

共有クエリが不要になった場合は、削除します。共有クエリを削除すると、対応する Resource Manager リソースが削除されます。結果のグラフがピン留めされたダッシュボードには、エラーメッセージが表示されるようになります。そのエラーメッセージが表示されたら、 [ダッシュボードから削除する] ボタンを使用してダッシュボードをクリーンアップします。

共有クエリは、次のインターフェイスを使用して削除できます。

Resource Graph クエリ一覧のページ
Resource Graph クエリのページ
Resource Graph エクスプローラーの [クエリを開く] ページ
リソースグループページ

リソースをクリーンアップする

このチュートリアルを終了するとき、作成したプライベートクエリと共有クエリがもう必要ない場合は削除してください。

次のステップ

このチュートリアルでは、プライベートクエリと共有クエリを作成しました。 Resource Graph 言語の詳細については、クエリ言語の詳細ページに進んでください。

クエリ言語に関する詳細情報を入手します

チュートリアル:Azure portal で Azure Resource Graph クエリを作成して共有する