Bagikan melalui

Mengimpor API gRPC

BERLAKU UNTUK: Pengembang | Premium

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

  • 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 protobuf (.proto).

Prasyarat

Menambahkan API gRPC

  1. Di Portal Microsoft Azure, navigasikan ke 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, Anda harus menentukan 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.

      Penting

      Di pratinjau publik, Anda hanya dapat memilih gateway yang dihost sendiri. Gateway terkelola tidak didukung.

  6. Masukkan pengaturan yang tersisa untuk mengonfigurasi API Anda. Pengaturan ini dijelaskan dalam tutorial Impor dan terbitkan API pertama Anda.

  7. 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 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 drop-down:

    Cuplikan layar yang memperlihatkan perintah Impor.

  5. Pilih layanan untuk mengimpor API.

Konten terkait

  • Last updated on