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

Makale
07/20/2023

Azure Özel Kaynak Sağlayıcıları, Azure'a yönelik bir 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örüntüleyen Azure Özel Kaynak Sağlayıcıları diyagramı.

Ö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ı.

Ö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ı denetimini 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ç noktalara 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}/"
}

Özellik	Gerekli	Açıklama
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}'
routingType	No	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 kaynaklar 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:

HttpMethod	Örnek URI	Açıklama
PUT	/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ı.
GET	/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ı.
GET	/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 üzerinde kullanıma sunulur veya resourceType altında iç içe yerleştirilebilir. Özel eylemler oluşturma hakkında daha fazla bilgi edinin

Eylemlerle örnek Özel Kaynak Sağlayıcısı:

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

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

HttpMethod	Örnek URI	Açıklama
POST	/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 arama

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 göndermeden önce kontrol edin. Hızlı yanıt almak için etiketini azure-custom-providers ekleyin!

Sonraki adımlar

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

Aracılığıyla paylaş