gRPC API'lerini içeri aktarma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Premium

Bu makalede, API Management'ta bir gRPC hizmet tanımını API olarak içeri aktarma işlemi gösterilmektedir. Daha sonra API Management'ta API'yi yönetebilir, güvenli erişim sağlayabilir ve diğer ilkeleri uygulayabilir ve gRPC API isteklerini ağ geçidi üzerinden gRPC arka ucuna geçirebilirsiniz.

API Management'a gRPC API'sini eklemek için şunları yapmanız gerekir:

  • API'nin Protobuf (protokol arabelleği) tanım dosyasını API Management'a yükleme
  • gRPC hizmetinizin konumunu belirtin
  • API Management'ta API'yi yapılandırma

API Management, şu gRPC hizmet yöntemleriyle geçişi destekler: birli, sunucu akışı, istemci akışı ve çift yönlü akış. gRPC hakkında arka plan için bkz . gRPC'ye giriş.

Not

  • Şu anda gRPC API'leri yalnızca şirket içinde barındırılan ağ geçidinde desteklenir, API Management örneğiniz için yönetilen ağ geçidinde desteklenmez.
  • Şu anda gRPC API'lerinin test edilmesi Azure portalının test konsolunda veya API Management geliştirici portalında desteklenmiyor.
  • İçeri aktarma işlemi tek bir Protobuff (.proto) dosyasıyla sınırlıdır.

Önkoşullar

  • Api Management örneği. Henüz bir örneğiniz yoksa şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma.

  • Örneğinizde sağlanan bir ağ geçidi kaynağı. Henüz bir ağ geçidiniz yoksa bkz . Azure API Management'ta şirket içinde barındırılan ağ geçidi sağlama.

  • Yerel olarak kullanılabilen bir gRPC Protobuff (.proto) dosyası ve HTTPS üzerinden erişilebilen gRPC hizmeti.

gRPC API'sini ekleme

  1. Azure portalında API Management örneğine gidin.

  2. Sol menüde API'ler>+ API Ekle'yi seçin.

  3. Yeni API tanımla'nın altında gRPC'yi seçin.

    Portalda gRPC API oluşturma işleminin ekran görüntüsü.

  4. gRPC API'sini oluştur penceresinde Tam'ı seçin.

  5. gRPC API'sinde aşağıdaki ayarları belirtmeniz gerekir:

    1. Şemayı karşıya yükle bölümünde içeri aktaracak API ile ilişkilendirilmiş yerel bir .proto dosyası seçin.

    2. gRPC sunucusu URL'sinde gRPC hizmetinin adresini girin. Adrese HTTPS üzerinden erişilebilir olmalıdır.

    3. Ağ Geçitleri'nde, API'yi kullanıma açmak için kullanmak istediğiniz ağ geçidi kaynağını seçin.

      Önemli

      Genel önizlemede yalnızca şirket içinde barındırılan bir ağ geçidi seçebilirsiniz. Yönetilen ağ geçidi desteklenmez.

  6. API'nizi yapılandırmak için kalan ayarları girin. Bu ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

  7. Oluştur'u belirleyin.

    API, API listesine eklenir. API'nin Ayarlar sekmesine giderek ayarlarınızı güncelleştirmeyi görüntüleyebilirsiniz.

.NET ile gRPC hizmetlerini çağırma

.NET ile gRPC hizmetlerini çağırma hakkında bilgi için aşağıdaki makalelere bakın:

Diğer API'leri ekleme

Farklı hizmetler tarafından kullanıma sunulan API'lerden oluşan bir API oluşturabilirsiniz, örneğin:

  • OpenAPI belirtimi
  • SOAP API'si
  • GraphQL API'si
  • Azure Uygulaması Hizmetinde barındırılan bir Web Uygulaması
  • Azure İşlev Uygulaması
  • Azure Logic Apps
  • Azure Service Fabric

Aşağıdaki adımları kullanarak mevcut API'nize farklı bir API ekleyin.

Not

Başka bir API'yi içeri aktardığınızda işlemler geçerli API'nize eklenir.

  1. Azure portal'da Azure API Management kurulumunuza gidin.

    Azure API Mgmt örneğine gidin

  2. Genel Bakış sayfasında veya soldaki menüden API'ler'i seçin.

    Özel API'ler

  3. Başka bir API eklemek istediğiniz API'nin yanındaki ... simgesine tıklayın.

  4. Açılan menüden İçeri aktar'ı seçin.

    İçe aktar'ı seçin

  5. API'nin içeri aktarılacağı hizmeti seçin.

    Hizmet seç