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

Makale
2025-04-12

Etiketler, Azure kaynaklarınıza uyguladığınız meta veri öğeleridir. Bunlar, kuruluşunuzla ilgili ayarlara göre kaynakları belirlemenize yardımcı olan anahtar-değer çiftleridir. Kaynaklarınız için dağıtım ortamını izlemek istiyorsanız adlı Environmentbir anahtar ekleyin. Üretime dağıtılan kaynakları tanımlamak için, bu kaynaklara değerini Productionverin. Tam anahtar-değer çifti şeklindedir Environment = Production.

Bu makalede etiketleri kullanma koşulları ve sınırlamaları açıklanmaktadır.

Etiket kullanımı ve öneriler

Etiketleri Azure kaynaklarınıza, kaynak gruplarınıza ve aboneliklerinize uygulayabilirsiniz ancak yönetim gruplarına uygulayamayın.

Etiketleme stratejisini uygulamaya yönelik öneriler için Kaynak Adlandırma ve Etiketleme Kararı Kılavuzu'na bakın.

Kaynak etiketleri tüm maliyet getiren hizmetleri destekler. Maliyet tahakkuk eden hizmetlerin bir etiketle sağlandığından emin olmak için etiket ilkelerinden birini kullanın.

Uyarı

Etiketler düz metin olarak depolanır. Etiketlere hassas değerler eklemeyin. Hassas değerler maliyet raporları, mevcut etiket tanımlarını döndüren komutlar, dağıtım geçmişleri, dışarı aktarılan şablonlar ve izleme günlükleri gibi birçok yöntemle kullanıma sunılabilir.

Uyarı

Etiketlerinizde İngilizce olmayan bir dil kullanırken dikkatli olun. Sanal makinenizin meta verilerini IMDS'den (Örnek Meta Veri Hizmeti) yüklerken kod çözme ilerleme hatasına neden olabilir.

Önemli

Tag names are case-insensitive for operations. An operation updates or retrieves a tag with a tag name, regardless of the casing. However, the resource provider might keep the casing you provide for the tag name. You see that casing in cost reports.

Tag values are case-sensitive.

Note

Bu makale, cihaz veya hizmetten kişisel verilerin nasıl silineceği hakkında adımlar sağlar ve GDPR kapsamındaki yükümlülüklerinizi desteklemek için kullanılabilir. GDPR hakkında genel bilgiler için, Microsoft Güven Merkezinin GDPR bölümüne ve Servis güven portalının GDPR bölümüne bakın.

Gerekli erişim

Etiket kaynaklarına gerekli erişimi almanın iki yolu vardır:

Kaynak türüne Microsoft.Resources/tags yazma erişiminiz olabilir. Bu erişim sayesinde kaynağın kendisine erişiminiz olmasa bile kaynağı etiketleyebilirsiniz. Katkıda Bulunan Etiketçi rolü bu erişimi verir. Örneğin, bu rol Azure portalı aracılığıyla kaynaklara veya kaynak gruplarına etiket uygulayamaz. Ancak, Azure portalı aracılığıyla aboneliklere etiket uygulayabilir. Azure PowerShell ve REST API aracılığıyla tüm etiket işlemlerini destekler.
Kaynağın kendisine yazma erişimi elde edebilirsiniz. Katkıda Bulunan rolü, herhangi bir varlığa etiket uygulamak için gerekli erişimi verir. Etiketleri tek bir kaynak türüne uygulamak için bu kaynağın Katkıda Bulunan rolünü kullanın. Sanal makinelere etiket uygulamak için Sanal Makine Katılımcısı rolünü kullanın.

Inherit tags

Kaynaklar, kaynak grubuna veya aboneliğe uyguladığınız etiketleri devralmaz. To apply tags from a subscription or resource group to the resources, see Assign policy definitions for tag compliance.

Cm-resource-parent etiketini kullanarak bir Azure kaynağının maliyetlerini gruplandırabilirsiniz. Bu etiket, filtreleri kullanmak zorunda kalmadan Microsoft Maliyet Yönetimi'nde etiketli maliyetleri gözden geçirmenizi sağlar. Bu etiketin anahtarı ve cm-resource-parent değeri, maliyetleri gruplandırmak istediğiniz Azure kaynağının kaynak kimliğidir. Örneğin, maliyetleri bir Azure Sanal Masaüstü konak havuzuna göre gruplandırmak için konak havuzunun kaynak kimliğini belirtin. Daha fazla bilgi için Bkz . Kaynaklar görünümünde ilgili kaynakları gruplandırma.

