Hızlı Başlangıç: Azure CLI'API Management yeni bir Azure API Management örneği oluşturma

Azure API Management (APIM), kuruluşların kendi veri ve hizmet potansiyellerini ortaya çıkarmak üzere 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. 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ış.

Bu hızlı başlangıçta, Azure CLI'da az apim komutlarını API Management yeni bir örnek oluşturma adımları açık bir şekilde anlatılacaktır.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

  • Azure Cloud Shell'Da Bash ortamını kullanın.

    Cloud Shell’i yeni bir pencerede başlatma

  • Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

  • Bu makale, Azure CLI'nin 2.11.1 veya sonraki bir sürümünü gerektirir. Bu Azure Cloud Shell, en son sürüm zaten yüklüdür.

Kaynak grubu oluşturma

Azure API Management tüm Azure kaynakları gibi sanal ağ örneklerinin bir kaynak grubuna dağıtılması gerekir. Kaynak grupları, ilgili Azure kaynaklarını düzenlemenizi ve yönetmenizi sağlar.

İlk olarak, aşağıdaki az group create komutuyla Orta ABD myResourceGroup adlı bir kaynak grubu oluşturun:

az group create --name myResourceGroup --location centralus

Yeni hizmet oluşturma

Artık bir kaynak grubunuz olduğu için bir hizmet API Management oluşturabilirsiniz. az apim create komutunu kullanarak bir tane oluşturun ve bir hizmet adı ve yayımcı ayrıntıları girin. Hizmet adı Azure'da benzersiz olmalıdır.

Aşağıdaki örnekte hizmet adı için myapim kullanılmıştır. Adı benzersiz bir değere güncelleştirin. Ayrıca API yayımcı kuruluş adını ve bildirim almak için e-posta adresini güncelleştirin.

az apim create --name myapim --resource-group myResourceGroup \
  --publisher-name Contoso --publisher-email admin@contoso.com \
  --no-wait

Varsayılan olarak, komutu Örneği Geliştirici katmanında oluşturur ve Azure hizmet katmanını değerlendirmek için ekonomik 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.

İpucu

Bu katmanda bir hizmet oluşturmak ve etkinleştirmek 30 ila 40 API Management kadar sürebilir. Önceki komut, hizmet --no-wait oluşturulurken komutun hemen geri döndüren seçeneğini kullanır.

az apim show komutunu çalıştırarak dağıtımın durumunu kontrol edin:

az apim show --name myapim --resource-group myResourceGroup --output table

Başlangıçta, çıktı aşağıdakine benzer ve durumu Activating gösterir:

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR    PUBLIC IP    PRIVATE IP    STATUS      TIER       UNITS
-----------  ----------------  ----------  --------------  -----------  ------------  ----------  ---------  -------
myapim       myResourceGroup   Central US                                             Activating  Developer  1

Etkinleştirmeden sonra durum şu Online şekildedir ve hizmet örneğinin bir ağ geçidi adresi ve genel IP adresi vardır. Şimdilik bu adresler herhangi bir içeriği açığa çıkarmaz. Örnek:

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR                       PUBLIC IP     PRIVATE IP    STATUS    TIER       UNITS
-----------  ----------------  ----------  ---------------------------------  ------------  ------------  --------  ---------  -------
myapim       myResourceGroup   Central US  https://myapim.azure-api.net       203.0.113.1                 Online    Developer  1

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

Artık gerekli değilken az group delete komutunu kullanarak kaynak grubunu ve hizmet API Management kaldırabilirsiniz.

az group delete --name myResourceGroup

Sonraki adımlar