Hızlı Başlangıç: ARM şablonu kullanarak yeni bir Azure API Management hizmet örneği oluşturma
UYGULANANLAR: Tüm API Management katmanları
Bu hızlı başlangıçta, Azure API Management örneği oluşturmak için Azure Resource Manager şablonunun (ARM şablonu) nasıl kullanılacağı açıklanmaktadır. API Management örneğinizdeki API'leri içeri aktarma gibi yaygın yönetim görevleri için ARM şablonlarını da kullanabilirsiniz.
Azure API Management , kuruluşların veri ve hizmetlerinin potansiyelini ortaya çıkarmaları için API'leri dış, iş ortağı ve iç geliştiricilere yayımlamalarına yardımcı olur. API Management; geliştirici katılımı, iş öngörüleri, analizler, güvenlik ve koruma aracılığıyla başarılı bir API programı yürütmeye ilişkin temel uzmanlıklar sağlar. API Management ile her yerde barındırılan mevcut arka uç hizmetleri için modern API ağ geçitleri oluşturun ve yönetin.
Azure Resource Manager şablonu, projenizin altyapısını ve yapılandırmasını tanımlayan bir JavaScript Nesne Gösterimi (JSON) dosyasıdır. Bu şablonda, bildirim temelli sözdizimi kullanılır. Dağıtımı oluşturmak için programlama komutlarının sırasını yazmadan hedeflenen dağıtımınızı açıklarsınız.
Ortamınız önkoşulları karşılıyorsa ve ARM şablonlarını kullanma hakkında bilginiz varsa, Azure’a dağıtma düğmesini seçin. Şablon Azure portalda açılır.
Önkoşullar
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Şablonu gözden geçirme
Bu hızlı başlangıçta kullanılan şablon Azure Hızlı Başlangıç Şablonlarından alınmıştır.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"metadata": {
"_generator": {
"name": "bicep",
"version": "0.26.54.24096",
"templateHash": "15176578550391235821"
}
},
"parameters": {
"apiManagementServiceName": {
"type": "string",
"defaultValue": "[format('apiservice{0}', uniqueString(resourceGroup().id))]",
"metadata": {
"description": "The name of the API Management service instance"
}
},
"publisherEmail": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "The email address of the owner of the service"
}
},
"publisherName": {
"type": "string",
"minLength": 1,
"metadata": {
"description": "The name of the owner of the service"
}
},
"sku": {
"type": "string",
"defaultValue": "Developer",
"allowedValues": [
"Consumption",
"Developer",
"Basic",
"Basicv2",
"Standard",
"Standardv2",
"Premium"
],
"metadata": {
"description": "The pricing tier of this API Management service"
}
},
"skuCount": {
"type": "int",
"defaultValue": 1,
"allowedValues": [
0,
1,
2
],
"metadata": {
"description": "The instance size of this API Management service."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Location for all resources."
}
}
},
"resources": [
{
"type": "Microsoft.ApiManagement/service",
"apiVersion": "2023-05-01-preview",
"name": "[parameters('apiManagementServiceName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('sku')]",
"capacity": "[parameters('skuCount')]"
},
"properties": {
"publisherEmail": "[parameters('publisherEmail')]",
"publisherName": "[parameters('publisherName')]"
}
}
]
}
Şablonda aşağıdaki kaynak tanımlanır:
Daha fazla Azure API Management şablon örneği Azure Hızlı Başlangıç Şablonları'nda bulunabilir.
Şablonu dağıtma
Aşağıdaki görüntüyü seçerek Azure'da oturum açıp bir şablon açın. Şablon, otomatik olarak oluşturulan bir ada sahip bir API Management hizmet örneği oluşturur.
Bu örnekte örnek, Azure API Management'ı değerlendirmek için ekonomik bir seçenek olan Geliştirici katmanında yapılandırılır. Bu katman üretim kullanımı için değildir. API Management katmanlarını ölçeklendirme hakkında daha fazla bilgi için bkz. yükseltme ve ölçeklendirme.
Aşağıdaki değerleri seçin veya girin.
- Abonelik: Bir Azure aboneliği seçin.
- Kaynak grubu: Yeni oluştur'u seçin, kaynak grubu için benzersiz bir ad girin ve tamam'ı seçin.
- Bölge: Kaynak grubu için bir konum seçin. Örnek: Orta ABD.
- Yayımcı E-postası: Bildirimleri almak için bir e-posta adresi girin.
- Yayımcı Adı: API yayımcısı için seçtiğiniz bir ad girin.
- Sku: Geliştirici'nin varsayılan değerini kabul edin. Alternatif olarak, başka bir değer seçin.
- Sku Sayısı: varsayılan değeri kabul edin.
- Konum: API Management hizmeti için oluşturulan konumu kabul edin.
Gözden Geçir + Oluştur'u seçin, ardından hüküm ve koşulları gözden geçirin. Kabul ediyorsanız Oluştur'u seçin.
İpucu
Geliştirici katmanında API Management hizmetinin oluşturulması ve etkinleştirilmesi 30 ila 40 dakika arasında sürebilir. Süreler katmana göre değişir.
Örnek başarıyla oluşturulduktan sonra bir bildirim alırsınız:
Şablonu dağıtmak için Azure portalı kullanılır. Azure portalına ek olarak Azure PowerShell, Azure CLI ve REST API'sini de kullanabilirsiniz. Diğer dağıtım yöntemlerini öğrenmek için bkz . Şablonları dağıtma.
Dağıtılan kaynakları gözden geçirme
Dağıtılan kaynakları denetlemek için Azure portalını kullanın veya dağıtılan kaynakları listelemek için Azure CLI veya Azure PowerShell gibi araçları kullanın.
- Azure portalında API Management hizmetlerini arayıp seçin ve oluşturduğunuz hizmet örneğini seçin.
- Genel Bakış sayfasında hizmetinizin özelliklerini gözden geçirin.
API Management hizmet örneğiniz çevrimiçi olduğunda kullanmaya hazır olursunuz. İlk API'nizi içeri aktarma ve yayımlama öğreticisiyle başlayın.
Kaynakları temizleme
Sonraki öğreticilerle çalışmaya devam etmek istiyorsanız API Management örneğini yerinde bırakmak isteyebilirsiniz. Artık gerekli olmadığında kaynak grubunu silin; bu da kaynak grubundaki kaynakları siler.
Azure portalında Kaynak grupları'nı arayın ve seçin. Giriş sayfasında Kaynak grupları'nıda seçebilirsiniz.
Kaynak grupları sayfasında kaynak grubunuzu seçin.
Kaynak grubu sayfasında Kaynak grubunu sil'i seçin.
Kaynak grubunuzun adını yazın ve Sil'i seçin.