مشاركة عبر

الأسماء المستعارة لبنية تعريف نهج Azure

  • مقالة

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

قائمة الأسماء المستعارة تنمو دائماً. للعثور على الأسماء المستعارة التي يدعمها نهج Azure، استخدم إحدى الطرق التالية:

  • ملحق نهج Azure لـ Visual Studio Code (مستحسن)

    استخدم ملحق نهج Azure لـ Visual Studio Code لعرض الأسماء المستعارة لخصائص المورد واكتشافها.

    لقطة شاشة لملحق Azure Policy ل Visual Studio Code الذي يحوم فوق خاصية لعرض أسماء الأسماء المستعارة.

  • Azure PowerShell

    # Login first with Connect-AzAccount if not using Cloud Shell

# Use Get-AzPolicyAlias to list available providers
Get-AzPolicyAlias -ListAvailable

# Use Get-AzPolicyAlias to list aliases for a Namespace (such as Azure Compute -- Microsoft.Compute)
(Get-AzPolicyAlias -NamespaceMatch 'compute').Aliases

    إشعار

    للعثور على الأسماء المستعارة التي يمكن استخدامها مع تأثير التعديل، استخدم الأمر التالي في Azure PowerShell 4.6.0 أو أعلى:

    Get-AzPolicyAlias | Select-Object -ExpandProperty 'Aliases' | Where-Object { $_.DefaultMetadata.Attributes -eq 'Modifiable' }

  • Azure CLI

    # Login first with az login if not using Cloud Shell

# List namespaces
az provider list --query [*].namespace

# Get Azure Policy aliases for a specific Namespace (such as Azure Compute -- Microsoft.Compute)
az provider show --namespace Microsoft.Compute --expand "resourceTypes/aliases" --query "resourceTypes[].aliases[].name"

  • واجهة برمجة تطبيقات REST

    GET https://management.azure.com/providers/?api-version=2019-10-01&$expand=resourceTypes/aliases

فهم الاسم المستعار للصفيف

تحتوي العديد من الأسماء المستعارة المتوفرة على إصدار يظهر كاسم عادي وآخر [*] مرفق به، وهو اسم مستعار للصفيف. على سبيل المثال:

  • Microsoft.Storage/storageAccounts/networkAcls.ipRules

  • Microsoft.Storage/storageAccounts/networkAcls.ipRules[*]

  • يمثل الاسم المستعار العادي الحقل كقيمة واحدة. هذا الحقل مخصص لسيناريوهات مقارنة المطابقة الدقيقة عندما يجب أن تكون مجموعة القيم بأكملها محددة تماما كما هو محدد.

  • يمثل الاسم المستعار [*] للصفيف مجموعة من القيم المحددة من عناصر خاصية مورد الصفيف. على سبيل المثال:

الاسم المستعار القيم المحددة
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*] عناصر الصفيف ipRules.
Microsoft.Storage/storageAccounts/networkAcls.ipRules[*].action قيم الخاصية action من كل عنصر من عناصر الصفيف ipRules.

عند استخدامها في شرط حقل، تتيح الأسماء المستعارة للصفيف إمكانية مقارنة كل عنصر صفيف فردي بقيمة هدف. عند استخدامها مع تعبير العدد، من الممكن:

  • تحقق من حجم صفيف.
  • تحقق مما إذا كان all\any\none من عناصر الصفيف يفي بشرط معقد.
  • تحقق مما إذا كانت عناصر الصفيف تفي بشرط معقد.n

لمزيد من المعلومات والأمثلة، راجع الرجوع إلى خصائص مورد الصفيف.

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