استخدام العلامات لتنظيم موارد Azure والتسلسل الهرمي للإدارة

مقالة
04/06/2022
قراءة خلال 15 دقائق

يمكنك تطبيق العلامات على موارد Azure ومجموعات الموارد والاشتراكات لتنظيمها في تصنيف منطقيًا. حيث تتكون كل علامة من اسم وزوج قيم. على سبيل المثال، يمكنك تطبيق اسم "البيئة" والقيمة "الإنتاج" على كافة الموارد في الإنتاج.

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

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

تحذير

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

هام

أسماء العلامات غير حساسة لحالة الأحرف لغرض العمليات. يتم تحديث أو استرداد علامة تحمل اسم علامة، بغض النظر عن الغلاف. ومع ذلك، قد يحتفظ مزود المورد بالغلاف الذي توفره لاسم العلامة. سترى هذا الغلاف في تقارير التكلفة.

قيم العلامة حساسة بالنسبة لحالة الأحرف.

ملاحظة

توفر هذه المقالة خطوات حول كيفية حذف بيانات التعريف من الجهاز أو الخدمة ويمكن استخدامها لدعم التزاماتك بموجب القانون العام لحماية البيانات (GDPR). للحصول على معلومات عامة حول GDPR، راجع قسم GDPR من مركز ثقة Microsoft وقسم GDPR من بوابة خدمة الثقة.

الوصول المطلوب

هناك طريقتان للحصول على الوصول المطلوب إلى موارد العلامة.

يمكنك أن تملك صلاحية كتابةMicrosoft.Resources/tags نوع المورد. يتيح لك هذا الوصول وضع علامة على أي مورد، حتى إذا لم تملك صلاحية الوصول إلى المورد نفسه. يمنح دور المساهم العلامة هذا الوصول. حاليًا، لا يمكن لدور المساهم في العلامة تطبيق علامات على الموارد أو مجموعات الموارد من خلال البوابة. يمكن تطبيق العلامات على الاشتراكات من خلال البوابة. وهو يدعم جميع عمليات العلامة من خلال PowerShell وREST API.
تستطيع أن تملك صلاحية كتابة المورد نفسه. يمنح دور المساهم حق الوصول المطلوب لتطبيق العلامات على أي كيان. لتطبيق علامات على نوع مورد واحد فقط، استخدم دور المساهم لهذا المورد. على سبيل المثال، لتطبيق العلامات على الأجهزة الظاهرية، استخدم Virtual Machine Contributor.

PowerShell

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

يقدم Azure PowerShell أمرين لتطبيق العلامات: New-AzTagوUpdate-AzTag. يجب أن يكون لديك Az.Resources الوحدة النمطية 1.12.0 أو أحدث. يمكنك التحقق من الإصدار الخاص بك من خلالGet-InstalledModule -Name Az.Resources. يمكنك تثبيت تلك الوحدة النمطية أو تثبيت Azure PowerShell 3.6.1 أو أحدث.

New-AzTagاستبدال كافة العلامات على المورد أو مجموعة الموارد أو الاشتراك. عند استدعاء الأمر، مرر معرف المورد للكيان الذي ترغب في وضع علامة عليه.

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

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

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

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

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

$tags = @{"Team"="Compliance"; "Environment"="Production"}
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

لإضافة علامات إلى مورد يحتوي على علامات بالفعل، استخدم Update-AzTag. عين -Operation المعلمة إلىMerge

$tags = @{"Dept"="Finance"; "Status"="Normal"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

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

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

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

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

عند تعيين -Operation المعلمة إلى Replace، تُستبدل العلامات الموجودة بمجموعة جديدة من العلامات.

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

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

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

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

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

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

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

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

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

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

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

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

قد يكون لديك أكثر من مورد واحد بنفس الاسم في مجموعة موارد. في هذه الحالة، يمكنك تعيين كل مورد بالأوامر التالية:

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

للحصول على علامات مورد أو مجموعة موارد أو اشتراك، استخدم الأمر Get-AzTag ومرر معرف المورد للكيان.

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

$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

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

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

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

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

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

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

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

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

(Get-AzResource -TagName "Dept").Name

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

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

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

لإزالة علامات معينة، Update-AzTag استخدم -Operation وعين إلى Delete . مرر العلامات التي تريد حذفها.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

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

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

لإزالة كافة العلامات، استخدم الأمر Remove-AzTag.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

Azure CLI

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

يقدم Azure CLI أمرين لتطبيق العلامات: إنشاء علامة az وتحديث علامة az. يجب أن يكون لديك Azure CLI 2.10.0 أو أحدث. يمكنك التحقق من الإصدار الخاص بك من خلالaz version. للتحديث أو التثبيت، راجع تثبيت Azure PowerShell.

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"
  }
},

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"

