Azure kaynaklarınızı ve yönetim hiyerarşisini düzenlemek için etiketleri kullanma

Etiketleri bir sınıflandırmada mantıksal olarak düzenlemek için Azure kaynaklarınıza, kaynak gruplarınıza ve aboneliklere etiketler uygulayabilirsiniz. Her etiket bir ad ve bir değer çifti oluşur. Örneğin Ortam adını ve Üretim değerini üretim ortamındaki tüm kaynaklara uygulayabilirsiniz.

Etiketleme stratejisi uygulama önerileri için bkz. Kaynak adlandırma ve etiketleme kararı kılavuzu.

Önemli

Etiket adları işlemler için büyük/büyük/büyük harfe duyarlı değildir. Büyük/küçük/küçük etikete bakılmaksızın etiket adına sahip bir etiket güncelleştirilir veya alınır. Ancak, kaynak sağlayıcısı etiket adı için sağ istediğiniz büyük/büyük/sonlarını tutabilirsiniz. Bu büyük/büyük/büyük

Etiket değerleri büyük/büyük/büyük harfe duyarlıdır.

Not

Bu makale, cihaz veya hizmetten kişisel verileri silme hakkında adımlar sağlar ve GDPR kapsamındaki yükümlülüklerinizi desteklemek için kullanılabilir. GDPR hakkında genel bilgi için, Microsoft Güven Merkezi 'Nin GDPR bölümüne ve hizmet güven portalının GDPR bölümünebakın.

Gerekli erişim

Etiket kaynaklarına gerekli erişimi elde etmenin iki yolu vardır.

  • Kaynak türüne yazma erişiminiz Microsoft.Resources/tags olabilir. Bu erişim, kaynağa erişiminiz yoksa bile herhangi bir kaynağı etiketlemenizi sağlar. Etiket Katkıda Bulunanı rolü bu erişimi sağlar. Şu anda etiket katkıda bulunanı rolü, portal aracılığıyla kaynaklara veya kaynak gruplarına etiket uygulayamaktadır. Portal aracılığıyla aboneliklere etiket uygulayabilir. PowerShell ve powershell aracılığıyla tüm etiket işlemlerini REST API.

  • Kaynağın kendisine yazma erişiminiz olabilir. Katkıda Bulunan rolü, herhangi bir varlığa etiket uygulamak için gerekli erişimi sağlar. Etiketleri yalnızca bir kaynak türüne uygulamak için bu kaynağın katkıda bulunan rolünü kullanın. Örneğin, sanal makinelere etiket uygulamak için Sanal Makine Katılımcısı'nın kullanın.

PowerShell

Etiketleri uygulama

Azure PowerShell uygulamak için iki komut sunar: New-AzTag ve Update-AzTag. Az.Resources1.12.0 veya sonraki bir modüle sahip olmak gerekir. sürümünü ile kontrol Get-InstalledModule -Name Az.Resources edin. Bu modülü yükleyebilir veya 3.6.1 Azure PowerShell veya sonraki bir sürümü yükleyebilirsiniz.

, New-AzTag kaynak, kaynak grubu veya abonelikle ilgili tüm etiketleri değiştirir. komutu çağrılırken etiketlemek istediğiniz varlığın kaynak kimliğini girin.

Aşağıdaki örnek bir depolama hesabına bir etiket kümesi uygular:

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

Komut tamamlandığında kaynağın iki etiketi olduğunu fark edin.

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

Komutu yeniden çalıştırsanız ancak bu kez farklı etiketlerle çalıştırılıyorsa, önceki etiketlerin kaldırıldıklarını fark edin.

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

Zaten etiketleri olan bir kaynağa etiket eklemek için Update-AzTag kullanın. parametresini -Operation olarak Merge ayarlayın.

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

İki yeni etiketin mevcut iki etikete eklenmiştir.

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

Her etiket adının yalnızca bir değeri olabilir. Bir etiket için yeni bir değer sağlarsanız, birleştirme işlemi kullansanız bile eski değer değiştirilir. Aşağıdaki örnek, etiketi Status Normal olan yeşil olarak değiştirir.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge
Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

parametresini -Operation olarak Replace ayarsanız, mevcut etiketler yeni etiket kümesiyle değiştirilir.

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

Kaynakta yalnızca yeni etiketler kalır.

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

Aynı komutlar kaynak grupları veya aboneliklerle de çalışır. Etiketlemek istediğiniz kaynak grubunun veya aboneliğin tanımlayıcısını iletirsiniz.

Kaynak grubuna yeni bir etiket kümesi eklemek için şunları kullanın:

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

Bir kaynak grubunun etiketlerini güncelleştirmek için şunları kullanın:

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

