Aracılığıyla paylaş

Azure Özel Kaynak Sağlayıcılarına Genel Bakış

Önemli

Özel Kaynak Sağlayıcıları şu anda genel önizleme aşamasındadır. Önizleme sürümü bir hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yüklerinde kullanılması önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

2026'da Azure Resource Manager, Özel Kaynak Sağlayıcısı (CuRP) hizmetini kullanım dışı bırakacaktır.

Bu özelliği 31 Ekim 2026'ya kadar kullanımdan kaldırdık. Bu kullanımdan kaldırma işleminin bir parçası olarak 24 Şubat 2026'da bir çığlık testi gerçekleştireceğiz. 31 Temmuz 2026'da özel kaynaklara ve kaynak sağlayıcılarına yönelik oluşturmalar, güncelleştirmeler, düzeltme ekleri ve eylemler engellenir. Yalnızca özel kaynaklarınızı ve kaynak sağlayıcılarınızı okuyup silebilirsiniz.

Bu kullanımdan kaldırmanın sizin ve ekibiniz için bir sorun olabileceğini anlıyoruz. Mevcut iş akışlarınızı desteklemek için kullanabileceğiniz bazı olası CuRP alternatifleri aşağıdadır.

Eğer CuRP senaryonuz varsa:

  • Yalnızca kalıcı kaynak yönetimine gerek kalmadan bir uç noktanın tetiklenmesiyle ilgilidir, Dağıtım Betikleri'ni göz önünde bulundurun.
  • Yalnızca kalıcı kaynak yönetimine gerek kalmadan bir uç noktanın tetiklenmesiyle ilgilidir ve Bicep'i kullandığınızda Bicep Uzantıları'nı göz önünde bulundurun.
  • Çözümünüz için birkaç farklı uç nokta veya hizmet tetikleme içerir. Azure İşlevleri'ne göz önünde bulundurun.

Sorularınız varsa lütfen Microsoft hesap yöneticinizden adınız, şirketinizin adı, e-posta kişisi ve abonelik kimliğiniz ile e-posta curpdeprecation@microsoft.com göndermesini isteyin.

Azure Özel Kaynak Sağlayıcıları, Azure için genişletilebilirlik platformudur. Varsayılan Azure deneyimini zenginleştirmek için kullanılabilecek özel API'ler tanımlamanızı sağlar. Bu belgede aşağıdakiler açıklanmaktadır:

  • Azure Özel Kaynak Sağlayıcısı oluşturma ve dağıtma.
  • Mevcut iş akışlarını genişletmek için Azure Özel Kaynak Sağlayıcılarını kullanma.
  • Başlamak için kılavuzların ve kod örneklerinin nerede bulunacağı.

Azure Resource Manager, özel kaynak sağlayıcılar ve kaynaklar arasındaki ilişkiyi gösteren Azure Özel Kaynak Sağlayıcıları diyagramı.

Özel kaynak sağlayıcıları ne yapabilir?

Azure Özel Kaynak Sağlayıcıları ile neler başarabileceğinize dair bazı örnekler aşağıda verilmiştir:

  • Azure Resource Manager REST API'sini iç ve dış hizmetleri içerecek şekilde genişletin.
  • Mevcut Azure iş akışlarının üzerinde özel senaryoları etkinleştirin.
  • Azure Resource Manager Şablonları denetim ve etkisini özelleştirin.

Özel kaynak sağlayıcısı nedir?

Azure Özel Kaynak Sağlayıcıları, Azure ile uç nokta arasında bir sözleşme oluşturularak yapılır. Bu sözleşme, Microsoft.CustomProviders/resourceProviders adlı yeni bir kaynak aracılığıyla yeni kaynakların ve eylemlerin listesini tanımlar. Özel kaynak sağlayıcısı daha sonra bu yeni API'leri Azure'da kullanıma sunar. Azure Özel Kaynak Sağlayıcıları üç bölümden oluşur: özel kaynak sağlayıcısı, uç noktalar ve özel kaynaklar.

Özel kaynak sağlayıcıları oluşturma

Özel kaynak sağlayıcıları, Azure ile uç noktalar arasındaki sözleşmelerin listesidir. Bu sözleşmelerde Azure'ın uç noktalarıyla nasıl etkileşim kurması gerektiği açıklanmaktadır. Kaynak sağlayıcıları bir ara sunucu gibi davranır ve istekleri ve yanıtları belirtilen uç noktalarına iletir. Kaynak sağlayıcısı iki tür sözleşme belirtebilir: resourceTypes ve actions. Bunlar uç nokta tanımları aracılığıyla etkinleştirilir. Uç nokta tanımı üç alandan oluşur: name, routingType ve endpoint.

Örnek Uç Nokta:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}
Mülkiyet Gerekli Description
name evet Uç nokta tanımının adı. Azure bu adı '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ altındaki API aracılığıyla kullanıma sunar
resourceProviders/{resourceProviderName}/{endpointDefinitionName}'
yönlendirme Türü yok Uç nokta ile sözleşme türünü belirler. Belirtilmezse, varsayılan olarak "Proxy" olur.
endpoint evet İstekleri yönlendirecek uç nokta. Bu, yanıtın yanı sıra isteğin tüm yan etkilerini de işler.

Özel kaynaklar oluşturma

ResourceTypes, Azure'a eklenen yeni özel kaynakları açıklar. Bunlar temel RESTful CRUD yöntemlerini kullanıma sunar. Özel kaynak oluşturma hakkında daha fazla bilgi edinin

resourceTypes ile Örnek Özel Kaynak Sağlayıcısı:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

Yukarıdaki örnek için Azure'a eklenen API'ler:

HTTP Yöntemi Örnek URI Description
YERLEŞTİRMEK /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Yeni bir kaynak oluşturmak için Azure REST API çağrısı.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Mevcut bir kaynağı silmek için Azure REST API çağrısı.
almak /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Mevcut bir kaynağı almak için Azure REST API çağrısı.
almak /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources?api-version=2018-09-01-preview		 Mevcut kaynakların listesini almak için Azure REST API çağrısı.

Özel eylemler oluşturma

Eylemler , Azure'a eklenen yeni eylemleri açıklar. Bunlar kaynak sağlayıcısının en üstünde gösterilebilir veya resourceType altında iç içe yerleştirilebilir. Özel eylemler oluşturma hakkında daha fazla bilgi edinin

Özel Kaynak Sağlayıcısının eylemleri için örnek:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

Yukarıdaki örnek için Azure'a eklenen API'ler:

HTTP Yöntemi Örnek URI Description
PAYLAŞ /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction?api-version=2018-09-01-preview		 Eylemi etkinleştirmek için Azure REST API çağrısı.

Yardım aranıyor

Azure Özel Kaynak Sağlayıcısı geliştirmeyle ilgili sorularınız varsa Stack Overflow'da sormayı deneyin. Benzer bir soru zaten sorulmuş ve yanıtlanmış olabilir, bu nedenle paylaşmadan önce kontrol edin. Hızlı yanıt almak için etiketi azure-custom-providers ekleyin!

Sonraki Adımlar

Bu makalede, özel kaynak sağlayıcıları hakkında bilgi edindiniz. Özel kaynak sağlayıcısı oluşturmak için sonraki makaleye gidin.

  • Last updated on