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 aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
Önkoşullar
Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.
CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.
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. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.
İ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.
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'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.
Kaynak grubu oluşturma
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, bildirim almak için API yayımcısının kuruluş adını ve 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.
İpucu
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 ve durumu gösterir Activating
:
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ı temizleme
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