Kullandığınız Azure Key Vault API sürümünü güncelleştirme

Azure Key Vault, sürümlenmiş API'leri kullanır. Uygulamalarınız, betikleriniz veya altyapı şablonlarınız eski bir API sürümünü çağırıyorsa, daha yeni özellikleri kaçırabilir, sonraki bir sürümde değiştirilen davranışı kullanabilir veya artık önerilmeyen bir sürüme bağımlı olabilirsiniz. Bu makalede, hangi API sürümünü kullandığınızı belirleme ve geçerli, desteklenen bir sürüme geçme adımları açıklanmaktadır.

Important

Denetim düzlemi için 2026-02-01 öncesindeki tüm Key Vault API sürümleri 27 Şubat 2027 tarihinde kullanımdan kaldırılacaktır. Bu tarihten sonra anahtar kasalarınız var olmaya devam eder, ancak bunları yalnızca denetim düzlemi API sürümü 2026-02-01 veya sonraki bir sürümle yönetebilirsiniz. Bu tarih için istisna veya süre uzatımı yoktur. Bu kullanımdan kaldırma işlemi, veri düzlemi API'lerini (anahtarlar, gizli bilgiler ve sertifikalarla çalışmak için kullanılan API'ler) etkilemez. Ayrıntılar için bkz. Key Vault'da varsayılan erişim denetimi modeli olarak Azure RBAC planlama.

Azure Key Vault her biri kendi sürümlerine sahip iki bağımsız API yüzeyi vardır:

API yüzeyi Yönettiği Sürüm düzeni Örnek uç nokta
Kontrol düzlemi (yönetim) Anahtar kasası kaynağının kendisi: kasaları oluşturun, güncelleştirin, silin ve SKU, ağ kuralları ve erişim denetimi gibi özellikleri yapılandırın. Tarih tabanlı ({YYYY}-{MM}-{DD}) https://management.azure.com
Veri düzlemi Kasa içindeki nesneler: anahtarlar, gizli bilgiler ve sertifikalar ile kriptografik işlemler. Tarih tabanlı ({YYYY}-{MM}-{DD}) https://<vault-name>.vault.azure.net

İki yüzey farklı sürüm oluşturma ve yaşam döngüsü uygulamalarına sahiptir. Birinin güncelleştirilmesi diğerini güncelleştirmez. İş yükünüz her ikisini de kullanıyorsa her ikisini de gözden geçirin.

Denetim düzlemi API'si sürümleri, bu makalenin önceki bölümlerinde açıklandığı gibi kullanımdan kaldırılabilir.

Önizleme veri düzlemi API sürümleri kullanım dışı bırakılabilir, bu nedenle bu yaşam döngüsünü kabul etmediğiniz sürece önizlemeleri üretimde kullanmayın. Desteklenen veri düzlemi API sürümleri için bkz. Azure Key Vault REST API başvurusu.

Bu makale, API sürümlerini tanımlamaya ve güncelleştirmeye odaklanır. Denetim düzlemi API sürümünü güncelleştirmek için mevcut bir anahtar kasasını erişim ilkelerinden Azure RBAC'ye geçirmeniz gerekmez. Erişim denetimini taşımak istiyorsanız, Erişim ilkelerinden Azure RBAC’ye geçiş yapma konusuna bkz. Yeni anahtar kasaları için 2026-02-01 ve sonraki API sürümlerinde kullanıma sunulan varsayılan Azure RBAC davranışı hakkında bilgi için bkz. Key Vault'ta varsayılan erişim denetimi modeli olarak Azure RBAC’yi planlama.

Neden geçerli bir API sürümüne geçmeliyiz?

  • Desteklenen özellikleri kullanın. Daha yeni API sürümleri özellikler ekleyebilir, doğru davranışlar yapabilir veya yeni hizmet özelliklerini destekleyebilir.
  • Üretim iş yüklerini kararlı tutun. Üretim iş yükleri için geçerli bir kararlı API sürümü kullanın. Önizleme API'si sürümleri değerlendirme ve erken test içindir ve Azure desteği SLA'lar bunları kapsamayabilir. Önizleme sürümleri kullanım dışı bırakılabilir.
  • Araçları ve kitaplıkları uyumlu tutun. Azure CLI, Azure PowerShell, SDK'lar, şablonlar ve portal farklı API sürümlerini kullanabilir. Bir istemcinin sürümünü güncelleştirmek diğerlerini güncelleştirmez.

Geçerli denetim düzlemi sürümleri için bkz . Desteklenen denetim düzlemi API sürümleri. Desteklenen veri düzlemi sürümleri için bkz. Azure Key Vault REST API başvurusu.

Hangi API sürümünü kullandığınızı belirleme

API sürümünü, Key Vault nasıl çağırdığınıza bağlı olarak farklı şekilde belirtirsiniz. İş yükünüzün kullandığı her yüzeyi denetleyin.

