gRPC API'lerini içeri aktarma

AŞAĞIDAKİLER İÇİN GEÇERLİDİR: 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ü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ı

• Ş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 protobuf (.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ıç kılavuzunu 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, Azure API Management'ta kendi kendine barındırılan bir ağ geçidi sağlama bölümüne bakın.

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

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.

   

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

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

   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.

      Önemli

      Genel önizlemede yalnızca özyönetimli 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:

• Öğretici: ASP.NET Core'da gRPC istemcisi ve sunucusu oluşturma
• .NET'te gRPC sorunlarını giderme

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:

   

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

   

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

4. Açılır menüden İçeri Aktar seçeneğini seçin.

   

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

İlgili içerik

• API içeri aktarma sınırlamaları
• OpenAPI belirtimini içeri aktarma
• SOAP API’sini içeri aktarma
• SOAP API'sini içeri aktarma ve REST dönüştürme
• App Service API'sini içeri aktarma
• Kapsayıcı uygulaması API'sini içeri aktarma
• WebSocket API'lerini içeri aktarma
• GraphQL API’sini içeri aktarma
• GraphQL şemasını içeri aktarma ve alan çözümleyicilerini ayarlama
• İşlev uygulaması API'sini içeri aktarma
• Mantıksal uygulama API'sini içeri aktarma
• Service Fabric hizmetlerini içeri aktarma
• Azure AI Foundry API'lerini içeri aktarma
• Azure OpenAI API'lerini içeri aktarma
• LLM API'lerini içeri aktarma
• OData API'sini içeri aktarma
• REST API'yi MCP sunucusu olarak dışarı aktarma
• Mevcut bir MCP sunucusunu kullanıma sunma
• A2A aracı API'lerini içeri aktarma
• SAP OData meta verilerini içeri aktarma
• gRPC API'lerini içeri aktarma
• API’yi düzenleme