Azure Özel Kaynak Sağlayıcılarına Genel Bakış
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ğı.
Ö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.