Aboneliğe yeni bir etiket kümesi eklemek için şunları kullanın:

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

Bir aboneliğin etiketlerini güncelleştirmek için şunları kullanın:

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

Bir kaynak grubunda aynı adla birden fazla kaynağınız olabilir. Bu durumda, her kaynağı aşağıdaki komutlarla ayarlayabilirsiniz:

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

Etiketleri listeleme

Bir kaynağın, kaynak grubunun veya aboneliğin etiketlerini almak için Get-AzTag komutunu kullanın ve varlığın kaynak kimliğini geçin.

Bir kaynağın etiketlerini görmek için şunları kullanın:

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

Kaynak grubunun etiketlerini görmek için şunları kullanın:

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

Aboneliğin etiketlerini görmek için şunları kullanın:

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

Etikete göre listele

Belirli bir etiket adına ve değerine sahip kaynakları almak için şunları kullanın:

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

Herhangi bir etiket değeriyle belirli bir etiket adına sahip kaynakları almak için şunları kullanın:

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

Belirli bir etiket adına ve değerine sahip kaynak gruplarını almak için şunları kullanın:

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

Etiketleri kaldırma

Belirli etiketleri kaldırmak için kullanın ve Update-AzTag olarak -Operation Delete ayarlayın. Silmek istediğiniz etiketleri iletir.

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

Belirtilen etiketler kaldırılır.

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

Tüm etiketleri kaldırmak için Remove-AzTag komutunu kullanın.

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

Azure CLI

Etiketleri uygulama

Azure CLI, etiketleri uygulamak için iki komut sunar: az tag create ve az tag update. Azure CLI 2.10.0 veya sonraki bir niz olması gerekir. sürümünü ile kontrol az version edin. Güncelleştirmek veya yüklemek için bkz. Azure CLI'sini yükleme.

, az tag create kaynak, kaynak grubu veya abonelikle ilgili tüm etiketleri değiştirir. komutu çağrılırken etiketlemek istediğiniz varlığın kaynak kimliğini girin.

Aşağıdaki örnek bir depolama hesabına bir etiket kümesi uygular:

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

Komut tamamlandığında kaynağın iki etiketi olduğunu fark edin.

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

Komutu yeniden çalıştırsanız ancak bu kez farklı etiketlerle çalıştırılıyorsa, önceki etiketlerin kaldırıldıklarını fark edin.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production
"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Zaten etiketleri olan bir kaynağa etiket eklemek için az tag update kullanın. parametresini --operation olarak Merge ayarlayın.

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

İki yeni etiketin mevcut iki etikete eklenmiştir.

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

Her etiket adının yalnızca bir değeri olabilir. Bir etiket için yeni bir değer sağlarsanız, birleştirme işlemi kullansanız bile eski değer değiştirilir. Aşağıdaki örnek, etiketi Status Normal olan yeşil olarak değiştirir.

az tag update --resource-id $resource --operation Merge --tags Status=Green
"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

parametresini --operation olarak Replace ayarsanız, mevcut etiketler yeni etiket kümesiyle değiştirilir.

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

Kaynakta yalnızca yeni etiketler kalır.

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

Aynı komutlar kaynak grupları veya aboneliklerle de çalışır. Etiketlemek istediğiniz kaynak grubunun veya aboneliğin tanımlayıcısını iletirsiniz.

Kaynak grubuna yeni bir etiket kümesi eklemek için şunları kullanın:

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

Bir kaynak grubunun etiketlerini güncelleştirmek için şunları kullanın:

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

Aboneliğe yeni bir etiket kümesi eklemek için şunları kullanın:

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

Bir aboneliğin etiketlerini güncelleştirmek için şunları kullanın:

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

Etiketleri listeleme

Bir kaynağın, kaynak grubunun veya aboneliğin etiketlerini almak için az tag list komutunu kullanın ve varlığın kaynak kimliğini geçin.

Bir kaynağın etiketlerini görmek için şunları kullanın:

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

Kaynak grubunun etiketlerini görmek için şunları kullanın:

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

Aboneliğin etiketlerini görmek için şunları kullanın:

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

Etikete göre listele

Belirli bir etiket adına ve değerine sahip kaynakları almak için şunları kullanın:

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

Herhangi bir etiket değeriyle belirli bir etiket adına sahip kaynakları almak için şunları kullanın:

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

Belirli bir etiket adına ve değerine sahip kaynak gruplarını almak için şunları kullanın:

az group list --tag Dept=Finance

Etiketleri kaldırma

Belirli etiketleri kaldırmak için öğesini kullanın az tag update ve --operation olarak ayarlayın Delete . Silmek istediğiniz etiketleri geçirin.

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

