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

ŞUNLAR IÇIN GEÇERLIDIR: Tüketim | Geliştirici | Temel | Standart | Premium

Bu hızlı başlangıçta, Azure CLI komutlarını kullanarak yeni bir API Management örneği oluşturma adımları açıklanmaktadır. Örnek oluşturduktan sonra, API Management örneğinizdeki API'leri içeri aktarma gibi yaygın yönetim görevleri için Azure CLI'yi 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 hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.

Önkoşullar

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz. Azure Cloud Shell'i kullanmaya başlama.

  

• CLI referans komutlarını yerel olarak çalıştırmayı tercih ediyorsanız, Azure CLI'yi yükleyin. Windows veya macOS üzerinde çalışıyorsanız, Azure CLI'yi bir Docker konteynerinde çalıştırmayı düşünün. Daha fazla bilgi için Azure CLI'nin bir Docker konteynerında nasıl çalıştırılacağını inceleyin.

  • Yerel bir kurulum kullanıyorsanız, az login komutunu kullanarak Azure CLI'ye giriş yapın. Kimlik doğrulama işlemini tamamlamak için, terminalinizde görüntülenen adımları takip edin. Diğer oturum açma seçenekleri için bkz. Azure CLI kullanarak Azure'da kimlik doğrulaması.

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

  • Yüklü olan sürümü ve bağımlı kütüphaneleri 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'nın 2.11.1 veya sonraki bir sürümünü gerektirir. Azure Cloud Shell kullanılıyorsa en son sürüm zaten yüklüdür.

Bir kaynak grubu oluşturun

Tüm Azure kaynakları gibi Azure API Management örneklerinin de bir kaynak grubuna dağıtılması gerekir. Kaynak grupları, ilgili Azure kaynaklarını düzenlemenize ve yönetmenize olanak sağlar.

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

az group create --name myResourceGroup --location centralus

API Management örneği oluşturma

Artık bir kaynak grubunuz olduğuna göre, bir API Management örneği oluşturabilirsiniz. az apim create komutunu kullanarak bir tane oluşturun ve bir hizmet adı ve yayımcı ayrıntıları sağlayın. Hizmet adı Azure içinde 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ısının kuruluş adını güncelleştirin 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 Azure API Management'ı değerlendirmek için ekonomik bir seçenek olan Geliştirici katmanında oluşturur. 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.

Tavsiye

Bu katmanda API Management hizmetinin oluşturulması ve etkinleştirilmesi 30 ile 40 dakika arasında sürebilir. Önceki komut, hizmet oluşturulurken komutun hemen döndürülmesi için seçeneğini kullanır --no-wait .

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

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

Başlangıçta, çıkış aşağıdakine benzer şekilde olup Activating durumunu 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 şudur Online ve hizmet örneğinin bir ağ geçidi adresi ve genel IP adresi vardır. Şimdilik bu adresler hiçbir içeriği kullanıma sunmaz. Örneğin:

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

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ı temizle

Gerekli olmadığında kaynak grubunu ve API Management hizmet örneğini kaldırmak için az group delete komutunu kullanabilirsiniz.

az group delete --name myResourceGroup

Sonraki Adımlar

İlk API’nizi içeri aktarma ve yayımlama