Hızlı Başlangıç: Azure CLI kullanarak Kaynak Grafı paylaşılan sorgu oluşturma

Makale
06/28/2024

Bu hızlı başlangıçta, Azure CLI ve Kaynak Grafı uzantısıyla Azure Kaynak Grafı paylaşılan sorgunun nasıl oluşturulacağı açıklanır. az graph shared-query komutları, az graph query'nin deneysel bir özelliğidir.

Paylaşılan sorgu, deneysel özelliğin komutlarıyla Azure CLI'dan çalıştırılabilir veya paylaşılan sorguyu Azure portalından çalıştırabilirsiniz. Paylaşılan sorgu, Azure Kaynak Grafı Gezgini'nde izin verebileceğiniz veya çalıştırabileceğiniz bir Azure Resource Manager nesnesidir. bitirdiğinizde, Kaynak Grafı uzantısını kaldırabilirsiniz.

Önkoşullar

Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.
Kaynak Grafı uzantısı için Azure CLI 2.22.0 veya üzeri bir sürüm olmalıdır.
Azure CLI komutlarını çalıştırabileceğiniz bir Bash kabuğu ortamı. Örneğin, Visual Studio Code terminal oturumunda Git Bash.

Uzantıyı yükleme

Azure CLI'nın Azure Kaynak Grafı kullanarak kaynakları sorgulamasını sağlamak için Kaynak Grafı uzantısının yüklenmesi gerekir. Uzantıyı yüklemek için bir sorguyu ilk kez komut istemiyle az graph çalıştırdığınızda görüntülenir. Aksi takdirde, el ile yükleme yapmak için aşağıdaki adımları kullanın.

Kullanılabilir uzantıları ve sürümleri listeleyin:
```
az extension list-available --output table
```
Uzantıyı yükleyin:
```
az extension add --name resource-graph
```
Uzantının yüklendiğini doğrulayın:
```
az extension list --output table
```
Uzantının söz dizimini görüntüleyin:
```
az graph query --help
```

Azure CLI uzantıları hakkında daha fazla bilgi için Azure CLI ile uzantıları kullanma ve yönetme bölümüne gidin.

Azure'a bağlanma

Visual Studio Code terminal oturumundan Azure'a bağlanın. Birden fazla aboneliğiniz varsa, aboneliğinize bağlam ayarlamak için komutları çalıştırın. <subscriptionID> öğesini Azure abonelik kimliğinizle değiştirin.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Paylaşılan sorgu oluşturma

Konuma göre gruplandırılmış tüm kaynakların sayısını özetleyen bir kaynak grubu ve paylaşılan oluşturun.

Azure Kaynak Grafı paylaşılan sorgusunu depolamak için bir kaynak grubu oluşturun.
```
az group create --name "demoSharedQuery" --location westus2
```

Paylaşılan sorguyu oluşturun.

az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

Kaynak grubundaki tüm paylaşılan sorguları listeleyin.

az graph shared-query list --resource-group demoSharedQuery

Sonuçları belirli bir paylaşılan sorguyla sınırlayın.

az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Paylaşılan sorguyu çalıştırma

Paylaşılan sorguyu çalıştırmak için Azure CLI deneysel özellik söz dizimini veya Azure portalını kullanabilirsiniz.

Paylaşılan sorguyu çalıştırmak için deneysel özelliği kullanma

Azure CLI'da paylaşılan sorguyu bir az graph query komuttaki {{shared-query-uri}} söz dizimi ile çalıştırın. Paylaşılan sorgunuzun kaynak kimliğini alır ve bir değişkende depolarsınız. Değişken, paylaşılan sorguyu çalıştırdığınızda kullanılır.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Sonuçları sınırlamak subscriptions için parametresini kullanabilirsiniz.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Paylaşılan sorguyu portaldan çalıştırma

Azure Kaynak Grafı Gezgini'ni kullanarak paylaşılan sorgunun çalıştığını doğrulayabilirsiniz. Kapsamı değiştirmek için sayfanın sol tarafındaki Kapsam menüsünü kullanın.

Azure portalda oturum açın.
Sayfanın üst kısmındaki arama alanına kaynak grafı girin.
Kaynak Grafı Gezgini'ne tıklayın.
Sorguyu aç'ı seçin.
Türü Paylaşılan sorgular olarak değiştirin.
VM'leri işletim sistemine göre say sorgusunu seçin.
Sonuçlar sekmesinde Sorguyu çalıştır'ı ve çıkışı görüntüle'yi seçin.
Konum haritasını görüntülemek için Grafikler'i ve ardından Harita'ya tıklayın.

Sorguyu kaynak grubunuzdan da çalıştırabilirsiniz.

Azure'da demoSharedQuery kaynak grubuna gidin.
Genel Bakış sekmesinde VM'leri işletim sistemine göre say sorgusunu seçin.
Sonuçlar sekmesini seçin.
Konum haritasını görüntülemek için Grafikler'i ve ardından Harita'ya tıklayın.

Kaynakları temizleme

Paylaşılan sorguyu kaldırmak için:

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Bir kaynak grubu silindiğinde, kaynak grubu ve tüm kaynakları silinir. Kaynak grubunu kaldırmak için:

az group delete --name demoSharedQuery

Kaynak Grafı uzantısını kaldırmak için aşağıdaki komutu çalıştırın:

az extension remove --name resource-graph

Azure CLI oturumunuzun oturumunu kapatmak için:

az logout

Sonraki adımlar

Bu hızlı başlangıçta Azure CLI ortamınıza Kaynak Grafı uzantısını eklediniz ve paylaşılan bir sorgu oluşturdunuz. Kaynak Grafı dili hakkında daha fazla bilgi edinmek için sorgu dili ayrıntıları sayfasına geçin.

Azure Kaynak Grafı sorgu dilini anlama

Aracılığıyla paylaş