Bagikan melalui

Mengimpor API gRPC

BERLAKU UNTUK: Pengembang | Dasar | Standar | 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 kebijakan 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.
  • Konfigurasikan 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 mempelajari selengkapnya tentang gRPC, lihat Pengantar gRPC.

Catatan

  • API gRPC didukung di gateway yang dihost sendiri dan di gateway terkelola untuk instans tingkat klasik yang dibuat mulai Januari 2026 (pratinjau). Hubungi dukungan untuk mengaktifkan dukungan API gRPC dalam instans tingkat klasik yang dibuat sebelum tanggal ini. API gRPC saat ini tidak didukung di tingkat v2.
  • Saat ini, pengujian API gRPC tidak didukung di konsol pengujian portal Azure atau di portal pengembang API Management.
  • Impor dibatasi untuk satu file protobuf (.proto).

Prasyarat

Menambahkan API gRPC

  1. Di portal Microsoft Azure, buka instans API Management Anda.

  2. Di bawah API di menu bilah samping, pilih API.

  3. Di bawah Tentukan API baru, pilih gRPC.

    Cuplikan layar pembuatan API gRPC di portal.

  4. Di jendela Buat API gRPC, pilih Penuh.

  5. Untuk API gRPC, tentukan pengaturan berikut:

    1. Masukkan nama tampilan.

    2. Untuk Unggah skema, pilih file .proto lokal yang terkait dengan API yang akan diimpor.

    3. Untuk URL server gRPC, masukkan alamat layanan gRPC. Alamat harus dapat diakses melalui HTTPS.

    4. Untuk Gateway, pilih sumber daya gateway yang ingin Anda gunakan untuk mengekspos API.

  6. Masukkan pengaturan yang tersisa untuk mengonfigurasi API Anda. Tutorial Impor dan terbitkan API pertama Anda menjelaskan pengaturan ini.

  7. Pilih Buat.

    Portal menambahkan API ke daftar API . Anda dapat melihat dan memperbarui pengaturan Anda dengan masuk ke tab Pengaturan API.

Memanggil layanan gRPC dengan menggunakan .NET

Untuk informasi tentang memanggil layanan gRPC dengan menggunakan .NET, lihat artikel berikut ini:

Menambahkan API lainnya

Anda dapat menyusun API dari API yang diekspos oleh layanan yang berbeda, termasuk:

  • Spesifikasi OpenAPI
  • API SOAP
  • Sebuah GraphQL API
  • Aplikasi Web yang dihosting di Azure App Service
  • Azure Functions
  • Azure Logic Apps
  • Azure Service Fabric

Catatan

Saat Anda mengimpor API, operasi ditambahkan ke API Anda saat ini.

Untuk menambahkan API ke API yang ada:

  1. Buka instans Azure API Management Anda di portal Microsoft Azure:

    Cuplikan layar yang memperlihatkan halaman layanan API Management.

  2. Pilih API di halaman Gambaran Umum atau pilih API >API di menu di sebelah kiri.

    Cuplikan layar yang memperlihatkan pilihan API di halaman Gambaran Umum.

  3. Pilih elipsis (...) di samping API yang ingin Anda tambahkan API lain.

  4. Pilih Impor dari menu konteks:

    Cuplikan layar yang memperlihatkan perintah Impor.

  5. Pilih layanan untuk mengimpor API.

Konten terkait

  • Last updated on