Hızlı Başlangıç: ARM şablonu kullanarak API Management Azure API Management hizmeti örneği oluşturma

Bu hızlı başlangıçta, azure Azure Resource Manager (APIM) hizmet örneği oluşturmak için Azure Resource Manager şablonu (ARM şablonu) API Management açık bir şekilde anlatacağız. APIM, kuruluşların veri ve hizmetlerinin potansiyelini ortaya açmak için API'leri dış geliştiricilere, iş ortaklarına ve şirket iç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. APIM, herhangi bir yerde barındırılan mevcut arka uç hizmetleri için modern API ağ geçitleri oluşturmanıza ve yönetmenize olanak sağlar. Daha fazla bilgi için bkz. Genel Bakış.

ARM ş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. Bildirim temelli sözdiziminde, dağıtım oluşturmak için programlama komutlarının dizisini yazmadan amaçladığınız dağıtımı ifade edersiniz.

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.

Azure’a dağıtma

Ön koş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.4.1008.15138",
      "templateHash": "10451446506799526629"
    }
  },
  "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": [
        "Developer",
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "The pricing tier of this API Management service"
      }
    },
    "skuCount": {
      "type": "int",
      "defaultValue": 1,
      "allowedValues": [
        1,
        2
      ],
      "metadata": {
        "description": "The instance size of this API Management service."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "functions": [],
  "resources": [
    {
      "type": "Microsoft.ApiManagement/service",
      "apiVersion": "2020-12-01",
      "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ımlanmıştır:

Daha fazla Azure API Management şablon örneği, Azure Hızlı Başlangıç Şablonları içinde bulunabilir.

Şablonu dağıtma

  1. Aşağıdaki görüntüyü seçerek Azure'da oturum açıp bir şablon açın. Şablon, otomatik API Management bir hizmet örneği oluşturur.

    Azure’a dağıtın

    Bu örnekte örnek, Azure hizmet katmanını değerlendirmek için ekonomik bir seçenek olan Geliştirici katmanında API Management. Bu katman üretim kullanımına uygun değil. API Management katmanlarını ölçeklendirme hakkında daha fazla bilgi için bkz. yükseltme ve ölçeklendirme.

  2. Aşağıdaki değerleri seçin veya girin.

    • Abonelik: Bir Azure aboneliği seçin.
    • Kaynak grubu: Yeni oluştur'a tıklayın, 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.
    • Publisher: Bildirimleri almak için bir e-posta adresi girin.
    • Publisher: API yayımcısı için seçtiğiniz adı girin.
    • Sku: Geliştirici varsayılan değerini kabul eder.
    • Sku Sayısı: varsayılan değeri kabul eder.
    • Konum: Hizmet için oluşturulan API Management kabul edersiniz.

    API Management özelliklerini kullanma

  3. Gözden Geçir + Oluştur'a ve ardından hüküm ve koşulları gözden geçir'e seçin. Kabul ediyorsanız Oluştur'a seçin.

    İpucu

    Geliştirici katmanında bir API Management hizmetinin oluşturularak API Management 40 dakika kadar sürebilir.

  4. Örnek başarıyla oluşturulduktan sonra bir bildirim alırsınız:

    Dağıtım bildirimi

Şablonu dağıtmak için Azure portalı kullanılır. Uygulamanın yanı Azure portal, Azure CLI ve Azure PowerShell'leri de REST API. 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 Azure portal kontrol etmek için azure cli veya Azure PowerShell gibi araçları kullanarak dağıtılan kaynakları listele.

  1. Hizmet Azure portal,hizmetlerden API Management ve ardından oluşturduğunuz hizmet örneğini seçin.
  2. Genel Bakış sayfasında hizmetinizin özelliklerini gözden geçirme.

Hizmete genel bakış sayfası

Hizmet API Management örneğiniz çevrimiçi olduğunda kullanmaya hazır oluruz. İlk API'nizi içeri aktarma ve yayımlama öğreticisi ile çalışmaya başlama.

Kaynakları temizleme

Sonraki öğreticilerle çalışmaya devam etmek planlıyorsanız, API Management örneğinden ayrılmak iyi olabilir. Artık gerekli kalmadan kaynak grubunu silin. Bu kaynak grubu, kaynak grubu içinde bulunan kaynakları siler.

  1. Kaynak Azure portaliçin arama ve kaynak grupları'ı seçin. Giriş sayfasında Kaynak grupları'ı da seçin.

  2. Kaynak grupları sayfasında kaynak grubu seçin.

  3. Kaynak grubu sayfasında Kaynak grubunu sil'i seçin.

    Kaynak grubunu silme

  4. Kaynak grubu adının yazın ve Sil'i seçin.

Sonraki adımlar