Aracılığıyla paylaş

gRPC API'lerini içeri aktarma

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Standart | 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ükleyin.
  • gRPC hizmetinizin konumunu belirtin.
  • API Management'ta API'yi yapılandırın.

API Management, aşağıdaki gRPC hizmet yöntemleriyle aktarımı destekler: tekli, sunucu akışı, istemci akışı ve çift yönlü akış. gRPC hakkında daha fazla bilgi edinmek için bkz. gRPC'ye giriş.

Uyarı

  • gRPC API'leri, Ocak 2026'dan itibaren oluşturulan klasik katman örnekleri için (önizleme), kendi kendine barındırılan ağ geçidi ve yönetilen ağ geçidinde desteklenir. Bu tarihten önce oluşturulan klasik katman örneklerinde gRPC API desteğini etkinleştirmek için desteğe başvurun. gRPC API'leri şu anda v2 katmanlarında desteklenmemektedir.
  • Ş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 protobuf (.proto) dosyasıyla sınırlıdır.

Önkoşullar

gRPC API'sini ekleme

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

  2. Kenar çubuğu menüsündeKI API'ler'in altında API'ler'i 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 penceresindeTam'ı seçin.

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

    1. Lütfen bir görünen ad girin.

    2. Şemayı karşıya yükle için içeri aktarılacağınız API ile ilişkilendirilmiş yerel bir .proto dosyası seçin.

    3. gRPC sunucusu URL'si için gRPC hizmetinin adresini girin. Adrese HTTPS üzerinden erişilebilir olmalıdır.

    4. Ağ Geçitleri için API'yi kullanıma sunarken kullanmak istediğiniz ağ geçidi kaynağını seçin.

  6. API'nizi yapılandırmak için kalan ayarları girin. İlk API'nizi içeri aktarma ve yayımlama öğreticisinde bu ayarlar açıklanmaktadır.

  7. Oluştur'u belirleyin.

    Portal API'yi API listesine ekler. API'nin Ayarlar sekmesine giderek ayarlarınızı görüntüleyebilir ve güncelleştirebilirsiniz.

.NET kullanarak gRPC hizmetlerini çağırma

.NET kullanarak 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'ler dışında bir API oluşturabilirsiniz, örneğin:

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

Uyarı

Bir API'yi içeri aktardığınızda, işlemler geçerli API'nize eklenir.

Api'yi var olan bir API'ye eklemek için:

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

    API Management hizmetleri sayfasını gösteren ekran görüntüsü.

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

    Genel Bakış sayfasındaki API'lerin seçimini gösteren ekran görüntüsü.

  3. Eklemek istediğiniz başka bir API'nin yanındaki üç noktayı (...) seçin.

  4. Bağlam menüsünden İçeri Aktar'ı seçin:

    İçeri Aktar komutunu gösteren ekran görüntüsü.

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

İlgili içerik

  • Last updated on