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 mendapatkan bantuan untuk membuat proxy sederhana, lihat Mem-build proxy pertama.)

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

Untuk menambahkan ekstensi ke proxy API:

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

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

2. Di panel Navigator, pilih PreFlow.

   

3. Di sudut kanan atas, klik tombol + Langkah untuk menambahkan kebijakan.

   

4. Pada dialog Add Step, pada daftar kebijakan di sebelah kiri, klik Extension Callout.

   

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

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

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

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

   

   Saat menambahkan ekstensi, Anda akan mendapatkan contoh XML kebijakan. Perhatikan bahwa contoh ini menyertakan 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 menjadi tujuan penulisan. Jika tidak ada, 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