Etiketler ve faturalama

Faturalama verilerinizi gruplandırmak için etiketleri kullanın. Örneğin, farklı kuruluşlar için birden çok sanal makine çalıştırıyorsanız, kullanımı maliyet merkezine göre gruplandırmak için etiketleri kullanın. Üretim ortamında çalışan sanal makineler için faturalama kullanımı dahil olmak üzere maliyetleri çalışma zamanı ortamına göre kategorilere ayırmak için etiketleri de kullanabilirsiniz.

Etiketler hakkında bilgi almak için Azure portalından kullanım dosyasını indirin. Daha fazla bilgi için, Azure faturanızı nasıl indireceğinizi veya görüntüleyeceğinizi görün. Faturalamayla etiketleri destekleyen hizmetlerde, etiketler Etiketler sütununda görüntülenir.

REST API işlemleri için bkz. Azure Faturalama REST API'sine genel bakış.

Unique tags pagination

Benzersiz etiketler API'sini çağırdığınızda, her API yanıt sayfasının boyutuyla ilgili bir sınır vardır. Büyük bir benzersiz değer kümesine sahip bir etiket, API'nin kalan değer kümesini almak için sonraki sayfayı getirmesini gerektirir. Sonuçlar birden çok sayfaya bölündüğünde API yanıtı, değerlerin hala bu anahtarın altında olduğunu belirtmek için etiket anahtarını yeniden gösterir.

Bu davranış, Azure portalı gibi bazı araçların etiket anahtarını iki kez göstermesine neden olabilir.

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 uygulayamayacağınızı saptamak için bkz. Azure kaynakları için etiket desteği.
Etiketlerle çalışırken her kaynak türünün belirli gereksinimleri olabilir. Örneğin, yalnızca sanal makine çalışırken sanal makine uzantılarındaki etiketleri güncelleştirebilirsiniz. Etiketi güncelleştirmeye çalışırken bir hata iletisi alırsanız iletideki yönergeleri izleyin.
Her kaynak, kaynak grubu ve abonelik en fazla 50 etiket adı-değeri çifti içerebilir. İzin verilen üst sınırdan daha fazla etiket uygulamanız gerekiyorsa, etiket değeri için bir JSON dizesi kullanın. JSON dizesi, tek etiket adına uyguladığınız değerlerden birçoğunu içerebilir. Kaynak grupları veya abonelikler, her biri 50 etiket adı-değeri çiftine sahip çok sayıda kaynak içerebilir.
Etiket adının sınırı 512 karakter ve etiket değerinin sınırı 256 karakterdir. Depolama hesapları için etiket adının sınırı 128 karakter ve etiket değerinin sınırı 256 karakterdir.
Cloud Services gibi klasik kaynaklar etiketleri desteklemez.
Azure IP Grupları ve Azure Güvenlik Duvarı ilkeleri PATCH işlemlerini desteklemez. Bu nedenle PATCH API yöntemi işlemleri Azure portalı aracılığıyla etiketleri güncelleştiremez. Bunun yerine, bu kaynaklar için güncelleştirme komutlarını kullanın. Örneğin, komutuyla az network ip-group update bir IP grubunun etiketlerini güncelleştirebilirsiniz.
Etiket adları şu karakterleri içeremez: <, >, %, &, , \, ?, /
Note
- Azure DNS bölgeleri, etikette veya bir sayı ile başlayan bir etikette boşluk veya parantez kullanımını desteklemez. Azure DNS etiket adları özel ve Unicode karakterleri desteklemez. Değer tüm karakterleri içerebilir.
- Traffic Manager, etiket adında boşluk, # veya : kullanımını desteklemez. Etiket adı sayıyla başlayamaz.
- Azure Front Door, etiket adında # veya : kullanımını desteklemez.
- Aşağıdaki Azure kaynakları yalnızca 15 etiketi destekler:
  - Azure Otomasyonu
  - Azure Content Delivery Network
  - Azure Genel DNS (Bölge ve A kayıtları)
  - Azure Özel DNS (Bölge ve A kayıtları)
  - Azure Log Analytics saved search

Sonraki adımlar

Etiketlerle çalışma hakkında daha fazla bilgi için bkz:

Aracılığıyla paylaş