Langkah 3: Gunakan kebijakan ExtensionCallout

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Saat mengembangkan proxy API, Anda dapat menambahkan dukungan untuk ekstensi dengan menambahkan kebijakan ExtensionCallout ke proxy. (Jika Anda ingin bantuan dalam membuat proxy sederhana, lihat Membangun proxy pertama Anda.)

Saat menambahkan dukungan untuk ekstensi, Anda mengaitkan kebijakan ExtensionCallout dengan ekstensi yang dikonfigurasi. Setelan konfigurasi ekstensi tersebut menentukan cara ekstensi berinteraksi dengan resource backend yang terhubung dengannya. Ekstensi yang dikonfigurasi secara khusus inilah yang diintegrasikan kebijakan ExtensionCallout ke dalam proxy API.

Untuk menambahkan ekstensi ke proxy API:

1. Buka proxy API Anda di konsol Apigee Edge, di tampilan Develop.

   Meskipun Anda harus menjadi administrator organisasi untuk membuat ekstensi, peran pengguna mana pun dapat menambahkan ekstensi ke proxy API.

2. Di panel Navigator, pilih PreFlow.

   

3. Di pojok kanan atas, klik tombol + Step untuk menambahkan kebijakan.

   

4. Dalam dialog Add Step, di daftar kebijakan di sisi kiri, klik Extension Callout.

   

   Jika Anda tidak melihat kebijakan ExtensionCallout dalam daftar, pastikan Anda menggunakan UI Edge baru. Selain itu, Apigee Extensions saat ini hanya tersedia untuk pelanggan Apigee Edge Cloud Enterprise.

5. Di panel kanan, pilih opsi untuk mengonfigurasi kebijakan:

   Kolom	Deskripsi
   Display Name	Masukkan nama tampilan kebijakan.
   Nama	Masukkan nama yang akan digunakan untuk kebijakan secara terprogram. Nama ini harus unik di proxy.
   Ekstensi	Pilih ekstensi yang akan digunakan. Ini adalah ekstensi yang Anda konfigurasi sebelumnya.
   Tindakan	Pilih tindakan "log".

6. Klik Tambahkan.
7. Dalam tampilan alur, klik kebijakan untuk melihat XML konfigurasinya.

   

   Saat menambahkan ekstensi, Anda akan mendapatkan contoh XML kebijakan. Perhatikan bahwa file ini mencakup skema yang menjelaskan cara menyusun konfigurasi untuk elemen <Input>. (Anda dapat mengabaikan skema elemen <Output> -- tidak ada isi respons yang ditampilkan oleh tindakan "log" ekstensi.)

8. Edit XML kebijakan Anda agar terlihat seperti berikut:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
     <DisplayName>Logging Extension</DisplayName>
     <Connector>my-logging-extension</Connector>
     <Action>log</Action>
     <Input>{
       "logName": "example-log",
       "metadata": {
         "resource": {
           "type": "global",
           "labels": {
             "project_id": "my-gcp-project"
           }
         }
       },
       "message": "This is a test"
     }</Input>
   </ConnectorCallout><!--
   Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
   -->
   <!--
   Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
   -->

   Di sini, <Input> menentukan hal berikut:

   • logName adalah nama log yang akan ditulis. Jika tidak ada, direktori ini akan dibuat oleh ekstensi.
   • metadata menentukan informasi yang dapat Anda gunakan untuk menjelajahi log di konsol Stackdriver.
   • message hanyalah pesan log yang ingin Anda tulis.
9. Klik tombol Simpan.

Langkah berikutnya

Langkah 1 Langkah 2 Langkah 3 Langkah 4: Deploy proxy Langkah 5