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

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

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

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

ثبتالملحق

لتمكين 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>

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

بعد إضافة ملحق 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. لمعرفة المزيد حول لغة Resource Graph، تابع إلى صفحة تفاصيل لغة الاستعلام.

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