مشاركة عبر

التشغيل السريع: إنشاء استعلام مشترك ل Resource Graph باستخدام Azure CLI

  • مقالة

يصف هذا التشغيل السريع كيفية إنشاء استعلام مشترك ل Azure Resource Graph باستخدام Azure CLI وملحق Resource Graph. أوامر az graph shared-query هي ميزة تجريبية لاستعلام الرسم البياني az.

يمكن تشغيل استعلام مشترك من Azure CLI باستخدام أوامر الميزة التجريبية ، أو يمكنك تشغيل الاستعلام المشترك من مدخل Microsoft Azure. الاستعلام المشترك هو كائن Azure Resource Manager يمكنك منح الإذن له أو تشغيله في Azure Resource Graph Explorer. عند الانتهاء، يمكنك إزالة ملحق Resource Graph.

المتطلبات الأساسية

ثبتالملحق

لتمكين Azure CLI من الاستعلام عن الموارد باستخدام Azure Resource Graph، يجب تثبيت ملحق Resource Graph. في المرة الأولى التي تقوم فيها بتشغيل استعلام مع az graph مطالبة يتم عرض لتثبيت الملحق. وإلا، استخدم الخطوات التالية لإجراء تثبيت يدوي.

  1. سرد الملحقات والإصدارات المتوفرة:

    az extension list-available --output table

  2. تثبيت الملحق:

    az extension add --name resource-graph

  3. تحقق من تثبيت الملحق:

    az extension list --output table

  4. عرض بناء جملة الملحق:

    az graph query --help

لمزيد من المعلومات حول ملحقات Azure CLI، انتقل إلى استخدام الملحقات وإدارتها باستخدام Azure CLI.

قم بالاتصال بـ Azure

من جلسة Visual Studio Code الطرفية، اتصل ب Azure. إذا كان لديك أكثر من اشتراك واحد، فقم بتشغيل الأوامر لتعيين السياق إلى اشتراكك. استبدل <subscriptionID> بمعرف اشتراك Azure الخاص بك.

az login

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

إنشاء استعلام مشترك

إنشاء مجموعة موارد ومشتركة تلخص عدد جميع الموارد المجمعة حسب الموقع.

  1. إنشاء مجموعة موارد لتخزين الاستعلام المشترك Azure Resource Graph.

    az group create --name "demoSharedQuery" --location westus2

  2. إنشاء الاستعلام المشترك.

    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

  3. سرد كافة الاستعلامات المشتركة في مجموعة الموارد.

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

  4. قصر النتائج على استعلام مشترك معين.

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

تشغيل الاستعلام المشترك

يمكنك استخدام بناء جملة الميزة التجريبية Azure CLI أو مدخل Microsoft Azure لتشغيل الاستعلام المشترك.

استخدام ميزة تجريبية لتشغيل الاستعلام المشترك

قم بتشغيل الاستعلام المشترك في Azure CLI باستخدام بناء الجملة {{shared-query-uri}} في أمر az graph query . يمكنك الحصول على معرف المورد للاستعلام المشترك وتخزينه في متغير. يتم استخدام المتغير عند تشغيل الاستعلام المشترك.

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

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

يمكنك استخدام المعلمة subscriptions للحد من النتائج.

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

تشغيل الاستعلام المشترك من المدخل

يمكنك التحقق من عمل الاستعلام المشترك باستخدام Azure Resource Graph Explorer. لتغيير النطاق، استخدم قائمة النطاق على الجانب الأيمن من الصفحة.

  1. تسجيل الدخول إلى مدخل Azure.
  2. أدخل الرسم البياني للمورد في حقل البحث في أعلى الصفحة.
  3. حدد Resource Graph Explorer.
  4. حدد Open query.
  5. تغيير النوع إلى الاستعلامات المشتركة.
  6. حدد الاستعلام Count VMs by OS.
  7. حدد تشغيل الاستعلام وإخراج العرض في علامة التبويب النتائج .
  8. حدد المخططات ثم حدد خريطة لعرض خريطة الموقع.

يمكنك أيضا تشغيل الاستعلام من مجموعة الموارد الخاصة بك.

  1. في Azure، انتقل إلى مجموعة الموارد، demoSharedQuery.
  2. من علامة التبويب Overview، حدد الاستعلام Count VMs by OS.
  3. حدد علامة التبويب النتائج.
  4. حدد المخططات ثم حدد خريطة لعرض خريطة الموقع.

تنظيف الموارد

لإزالة الاستعلام المشترك:

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

عند حذف مجموعة موارد، يتم حذف مجموعة الموارد وجميع مواردها. لإزالة مجموعة الموارد:

az group delete --name demoSharedQuery

لإزالة ملحق Resource Graph، قم بتشغيل الأمر التالي:

az extension remove --name resource-graph

لتسجيل الخروج من جلسة Azure CLI:

az logout

الخطوات التالية

في هذا التشغيل السريع، أضفت ملحق Resource Graph إلى بيئة Azure CLI الخاصة بك وأنشأت استعلاما مشتركا. لمعرفة المزيد حول لغة Resource Graph، تابع إلى صفحة تفاصيل لغة الاستعلام.

فهم لغة استعلام Azure Resource Graph