قوالب ARM

يمكنك وضع علامة على الموارد ومجموعات الموارد والاشتراكات في أثناء النشر باستخدام قالب Azure Resource Manager (قالب ARM).

ملاحظة

العلامات التي تضعها من خلال قالب ARM أو ملف Bicep تنطبع على أي علامات موجودة.

تطبيق القيم

ينشر المثال التالي حساب تخزين مع ثلاث علامات. يتم تعيين علامتين (DeptوEnvironment) إلى قيم حرفية. يتم تعيين علامة واحدة (LastDeployed) إلى المعلمة التي لا تفي بالتاريخ الحالي.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "utcShort": {
      "type": "string",
      "defaultValue": "[utcNow('d')]"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "Finance",
        "Environment": "Production",
        "LastDeployed": "[parameters('utcShort')]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param utcShort string = utcNow('d')

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: 'Finance'
    Environment: 'Production'
    LastDeployed: utcShort
  }
}

تطبيق كائن

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

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "tagValues": {
      "type": "object",
      "defaultValue": {
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": "[parameters('tagValues')]",
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location
param tagValues object = {
  Dept: 'Finance'
  Environment: 'Production'
}

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: tagValues
}

تطبيق سلسلة JSON

لتخزين العديد من القيم في علامة واحدة، تطبق سلسلة JSON التي تمثل القيم. يتم تخزين سلسلة JSON بأكملها كعلامة واحدة لا يمكن أن تتجاوز 256 حرفًا. يحتوي المثال التالي على علامة واحدة مسماةCostCenterتحتوي على قيم متعددة من سلسلة JSON:

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    CostCenter: '{"Dept":"Finance","Environment":"Production"}'
  }
}

تطبيق علامات من مجموعة الموارد

لتطبيق العلامات من مجموعة الموارد على المورد، يمكنك أيضًا استخدام الوظيفة(resourceGroup) عند الحصول على قيمة العلامة، استخدم tags[tag-name] بناء الجملة بدلاً من tags.tag-name بناء الجملة، لأنه لا يتم تحليل بعض الأحرف بشكل صحيح في تسجيل الرمز.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "Dept": "[resourceGroup().tags['Dept']]",
        "Environment": "[resourceGroup().tags['Environment']]"
      },
      "properties": {}
    }
  ]
}

param location string = resourceGroup().location

resource stgAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'storage${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  tags: {
    Dept: resourceGroup().tags['Dept']
    Environment: resourceGroup().tags['Environment']
  }
}

تطبيق علامات على مجموعات الموارد أو الاشتراكات

يمكنك إضافة علامات إلى مجموعة موارد أو اشتراك عن طريق نشر Microsoft.Resources/tagsنوع المورد. يتم تطبيق العلامات على مجموعة الموارد المستهدفة أو الاشتراك للنشر. في كل مرة تقوم فيها بنشر القالب، تستبدل أي علامات تم تطبيقها مسبقًا.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tagName": {
      "type": "string",
      "defaultValue": "TeamName"
    },
    "tagValue": {
      "type": "string",
      "defaultValue": "AppTeam1"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "name": "default",
      "apiVersion": "2021-04-01",
      "properties": {
        "tags": {
          "[parameters('tagName')]": "[parameters('tagValue')]"
        }
      }
    }
  ]
}

param tagName string = 'TeamName'
param tagValue string = 'AppTeam1'

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: {
      '${tagName}': tagValue
    }
  }
}

