Mengimpor API gRPC
BERLAKU UNTUK: Pengembang | Premi
Artikel ini menunjukkan cara mengimpor definisi layanan gRPC sebagai API di API Management. Anda kemudian dapat mengelola API di API Management, mengamankan akses dan menerapkan polisi lain, dan meneruskan permintaan API gRPC melalui gateway ke backend gRPC.
Untuk menambahkan API gRPC ke API Management, Anda perlu:
- Unggah file definisi Protobuf (buffer protokol) API ke API Management
- Tentukan lokasi layanan gRPC Anda
- Mengonfigurasi API di API Management
API Management mendukung pass-through dengan jenis metode layanan gRPC berikut: unary, streaming server, streaming klien, dan streaming dua arah. Untuk latar belakang tentang gRPC, lihat Pengantar gRPC.
Catatan
- Saat ini, API gRPC hanya didukung di gateway yang dihost sendiri, bukan gateway terkelola untuk instans API Management Anda.
- Saat ini, pengujian API gRPC tidak didukung di konsol pengujian portal Azure atau di portal pengembang API Management.
- Impor dibatasi untuk satu file Protobuff (.proto).
Prasyarat
Sebuah instans API Management. Jika Anda belum memilikinya, selesaikan mulai cepat berikut: Membuat instans Azure API Management.
Sumber daya gateway yang disediakan dalam instans Anda. Jika Anda belum memilikinya, lihat Memprovisikan gateway yang dihost sendiri di Azure API Management.
File gRPC Protobuff (.proto) tersedia secara lokal dan layanan gRPC yang dapat diakses melalui HTTPS.
Menambahkan API gRPC
Di Portal Microsoft Azure, navigasikan ke instans API Management Anda.
Di menu sebelah kiri, pilih API>+ Tambahkan API.
Di bawah Tentukan API baru, pilih gRPC.
Di jendela Buat API gRPC, pilih Penuh.
Untuk API gRPC, Anda harus menentukan pengaturan berikut:
Di Unggah skema, pilih file .proto lokal yang terkait dengan API untuk diimpor.
Di URL server gRPC, masukkan alamat layanan gRPC. Alamat harus dapat diakses melalui HTTPS.
Di Gateway, pilih sumber daya gateway yang ingin Anda gunakan untuk mengekspos API.
Penting
Di pratinjau publik, Anda hanya dapat memilih gateway yang dihost sendiri. Gateway terkelola tidak didukung.
Masukkan pengaturan yang tersisa untuk mengonfigurasi API Anda. Pengaturan ini dijelaskan dalam tutorial Impor dan terbitkan API pertama Anda.
Pilih Buat.
API ditambahkan ke daftar API . Anda dapat melihat pembaruan pengaturan Anda dengan masuk ke tab Pengaturan API.
Memanggil layanan gRPC dengan .NET
Untuk informasi tentang memanggil layanan gRPC dengan .NET, lihat artikel berikut ini:
Menambahkan API lainnya
Anda dapat membuat API dari API yang diekspos oleh berbagai layanan, termasuk:
- Spesifikasi OpenAPI
- API SOAP
- A GraphQL API
- Aplikasi Web yang dihosting di Azure App Service
- Azure Function App
- Azure Logic Apps
- Azure Service Fabric
Tambahkan API yang berbeda ke API yang ada menggunakan langkah-langkah berikut.
Catatan
Saat mengimpor API lain, operasi ditambahkan ke API Anda saat ini.
Buka instans API Management Azure Anda di portal Microsoft Azure.
Pilih API pada halaman Ringkasan atau dari menu di sebelah kiri.
Klik ... di samping API tempat Anda ingin menambahkan API lain.
Pilih Impor dari menu turun.
Pilih layanan untuk mengimpor API.
Topik terkait
- Batasan impor API
- Mengimpor spesifikasi OpenAPI
- Mengimpor API SOAP
- Mengimpor SOAP API dan mengonversi ke REST
- Impor API App Service
- Impor API Aplikasi Kontainer
- Mengimpor API WebSocket
- Mengimpor API GraphQL
- Mengimpor skema GraphQL dan menyiapkan penyelesai bidang
- Impor Aplikasi Fungsi Azure
- Impor Azure Logic App
- Impor layanan Service Fabric
- Mengimpor API Azure OpenAI
- Mengimpor API OData
- Mengimpor metadata SAP OData
- Mengimpor API gRPC
- Edit API