Kontrol düzlemi (yönetim)

  • REST API: Sürüm, https://management.azure.com'ye yapılan isteklerdeki api-version sorgu dizesi parametresidir; örneğin ?api-version=<control-plane-version>.
  • ARM, Bicep ve Terraform şablonları: Sürüm, her Microsoft.KeyVault/vaults kaynağın apiVersion özelliğidir. Bicep'te, kaynak türü bildiriminin bir parçasıdır; örneğin resource kv 'Microsoft.KeyVault/vaults@2026-02-01'.
  • Denetim düzlemi yönetim SDK'ları: Paket sürümü, bir SDK'nın hangi API sürümlerini desteklediğini belirleyebilir, ancak yalnızca paket sürümü her zaman bir istek tarafından kullanılan API sürümünü tanımlamaz. Paketin sürüm notlarını ve API referansını (örneğin, azure-mgmt-keyvault veya Azure.ResourceManager.KeyVault için) denetleyin ve bunları projenizin bağımlılık bildirimi dosyasındaki paket sürümüyle karşılaştırın. Dile göre API başvuruları için bkz. Azure Key Vault istemci kitaplıkları.
  • Azure CLI ve Azure PowerShell: API sürümünü Azure CLI veya Az modülünüzün sürümü belirler. Yüklü sürümünüzü az version veya Get-InstalledModule -Name Az ile denetleyin.
  • Azure portalı: Portal, istekleri için denetim düzlemi API sürümünü seçer. Bu sürümü doğrudan ayarlayamazsınız. Portal şablonlarınızdan, betiklerinizden veya SDK'larınızdan farklı bir API sürümü kullanabilir, bu nedenle otomasyonunuz tarafından kullanılan sürümü belirlemek için portal davranışını kullanmayın.
  • Azure Cloud Shell: Cloud Shell geçerli Azure CLI ve Azure PowerShell sürümlerini kullanır. betikleri Cloud Shell çalıştırıyorsanız, şu anda desteklenen denetim düzlemi API sürümüyle uyumlu olduklarından emin olun.

Veri düzlemi

  • REST API: Sürüm, kasa uç noktanıza yapılan isteklerde kullanılan GET https://<vault-name>.vault.azure.net/secrets/<name>?api-version=<data-plane-version> sorgu dizesi parametresidir; örneğin api-version.
  • Veri düzlemi SDK'ları: Paket sürümü, BIR SDK'nın hangi API sürümlerini desteklediğini belirleyebilir, ancak paket sürümü her zaman bir istek tarafından kullanılan API sürümünü tanımlamaz. Paket sürüm notlarını ve API başvurusunu (örneğin, Azure.Security.KeyVault.Secrets, Azure.Security.KeyVault.Keysveya Azure.Security.KeyVault.Certificates) denetleyin ve bunları projenizin bağımlılık bildirimindeki paket sürümüyle karşılaştırın. Dile göre API başvuruları için bkz. Azure Key Vault istemci kitaplıkları.

API sürümünüzü güncelleştirme

Denetim düzlemi API sürümünü güncelleştirme

  1. Şablonlarınızda ve REST çağrılarınızda API sürümünü güncelleştirin. api-version değerini (ARM, Bicep, Terraform) veya Microsoft.KeyVault/vaults sorgu dizesi parametresini (REST), tüm apiVersion tanımlarında ve yönetim isteklerinde şu anda desteklenen bir denetim düzlemi sürümüne ayarlayın.

  2. Kontrol düzlemi yönetim SDK'larınızı güncelleştirin. Seçtiğiniz denetim düzlemi API sürümünü destekleyen paket sürümü için paket sürüm notlarını ve API başvurusunu denetleyin. Dile göre API başvuruları ve geçerli Key Vault denetim düzlemi sürümünü destekleyen paket sürümleri için bkz. Azure Key Vault istemci kitaplıkları ve Denetim düzlemi SDK sürümleri.

    Note

    Denetim düzlemi yönetim SDK'sını güncelleştirmek veri düzlemi SDK'larını güncelleştirmez. Uygulamanız her iki API yüzeyini de kullanıyorsa her SDK'yı ayrı ayrı güncelleştirin.

  3. Azure CLI ve Azure PowerShell güncelleştirin. Daha yeni araç sürümleri daha yeni API sürümlerini çağırır.

    Azure CLI'yi en son sürüme güncelleştirin. Daha fazla bilgi için bkz. Azure CLI'yi güncelleştirme.

  1. Dağıtmadan önce davranış değişikliklerini gözden geçirin. Dağıtmadan önce API sürümünün değişiklik günlüğünü ve belirtimini okuyun. API sürümü 2026-02-01 ve üzeri, yalnızca yeni anahtar kasaları için varsayılan erişim denetimi modelini değiştirir. Ayrıntılar için bkz. Key Vault'da varsayılan erişim denetimi modeli olarak Azure RBAC planlama.

Veri düzlemi API'sinin sürümünü güncelleştirme

  1. REST çağrılarınızda API sürümünü güncelleştirin. Sorgu dizesi parametresini api-version, Azure Key Vault REST API başvurusunda listelenen desteklenen bir veri düzlemi sürümüne ayarlayın.

  2. Veri düzlemi SDK'larınızı güncelleştirin. Azure.Security.KeyVault.* (veya dilinizin eşdeğeri) paketlerini geçerli kararlı bir sürüme yükseltin. Paketin hangi veri düzlemi API sürümlerini desteklediğini belirlemek için paket sürüm notlarını ve API başvurusunu denetleyin. Dile göre API başvuruları ve paket bağlantıları için bkz. Azure Key Vault istemci kitaplıkları.

Kararlı veri düzlemi API'sinin sürümleri geçerli denetim düzleminin kullanımdan kaldırılmasından etkilenmez. Önizleme veri düzlemi API'sini kullanıyorsanız, hizmet duyurularını ve API'nin yaşam döngüsüne ilişkin API başvurusunu gözden geçirin.

Veri düzlemi REST API'sini çağırma hakkında daha fazla bilgi için bkz. Kimlik doğrulaması, istekler ve yanıtlar ve Azure Key Vault REST API başvurusu.

İlgili içerik

  • Son güncelleştirme: