مشاركة عبر

تطبيق العلامات باستخدام Azure CLI

  • مقالة

توضح هذه المقالة كيفية استخدام Azure CLI لوضع علامة على الموارد ومجموعات الموارد والاشتراكات. للحصول على توصيات العلامات وقيودها، راجع استخدام العلامات لتنظيم موارد Azure والتسلسل الهرمي للإدارة.

تطبيق العلامات

يقدم Azure CLI أمرين لتطبيق العلامات: az tag create وaz tag update. يجب أن يكون لديك إصدار Azure CLI 2.10.0 أو إصدار أحدث. يمكنك التحقق من الإصدار الخاص بك من خلالaz version. لتحديثه أو تثبيته، راجع تثبيت Azure CLI.

az tag createاستبدال كافة العلامات على المورد أو مجموعة الموارد أو الاشتراك. عند استدعاء الأمر، قم بتمرير معرف المورد للكيان الذي تريد وضع علامة عليه.

يطبق المثال التالي مجموعة من العلامات على حساب تخزين:

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag create --resource-id $resource --tags Dept=Finance Status=Normal

عند اكتمال الأمر لاحظ أن المورد يضم علامتين.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Status": "Normal"
  }
},

إذا قمت بتشغيل الأمر مرة أخرى، ولكن هذه المرة بعلامات مختلفة، فلاحظ أن العلامات السابقة تختفي.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

لإضافة علامات إلى مورد يحتوي على علامات بالفعل، استخدم az tag update. عين --operation المعلمة إلىMerge

az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal

لاحظ أن العلامات الموجودة تتزايد مع إضافة العلامتين الجديدتين.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Normal",
    "Team": "Compliance"
  }
},

يمكن أن يكون لكل اسم علامة قيمة واحدة فقط. إذا قمت بتوفير قيمة جديدة لعلامة، فإن العلامة الجديدة تحل محل القيمة القديمة، حتى إذا كنت تستخدم عملية الدمج. يغير المثال التالي Status العلامة من عادي إلى أخضر.

az tag update --resource-id $resource --operation Merge --tags Status=Green

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

عند تعيين المعلمة --operation على Replace، تحل مجموعة العلامات الجديدة محل العلامات الموجودة.

az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web

تبقى العلامات الجديدة فقط على المورد.

"properties": {
  "tags": {
    "CostCenter": "00123",
    "Project": "ECommerce",
    "Team": "Web"
  }
},

تعمل نفس الأوامر أيضًا مع مجموعات الموارد أو الاشتراكات. قم بتمريرها في معرف مجموعة الموارد أو الاشتراك الذي تريد وضع علامة عليه.

لإضافة مجموعة جديدة من العلامات إلى مجموعة موارد، استخدم:

group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal

لتحديث العلامات لمجموعة موارد، استخدم:

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

لإضافة مجموعة جديدة من العلامات إلى اشتراك، استخدم:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

لتحديث علامات الاشتراك، استخدم:

az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"

قائمة العلامات

للحصول على العلامات لمورد أو مجموعة موارد أو اشتراك، استخدم الأمر az tag list وقم بتمرير معرف المورد للكيان.

للاطلاع على العلامات الخاصة بالموارد، استخدم:

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

للاطلاع على العلامات الخاصة بمجموعة موارد، استخدم:

group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group

للاطلاع على علامات الاشتراك، استخدم:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub

القائمة حسب العلامة

للحصول على الموارد التي لها اسم علامة وقيمة معينة، استخدم:

az resource list --tag CostCenter=00123 --query [].name

للحصول على الموارد التي لها اسم علامة محددة مع أي قيمة علامة، استخدم:

az resource list --tag Team --query [].name

للحصول على مجموعات الموارد التي لها اسم علامة وقيمة معينة، استخدم:

az group list --tag Dept=Finance

إزالة العلامات

لإزالة علامات معينة، az tag update استخدم --operation وعين إلى Delete . قم بتمرير معرف المورد للعلامات التي تريد حذفها.

az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web

لقد قمت بإزالة العلامات المحددة.

"properties": {
  "tags": {
    "CostCenter": "00123"
  }
},

لإزالة كافة العلامات، استخدم الأمر az tag delete.

az tag delete --resource-id $resource

معالجة المسافات

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

az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"

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