لتطبيق العلامات على مجموعة موارد، استخدم PowerShell أو Azure CLI. نشر إلى مجموعة الموارد التي تريد وضع علامة.

New-AzResourceGroupDeployment -ResourceGroupName exampleGroup -TemplateFile https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment group create --resource-group exampleGroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

لتطبيق العلامات على اشتراك، استخدم PowerShell أو Azure CLI. نشر إلى الاشتراك الذي تريد وضع علامة.

New-AzSubscriptionDeployment -name tagresourcegroup -Location westus2 -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

az deployment sub create --name tagresourcegroup --location westus2 --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

للمزيد من المعلومات عن عمليات التوزيع على مستوى الاشتراك، يُرجى الرجوع إلى إنشاء موارد ومجموعات موارد على مستوى الاشتراك.

يضيف القالب التالي العلامات من كائن إلى مجموعة موارد أو اشتراك.

JSON
Bicep

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "tags": {
      "type": "object",
      "defaultValue": {
        "TeamName": "AppTeam1",
        "Dept": "Finance",
        "Environment": "Production"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/tags",
      "apiVersion": "2021-04-01",
      "name": "default",
      "properties": {
        "tags": "[parameters('tags')]"
      }
    }
  ]
}

targetScope = 'subscription'

param tagObject object = {
  TeamName: 'AppTeam1'
  Dept: 'Finance'
  Environment: 'Production'
}

resource applyTags 'Microsoft.Resources/tags@2021-04-01' = {
  name: 'default'
  properties: {
    tags: tagObject
  }
}

المدخل

إذا لم يكن لدى المستخدم حق الوصول المطلوب لتطبيق العلامات، يمكنك تعيين دور مساهم العلامة للمستخدم. لمزيد من المعلومات، راجع البرنامج التعليمي: منح وصول مستخدم إلى موارد Azure باستخدام RBAC ومدخل Azure.

لعرض علامات مورد أو مجموعة موارد، ابحث عن العلامات الموجودة في النظرة العامة. إذا لم تكن قد طبقت العلامات مسبقًا، ستجد القائمة فارغة.
لإضافة علامة، حدد انقر هنا لإضافة علامات.
وفر اسم وقيمة.
تابع إضافة علامات حسب الحاجة. حدد حفظ عند الانتهاء.
يتم عرض العلامات الآن في النظرة العامة.
لإضافة علامة أو حذفها، حدد تغيير.
لحذف علامة، حدد رمز سلة المحذوفات. ثم حدد حفظ.

لتعيين علامات مجمعة إلى موارد متعددة:

من أي قائمة موارد، حدد خانة الاختيار للموارد التي تريد تعيين العلامة فيها. ثم حدد تعيين العلامات.
أضف أسماء وقيم. حدد حفظ عند الانتهاء.

لعرض كافة الموارد التي تحمل علامة:

في قائمة مدخل Azure، ابحث عن العلامات. حدده من الخيارات المتاحة.
حدد العلامة لعرض الموارد.
يتم عرض كافة الموارد التي تحمل هذه العلامة.

REST API

للعمل مع العلامات من خلال API Rest Azure، استخدم:

العلامات - إنشاء أو تحديث في النطاق (عملية PUT)
العلامات - تحديث في النطاق (عملية PATCH)
العلامات - الحصول على نطاق (GET عملية)
العلامات - حذف في النطاق (عملية DELETE)

SDK

للحصول على عينات من تطبيق العلامات باستخدام SDKs، راجع:

وراثة العلامات

العلامات المطبقة على مجموعة الموارد أو الاشتراك غير موروثة من الموارد. لتطبيق علامات من اشتراك أو مجموعة موارد على الموارد، راجع Azure Policies - العلامات

العلامات والفوترة

يُمكنك استخدام العلامات لتجميع بيانات الفوترة الخاصة بك. على سبيل المثال، إذا كنت تشغّل أجهزة ظاهرية متعددة لمؤسسات مختلفة، فإنه يُمكنك استخدم العلامات لتجميع الاستخدام حسب مركز التكلفة. ويُمكنك أيضًا استخدام العلامات لتصنيف التكاليف حسب بيئة وقت التشغيل، مثل استخدام الفوترة للأجهزة الظاهرية التي تعمل في بيئة التشغيل.

