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

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

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

• إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
• يجب أن يكون Azure CLI هو الإصدار 2.22.0 أو أعلى لملحق Resource Graph.
• تعليمة Visual Studio البرمجية.

قم بالاتصال بـ 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>

ثبتالملحق

لتمكين 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 CLI إلى بيئتك، يمكنك تشغيل استعلام يستند إلى المستأجر. يقوم الاستعلام في هذا المثال بإرجاع خمسة موارد Azure مع name و type لكل مورد. للاستعلام حسب مجموعة الإدارة أو الاشتراك، استخدم --management-groups أو --subscriptionsالوسيطات.

1. تشغيل استعلام Azure Resource Graph:

   az graph query --graph-query 'Resources | project name, type | limit 5'
   

   لا يستخدم مثال الاستعلام هذا معدل فرز مثل order by. إذا قمت بتشغيل الاستعلام عدة مرات، فقد ينتج عنه مجموعة مختلفة من الموارد لكل طلب.

2. تحديث الاستعلام إلى order by الخاصية name :

   az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
   

   مثل الاستعلام السابق، إذا قمت بتشغيل هذا الاستعلام عدة مرات، فقد ينتج عنه مجموعة مختلفة من الموارد لكل طلب. إن ترتيب أوامر الاستعلام مهم. في هذا المثال، يأتي order by بعد limit. يحدد الاستعلام النتائج بخمسة موارد ثم يأمر تلك النتائج بالاسم.

3. تحديث الاستعلام إلى order by الخاصية name ثم limit الإخراج إلى خمس نتائج:

   az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
   

   إذا تم تشغيل هذا الاستعلام عدة مرات دون أي تغييرات على البيئة الخاصة بك، تكون النتائج متناسقة ويتم ترتيبها بواسطة الخاصية name ، ولكنها لا تزال محدودة بخمس نتائج. يقوم الاستعلام بطلب النتائج حسب الاسم ثم يقصر الإخراج على خمسة موارد.

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

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

az extension remove --name resource-graph

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

az logout

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

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

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