Belirtilen Etiketler kaldırılır.

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

Tüm etiketleri kaldırmak için az Tag Delete komutunu kullanın.

az tag delete --resource-id $resource

Boşluk işleme

Etiket adlarınız veya değerleriniz boşluk içeriyorsa, bunları çift tırnak içine alın.

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

ARM şablonları

Dağıtım sırasında kaynakları, kaynak grupları ve abonelikleri bir Azure Resource Manager şablonuyla etiketleyebilir (ARM şablonu).

Not

ARM şablonu veya Bıcep dosyası aracılığıyla uyguladığınız Etiketler varolan etiketlerin üzerine yazar.

Değerleri Uygula

Aşağıdaki örnek, üç etiketli bir depolama hesabı dağıtır. Etiketlerin ikisi ( Dept ve Environment ) değişmez değerler olarak ayarlanır. Bir Tag ( LastDeployed ), geçerli tarih için varsayılan değer olan bir parametreye ayarlanır.

{
  "$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-02-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": {}
    }
  ]
}

Nesne uygulama

Birkaç etiketi depolayan bir nesne parametresi tanımlayabilir ve bu nesneyi etiket öğesine uygulayabilirsiniz. Bu yaklaşım, bir önceki örnekte daha fazla esneklik sağlar çünkü nesne farklı özelliklere sahip olabilir. Nesnedeki her özellik, kaynak için ayrı bir etiket haline gelir. Aşağıdaki örnekte etiket parametresine uygulanan tagValues adlı bir parametre kullanılmaktadır.

{
  "$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-02-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": "[parameters('tagValues')]",
      "properties": {}
    }
  ]
}

JSON dizesi uygulama

Çok sayıda değeri tek bir etikete depolamak için, değerleri temsil eden bir JSON dizesi uygulayın. JSON dizesinin tamamı 256 karakteri aşmayan bir etiket olarak depolanır. Aşağıdaki örnekte bir JSON dizesindeki çok sayıda değeri içeren CostCenter adlı tek bir etiket kullanılmaktadır:

{
  "$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-02-01",
      "name": "[concat('storage', uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "tags": {
        "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
      },
      "properties": {}
    }
  ]
}

Kaynak grubundan Etiketler uygulama

Kaynak grubundan bir kaynağa etiket uygulamak için resourceGroup () işlevini kullanın. Etiket değerini alırken tags[tag-name] sözdizimi yerine sözdizimini kullanın tags.tag-name , çünkü bazı karakterler nokta gösteriminde doğru ayrıştırılmaz.

{
  "$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-02-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": {}
    }
  ]
}

Kaynak gruplarına veya aboneliklerine Etiketler uygulama

Kaynak türünü dağıtarak bir kaynak grubuna veya aboneliğe Etiketler ekleyebilirsiniz Microsoft.Resources/tags . Etiketler, dağıtım için hedef kaynak grubuna veya aboneliğe uygulanır. Şablonu her dağıttığınızda, daha önce uygulanmış olan tüm etiketleri değiştirirsiniz.

{
  "$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')]"
        }
      }
    }
  ]
}

Etiketleri bir kaynak grubuna uygulamak için PowerShell veya Azure CLı kullanın. Etiketlemek istediğiniz kaynak grubuna dağıtın.

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

Etiketleri bir aboneliğe uygulamak için PowerShell veya Azure CLı kullanın. Etiketlemek istediğiniz aboneliğe dağıtın.

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

Abonelik dağıtımları hakkında daha fazla bilgi için bkz. abonelik düzeyinde kaynak grupları ve kaynaklar oluşturma.

Aşağıdaki şablon bir nesneden bir kaynak grubuna veya aboneliğe Etiketler ekler.

{
  "$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')]"
      }
    }
  ]
}

Portal

Bir Kullanıcı etiketleri uygulamak için gerekli erişime sahip değilse, kullanıcıya etiketi katkıda bulunan rolünü atayabilirsiniz. Daha fazla bilgi için bkz. öğretici: Azure KAYNAKLARıNA RBAC ve Azure Portal kullanarak Kullanıcı erişimi verme.

  1. Bir kaynağın veya kaynak grubunun etiketlerini görüntülemek için genel bakışta var olan etiketleri bulun. Daha önce etiket uygulamadıysanız liste boştur.

    Kaynak veya kaynak grubu için etiketleri görüntüle

  2. Etiket eklemek için, etiketleri eklemek üzere buraya tıklayın ' ı seçin.

  3. Bir ad ve değer belirtin.

    Etiket ekle

  4. Gerektiğinde Etiketler eklemeye devam edin. İşiniz bittiğinde Kaydet’i seçin.

    Etiketleri Kaydet

  5. Etiketler artık genel bakışta görüntülenir.

    Etiketleri göster

  6. Etiket eklemek veya silmek için Değiştir' i seçin.

  7. Bir etiketi silmek için çöp kutusu simgesini seçin. Sonra Kaydet' i seçin.

    Etiketi Sil