يمكنك استرداد معلومات حول العلامات عن طريق تنزيل ملف الاستخدام، وهو ملف قيم مفصول باستخدام فاصلة (CSV) متوفر من مدخل Azure. لمزيدٍ من المعلومات، اطلع على كيفية تنزيل فاتورة Azure billing وبيانات الاستخدام اليومي. بالنسبة للخدمات التي تدعم العلامات باستخدام الفوترة، تظهر العلامات في عمود Tags .

بالنسبة لعمليات REST API، راجع مرجع Billing REST API.

التقييدات

تنطبق القيود التالية على العلامات:

لا تدعم كافة أنواع الموارد العلامات. لتحديد ما إذا كان يمكنك تطبيق علامة على نوع مورد، راجع دعم العلامة لـ Azure resources.
يمكن أن يكون لكل مورد ومجموعة موارد واشتراك بحد أقصى 50 زوجًا من أسماء/قيم العلامات. إذا كنت بحاجة إلى تطبيق علامات أكثر من الحد الأقصى المسموح به، استخدم سلسلة JSON لقيمة العلامة. يمكن أن تحتوي سلسلة JSON على العديد من القيم التي يتم تطبيقها على اسم علامة مفردة. يمكن أن تحتوي مجموعة الموارد أو الاشتراك على العديد من الموارد التي تحتوي كل منها على 50 زوج اسم/قيمة علامة.
يقتصر اسم العلامة على 512 حرفًا، وتقتصر قيمة العلامة على 256 حرفًا. بالنسبة لحسابات التخزين، يقتصر اسم العلامة على 128 حرفًا، وتقتصر قيمة العلامة على 256 حرفًا.
لا يمكن تطبيق العلامات على الموارد التقليدية مثل الخدمات السحابية.
لا تدعم مجموعات IP Azure وسياسات Azure Firewall عمليات PATCH، ما يعني أنها لا تدعم تحديث العلامات من خلال البوابة. بدلاً من ذلك، استخدم أوامر التحديث لهذه الموارد. على سبيل المثال، يمكنك تحديث العلامات لمجموعة IP باستخدام أمر az network ip-group.
لا يمكن أن تحتوي أسماء العلامات على هذه الأحرف: <، و>، و%، و&، و\، و?، و/
ملاحظة
- لا تدعم مناطق Azure DNS استخدام المسافات في العلامة أو العلامة التي تبدأ برقم. لا تدعم أسماء علامات DNS Azure أحرف الترميز الموحدة وخاصة. يمكن أن تحتوي القيمة على كافة الأحرف.
- لا يدعم مدير الزيارات استخدام المسافات، # أو : في اسم العلامة. لا يمكن أن يبدأ اسم العلامة برقم.
- لا يدعم Azure Front Door استخدام #: أو في اسم العلامة.
- تدعم موارد Azure التالية فقط 15 علامة:
  - التشغيل التلقائي من Azure
  - Azure CDN
  - Azure DNS (المنطقة وسجلات A)
  - Azure Private DNS (المنطقة، وسجلات A، وارتباط الشبكة الظاهرية)

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

لا تدعم كافة أنواع الموارد العلامات. لتحديد ما إذا كان يمكنك تطبيق علامة على نوع مورد، راجع دعم العلامة لـ Azure resources.
للحصول على توصيات حول كيفية تنفيذ إستراتيجية وضع العلامات، راجع دليل قرار تسمية الموارد ووضع علامات عليها.

استخدام العلامات لتنظيم موارد Azure والتسلسل الهرمي للإدارة

هل هذه الصفحة مفيدة؟

الوصول المطلوب

PowerShell

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

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

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

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

Azure CLI

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

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

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

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

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

قوالب ARM

تطبيق القيم

تطبيق كائن

تطبيق سلسلة JSON

تطبيق علامات من مجموعة الموارد

تطبيق علامات على مجموعات الموارد أو الاشتراكات

المدخل

REST API

SDK

وراثة العلامات

العلامات والفوترة

التقييدات

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