Birden çok kaynağa etiketleri toplu atamak için:

  1. Herhangi bir kaynak listesinden etiketi atamak istediğiniz kaynakların onay kutusunu seçin. Ardından, etiket ata' yı seçin.

    Birden çok kaynak seçin

  2. Ad ve değer ekleyin. İşiniz bittiğinde Kaydet’i seçin.

    Ata seçin

Etiketi olan tüm kaynakları görüntülemek için:

  1. Azure portal menüsünde, Etiketler' i arayın. Kullanılabilir seçeneklerden seçin.

    Etikete göre bul

  2. Kaynakları görüntülemek için etiketi seçin.

    Etiket Seç

  3. Bu etikete sahip tüm kaynaklar görüntülenir.

    Kaynakları etikete göre görüntüle

REST API

Azure REST API aracılığıyla etiketlerle çalışmak için şunu kullanın:

Etiketleri devralma

Kaynak grubuna veya aboneliğe uygulanan Etiketler kaynaklar tarafından devralınmaz. Bir abonelik veya kaynak grubundan kaynaklara Etiketler uygulamak için bkz. Azure ilkeleri-Etiketler.

Etiketler ve faturalandırma

Etiketleri kullanarak faturalama verilerinizi gruplandırabilirsiniz. Örneğin, farklı organizasyonlar için birden çok sanal makine çalıştırıyorsanız, maliyet merkezine göre kullanımı gruplandırmak için etiketleri kullanın. Ayrıca etiketleri kullanarak, üretim ortamında çalışan sanal makineler için faturalama kullanımı gibi, maliyetleri çalışma zamanı ortamına göre kategorilere ayırabilirsiniz.

Azure portal kullanılabilir bir virgülle ayrılmış değerler (CSV) dosyası olan kullanım dosyasını indirerek Etiketler hakkında bilgi alabilirsiniz. Daha fazla bilgi için bkz. Azure Faturalandırma faturanızı ve günlük kullanım verilerinizi indirme veya görüntüleme. İle etiketleri destekleyen hizmetler için Etiketler, Etiketler sütununda görüntülenir .

REST API işlemler için bkz. Azure faturalandırma REST API başvurusu.

Sınırlamalar

Etiketler için aşağıdaki sınırlamalar geçerlidir:

  • Tüm kaynak türleri etiketleri desteklemez. Bir kaynak türüne etiket uygulayıp uygulayacağınızı öğrenmek için bkz. Azure kaynakları Için etiket desteği.

  • Her kaynak, kaynak grubu ve abonelik en fazla 50 etiket adı/değer çiftine sahip olabilir. İzin verilen maksimum sayıdan daha fazla etiket uygulamanız gerekiyorsa, etiket değeri için bir JSON dizesi kullanın. JSON dizesi, tek etiket adına uygulanan birden fazla değer içerebilir. Bir kaynak grubu veya abonelik, her birinin 50 etiket adı/değer çifti olan çok sayıda kaynak içerebilir.

  • Etiket adı 512 karakter ile sınırlıdır ve etiket değeri 256 karakter ile sınırlıdır. Depolama hesapları için etiket adı 128 karakter ile sınırlıdır ve etiket değeri 256 karakter ile sınırlıdır.

  • Etiketler, Cloud Services gibi klasik kaynaklara uygulanamaz.

  • Azure IP grupları ve Azure Güvenlik Duvarı Ilkeleri, düzeltme eki işlemlerini desteklemez, bu da Portal aracılığıyla etiketlerin güncelleştirilmesini desteklemezler. Bunun yerine, bu kaynaklar için güncelleştirme komutlarını kullanın. Örneğin, az Network ip Group Update komutuyla bir IP grubunun etiketlerini güncelleştirebilirsiniz.

  • Etiket adları şu karakterleri içeremez: < , > ,, % & , \ , ? , /

    Not

    • Azure DNS bölgeler ve Traffic Manager, etikette veya bir sayıyla başlayan bir etikette boşluk kullanımını desteklemez.

    • Azure ön kapısı, # etiket adında veya kullanımını desteklemez : .

    • Aşağıdaki Azure kaynakları yalnızca 15 etiketi destekler:

      • Azure Otomasyonu
      • Azure CDN
      • Azure DNS (bölge ve A kayıtları)
      • Azure Özel DNS (bölge, kayıt ve sanal ağ bağlantısı)

Sonraki adımlar