4.16.09 - Catatan rilis Edge untuk Private Cloud

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

Pada Senin, 19 September 2016, kami merilis versi baru Apigee Edge untuk Private Cloud.

Sejak Rilis Fitur Edge untuk Private Cloud sebelumnya, rilis berikut telah terjadi dan disertakan dalam Rilis Fitur ini:

• Cloud: 16.04.13 (UI), 16.04.13 (monetisasi), 16.04.20 (UI), 16.04.27 (monetisasi), 16.04.27 (UI), 16.05.04 (UI), 16.05.11 (UI), 16.05.11 (monetisasi), 16.05.18 (UI), 16.05.25 (monetisasi), 16.06.08 (monetisasi), 16.06.15 (UI), 16.06.22 (monetisasi), 16.06.29 (UI), 16.07.06 (monetisasi), 16.07.06.02 (monetisasi), 16.07.13 (UI), 16.07.20.01 (monetisasi), 16.07.27 (UI), 16.08.17

Lihat Tentang penomoran rilis untuk memahami cara mengetahui apakah rilis cloud tertentu disertakan dalam versi Edge untuk Private Cloud Anda.

Ringkasan rilis

Dalam rilis ini, editor proxy API klasik telah dihapus dan digantikan oleh editor proxy baru yang tersedia untuk digunakan bersama editor klasik. Peningkatan penting lainnya mencakup peningkatan perilaku jalur resource produk API, peningkatan penanganan payload JSON yang ditentukan dalam kebijakan Tetapkan Pesan dan Timbulkan Kesalahan, peningkatan konversi XML ke JSON, peningkatan validasi resource, kemampuan untuk menetapkan waktu tunggu pada setiap proxy API, pembaruan pembuatan proxy SOAP di wizard proxy API, dan objek Kripto berperforma tinggi untuk JavaScript.

Peningkatan monetisasi mencakup fitur notifikasi baru dengan paket tarif notifikasi, API yang memigrasikan developer ke monetisasi, dan kemampuan untuk membuat paket tarif publik atau pribadi.

Bagian selanjutnya dari topik ini berisi detail tentang semua fitur baru, update, dan perbaikan bug yang ada dalam rilis.

Tidak digunakan lagi

Layanan API

Editor Proxy Klasik dihapus (UI Cloud 16.04.20)

Versi baru Editor Proxy API kini menjadi satu-satunya versi yang didukung. Versi klasik tidak lagi tersedia, dan link ke "Akses Editor Proxy Versi Klasik" telah dihapus. Jika Anda menggunakan versi klasik, proxy API Anda akan otomatis dimuat di editor baru. (EDGEUI-498)

Monetisasi

Fitur usang berikut telah dihapus dan tidak lagi didukung:

• Menetapkan batasan
• Mengirim notifikasi batas

Sebagai alternatif, Anda dapat menyiapkan notifikasi, seperti yang dijelaskan di bagian berikut:

• Menyiapkan notifikasi acara
• Membuat notifikasi batas untuk paket tarif

(DEVRT-2742)

Fitur dan info terbaru

Berikut adalah fitur dan peningkatan baru dalam rilis ini. Selain peningkatan berikut, rilis ini juga berisi beberapa peningkatan kegunaan, performa, keamanan, dan stabilitas.

Untuk mengetahui detail dan petunjuk lebih lanjut, lihat dokumentasi Edge for Private Cloud.

Cloud Pribadi

Upgrade Postres ke versi 9.4

Rilis ini mencakup upgrade ke Postgres 9.4. Untuk mengetahui petunjuk tentang cara mengupdate sistem Anda, lihat Mengupdate Apigee Edge ke 4.16.09.

Dukungan GeoMap di UI Edge

Agregasi geografis memungkinkan Anda mengumpulkan data analisis untuk panggilan API berdasarkan atribut geografis seperti wilayah, benua, negara, dan kota. Dari data analisis ini, Anda dapat melihat GeoMap di UI Edge yang menunjukkan lokasi permintaan API.

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Agregasi Geografis dan Peta Geografis.

API BaaS

Menambahkan dokumentasi tentang:

• Cara mengonfigurasi API BaaS untuk menggunakan TLS. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi TLS untuk API BaaS.
• Cara mengonfigurasi semua node API BaaS Stack untuk menggunakan penyimpanan bersama sehingga semua aset tersedia untuk semua node API BaaS Stack. Untuk mengetahui informasi selengkapnya, lihat Mengupload aset.
• Cara mengenkripsi sandi Cassandra saat mengonfigurasi node BaaS Stack. Untuk mengetahui informasi selengkapnya, lihat Mereset Sandi Edge.

Rilis beta Alat dan Dasbor Pemantauan

Rilis ini mencakup versi Beta alat dan dasbor pemantauan baru untuk Edge. Alat ini memungkinkan Anda memahami kondisi berbagai komponen (Router, Pemroses Pesan, ZooKeeper, Cassandra) serta kode error http untuk berbagai organisasi dan lingkungan dalam deployment Anda. Anda juga dapat mengambil snapshot data dasbor dan membagikannya kepada Apigee untuk membantu menyelesaikan insiden dukungan.

Dokumentasi, termasuk petunjuk penginstalan, disertakan dengan dokumen Edge 4.16.09 di Versi 4.18.01.

Namun, sebelum Anda dapat menginstal dan menggunakan dasbor, Anda harus menyelesaikan Perjanjian Evaluasi Apigee, yang juga tersedia di Versi 4.18.01, dan mengirimkannya kembali ke Apigee dengan mengirimkannya melalui email ke orders@apigee.com.

Rilis beta alat pengumpul analisis

Semua pelanggan Edge untuk Private Cloud diwajibkan mengirimkan statistik tentang traffic proxy API ke Apigee. Apigee merekomendasikan agar pelanggan mengupload informasi tersebut sekali sehari, mungkin dengan membuat cron job.

Untuk membantu mengupload data ini, Apigee menyediakan utilitas command line apigee-analytics-collector versi Beta. Utilitas ini mengirimkan laporan volume panggilan API kembali ke Apigee. Setiap penginstalan Edge untuk Private Cloud dapat menggunakan utilitas ini untuk mengambil dan melaporkan data traffic ke Apigee.

Untuk mengetahui informasi selengkapnya, lihat Mengupload Data Traffic API ke Apigee - Rilis Beta.

Layanan API

Payload JSON dalam Assign Message dan Raise Fault (Cloud 16.08.17)

Dengan peningkatan ini, tidak ada solusi yang diperlukan untuk memastikan pemformatan pesan JSON yang tepat, dan variabel dapat ditentukan menggunakan tanda kurung kurawal tanpa membuat JSON yang tidak valid. Misalnya, berikut menyisipkan nilai message.content dalam pesan JSON:

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

Jika Anda menggunakan solusi sementara, kode Anda akan terus berfungsi seperti apa adanya. Anda juga dapat menggunakan variablePrefix dan variableSuffix, bukan kurung kurawal, untuk menunjukkan variabel.

Lihat elemen <Set><Payload> dalam kebijakan Assign Message dan kebijakan Raise Fault di dokumen referensi. (APIRT-1160)

Peningkatan kebijakan XML ke JSON (Cloud 16.08.17)

Kebijakan XML ke JSON telah ditingkatkan dengan kemampuan berikut. Anda dapat mengonfigurasi kebijakan untuk:

• Perlakukan beberapa elemen XML sebagai array selama konversi, yang menempatkan nilai dalam tanda kurung siku '[ ]' dalam dokumen JSON.
• Menghapus atau menghilangkan tingkat hierarki dokumen XML dalam dokumen JSON akhir.

Untuk mengetahui informasi selengkapnya, lihat Kebijakan XML ke JSON. (APIRT-1144)

Beberapa karakter pengganti di jalur resource Produk API (Cloud 16.08.17)

Saat menentukan jalur resource di Produk API, Anda dapat menyertakan karakter pengganti di beberapa tempat dalam jalur resource. Misalnya, /team/*/invoices/** mengizinkan panggilan API dengan satu nilai setelah /team dan jalur resource apa pun setelah invoices/. URI yang diizinkan pada panggilan API adalah proxyBasePath/team/finance/invoices/company/a.

Jika setelah rilis ini jalur resource Produk API yang ada berhenti berfungsi seperti yang diharapkan, tetapkan properti berikut di organisasi Anda untuk kembali ke perilaku sebelumnya: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Fungsi kripto di JavaScript (Cloud 16.08.17)

Serangkaian fungsi JavaScript crypto berperforma tinggi yang baru tersedia untuk membuat, mendapatkan, dan memperbarui objek hash berikut: MD5, SHA-1, SHA256, SHA512. Objek crypto juga memungkinkan Anda mendapatkan tanggal dalam berbagai format. Untuk mengetahui informasi selengkapnya, lihat Model objek JavaScript. (APIRT-2886)

Pemeriksaan versi JAR Panggilan Java (Cloud 16.08.17)

Saat mengupload resource JAR Java ke proxy API, kode status HTTP 400 akan ditampilkan (bukan 500) jika versi resource Java tidak kompatibel dengan versi Java yang didukung Edge, yang tercantum dalam Software yang didukung dan versi yang didukung. (MGMT-3420)

Validasi resource proxy API (Cloud 16.08.17)

Jika Anda memiliki file resource proxy API (seperti JAR JavaScript atau Java) yang disimpan di cakupan lingkungan atau organisasi, framework validasi tidak lagi mengharuskan Anda untuk menyertakan resource tersebut di tingkat proxy API dalam paket proxy agar impor lulus validasi. Validasi resource kini terjadi pada waktu deployment, bukan pada waktu impor. (MGMT-1430)

Mengonfigurasi waktu tunggu untuk setiap proxy API (Cloud 16.08.17)

Anda dapat mengonfigurasi proxy API agar waktu tunggu habis setelah waktu tertentu (dengan status waktu tunggu gateway 504). Kasus penggunaan utamanya adalah untuk pelanggan Private Cloud yang memiliki proxy API yang memerlukan waktu lebih lama untuk dieksekusi. Misalnya, Anda memerlukan proxy tertentu agar waktu tunggu habis dalam 3 menit. Anda dapat menggunakan properti api.timeout baru dalam konfigurasi untuk proxy API. Berikut cara melakukannya dengan contoh 3 menit:

1. Pertama, pastikan untuk mengonfigurasi load balancer, router, dan pemroses pesan agar waktu tunggu habis setelah 3 menit.
2. Kemudian, konfigurasikan proxy yang relevan agar waktu tunggu habis dalam 3 menit. Tentukan nilai dalam milidetik. Contoh:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Namun, perhatikan bahwa menaikkan waktu tunggu sistem dapat menyebabkan masalah performa, karena semua proxy tanpa setelan api.timeout menggunakan load balancer, router, dan waktu tunggu pemroses pesan yang baru dan lebih tinggi. Jadi, konfigurasi proxy API lain yang tidak memerlukan waktu tunggu yang lebih lama untuk menggunakan waktu tunggu yang lebih rendah. Misalnya, berikut ini menetapkan waktu tunggu proxy API setelah 1 menit:
   <Property name="api.timeout">60000</Property>

Pelanggan Cloud, yang tidak dapat mengubah waktu tunggu Edge, juga dapat mengonfigurasi waktu tunggu proxy API, selama waktu tunggu lebih singkat daripada waktu tunggu pemroses pesan Edge standar, yaitu 57 detik.

Anda tidak dapat mengisi nilai dengan variabel. Properti ini dibahas dalam referensi Properti endpoint. (APIRT-1778)

Perilaku proxy SOAP saat menggunakan wizard proxy (UI Cloud 16.07.27)

Saat membuat proxy berbasis SOAP dari WSDL menggunakan wizard proxy, ada dua opsi untuk pembuatan proxy:

• Pass-Through SOAP, tempat proxy meneruskan payload permintaan SOAP apa adanya.
• REST ke SOAP ke REST, di mana proxy mengonversi payload masuk seperti JSON ke payload SOAP, lalu mengonversi respons SOAP kembali ke format yang diharapkan pemanggil.

Rilis ini mencakup update berikut terkait cara kerja opsi ini. Perbedaan antara perilaku lama dan baru ada dalam kebijakan dan konfigurasi yang dibuat secara otomatis oleh wizard proxy.

SOAP Terusan

• Semua operasi WSDL kini dikirim ke jalur dasar proxy "/" dan bukan ke resource proxy (seperti "/cityforecastbyzip"). Nama operasi diteruskan ke layanan SOAP target. Perilaku ini sesuai dengan spesifikasi SOAP.

• Proxy yang dihasilkan tidak lagi mendukung JSON dalam permintaan. Hanya mendukung XML. Proxy memastikan permintaan SOAP memiliki Envelope, Body, dan namespace.

REST ke SOAP ke REST

• WSDL 2.0 tidak didukung.
• Perilaku baru belum diuji dengan WS-Policy.
• Proxy memungkinkan Anda mengirim data JSON, bukan FormParams.
• Saat menambahkan dukungan CORS (Cross-origin resource sharing) ke proxy menggunakan pembuat proxy, Anda akan melihat peningkatan berikut:
  • Header Access-Control-Allow-Headers: Selain header Origin, x-requested-with, dan Accept, header Access-Control-Allow-Headers juga menyertakan Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent, dan Cache-Control.
  • Header Access-Control-Allow-Methods: Selain GET, PUT, POST, DELETE, header ini juga mencakup kata kerja PATCH dan OPTIONS.
• Saat membuat proxy API untuk WSDL, Edge membaca ComplexType yang ditentukan sebagai abstrak dalam WSDL dan mengenali dengan benar jenis instance yang didasarkan pada jenis abstrak.

Utilitas command line open source wsdl2apigee

Apigee juga menyediakan utilitas command line open source untuk membuat proxy API rest-to-soap atau passthrough dari WSDL. Lihat https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Default masa berlaku/pengambilan ulang dalam kebijakan Operasi Peta Nilai Kunci (UI Cloud 16.06.15)

Kebijakan Operasi Peta Nilai Kunci memungkinkan Anda menentukan durasi nilai dipertahankan sebelum diperbarui. Interval pembaruan ditetapkan dengan elemen <ExpiryTimeInSecs>. Jika operasi GET dijalankan dan interval masa berlaku telah terlampaui, nilai akan diperbarui dan kebijakan akan mendapatkan nilai yang diperbarui. Saat Anda menambahkan kebijakan ini ke proxy API, waktu habis masa berlaku default kini adalah 300 detik. (Default sebelumnya adalah -1, yang berarti nilai tidak pernah diperbarui.) (EDGEUI-579)

Monetisasi

Paket tarif notifikasi yang dapat disesuaikan (UI Cloud 16.04.20, monetisasi Cloud 16.04.13)

Paket tarif notifikasi baru yang dapat disesuaikan dalam monetisasi Edge memungkinkan penyedia API menyesuaikan target jumlah transaksi untuk setiap developer aplikasi. Anda dapat mengonfigurasi apakah dan kapan notifikasi dikirim berdasarkan persentase jumlah target yang telah tercapai, seperti 90%, 100%, atau 150%. Fitur ini tersedia melalui UI pengelolaan selain Management API (yang tersedia dalam rilis sebelumnya). Untuk mengetahui informasi selengkapnya, lihat Menentukan detail paket notifikasi yang dapat disesuaikan. (DEVRT-2375, DEVRT-2370)

Notifikasi webhook untuk paket tarif notifikasi yang dapat disesuaikan (monetisasi Cloud 16.04.27)

Untuk paket tarif notifikasi yang dapat disesuaikan, Anda dapat membuat webhook yang mengirim notifikasi ke URL yang Anda tentukan. Anda juga dapat mengontrol notifikasi agar muncul pada interval tertentu (persentase) hingga batas transaksi tercapai. Notifikasi webhook memberi Anda alternatif yang fleksibel untuk menggunakan template notifikasi yang ada. Lihat Menyiapkan notifikasi menggunakan webhook. (DEVRT-2393, DEVRT-2394)

Paket tarif Notifikasi yang Dapat Disesuaikan dengan Atribut Kustom (UI Cloud 16.05.18)

Dalam monetisasi Edge, paket tarif "Pemberitahuan yang Dapat Disesuaikan dengan Atribut Kustom" yang baru memungkinkan Anda menambahkan jumlah transaksi developer menggunakan nilai atribut kustom. Dengan paket tarif Notifikasi yang Dapat Disesuaikan standar, setiap panggilan API yang berhasil akan menambahkan 1 ke jumlah transaksi developer. Namun, dengan paket tarif Pemberitahuan yang Dapat Disesuaikan dengan Atribut Kustom, nilai atribut kustom ditambahkan ke jumlah transaksi developer. Misalnya, jika atribut kustom "small" memiliki nilai 0,1 dalam respons, jumlah transaksi akan bertambah 0,1; atau jika atribut kustom "addressTotal" memiliki nilai 50, jumlah akan bertambah 50. Untuk mengetahui informasi selengkapnya, lihat Menentukan paket tarif dengan detail atribut kustom. (DEVRT-2504)

Menyiapkan notifikasi berdasarkan total transaksi gabungan untuk perusahaan dan developernya (Monetisasi Cloud 16.06.22)

Biasanya, total transaksi dilacak untuk semua developer di perusahaan secara otomatis saat developer menggunakan aplikasi perusahaan untuk mengakses API. Bagaimana jika Anda memiliki developer yang secara aktif menggunakan aplikasi developer mereka sendiri untuk mengakses API, dan Anda perlu melacak total transaksi gabungan mereka tanpa gangguan traffic? Anda dapat menambahkan developer ke perusahaan dan menyiapkan notifikasi yang akan dikirim saat batas tercapai berdasarkan total transaksi gabungan untuk perusahaan dan developernya. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan notifikasi berdasarkan total transaksi gabungan untuk perusahaan dan developernya. (DEVRT-2643)

Melihat dan memproses ulang notifikasi (Monetisasi Cloud 16.06.08)

Sebagai bagian dari rangkaian pengujian monetisasi, Anda dapat melihat dan memproses ulang notifikasi yang sebelumnya dikirim menggunakan Management API. Untuk mengetahui informasi selengkapnya, lihat Melihat dan memproses ulang notifikasi. (DEVRT-2643)

Test Monetization (Cloud 16.05.25 monetization)

Monetisasi menyediakan serangkaian API yang dapat Anda gunakan untuk menguji eksekusi webhook guna memastikan notifikasi dikirim. Untuk mengetahui detailnya, lihat Menguji penyiapan notifikasi. (DEVRT-2625)

Memigrasikan developer ke monetisasi (Monetisasi Cloud 16.05.11)

API baru tersedia untuk memfasilitasi migrasi developer ke monetisasi. Anda dapat mentransfer penggunaan transaksi dan mengenakan biaya penyiapan yang disesuaikan dan biaya berulang. Selain itu, saat menyetujui paket tarif yang dipublikasikan, Anda dapat membatalkan biaya penyiapan jika biaya tersebut telah ditagih. Untuk mengetahui informasi selengkapnya, lihat Memigrasikan developer ke monetisasi. (DEVRT-2446)

Paket tarif Publik dan Pribadi untuk portal developer (Monetisasi Cloud 16.04.27)

Anda dapat menyetel paket tarif menjadi "Publik" atau "Pribadi". Paket tarif publik muncul di portal developer; Paket tarif pribadi tidak muncul. Default untuk paket tarif adalah Publik. Untuk mengetahui informasi selengkapnya, lihat http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Membatalkan penangguhan developer (Monetisasi Cloud 16.06.08)

Monetisasi menyediakan serangkaian API yang dapat Anda gunakan untuk mengaktifkan kembali developer yang sebelumnya ditangguhkan. Developer dapat ditangguhkan jika batas yang dikonfigurasi tercapai. Misalnya, jumlah transaksi telah mencapai batas maksimum atau saldo akun prabayar telah habis. Untuk mengetahui informasi selengkapnya, lihat Membatalkan penangguhan developer. (DEVRT-2641)

Melihat status transaksi (Monetisasi Cloud 16.06.08)

Sebagai bagian dari rangkaian pengujian monetisasi, Anda dapat melihat status transaksi yang telah terjadi selama rentang waktu tertentu menggunakan API pengelolaan. Untuk mengetahui informasi selengkapnya, lihat Melihat status transaksi. (DEVRT-2640)

Menyertakan atribut kustom developer dalam laporan pendapatan (Monetisasi Cloud 16.05.25)

Khusus untuk laporan pendapatan, Anda dapat menyertakan atribut kustom dalam laporan, jika atribut kustom ditentukan untuk developer. Untuk mengetahui informasi selengkapnya, lihat Menyertakan atribut khusus developer dalam laporan pendapatan menggunakan API. (DEVRT-2447)

Kebijakan Perekaman Transaksi dan konsistensi resource produk API (UI Cloud 16.05.18)

Jika jalur resource dalam Kebijakan Perekaman Transaksi monetisasi tidak cocok dengan jalur resource yang ditentukan dalam produk API-nya (misalnya, jika Anda mengubah jalur resource produk API), ikon Kebijakan Perekaman Transaksi di halaman Produk akan menampilkan simbol peringatan. Saat Anda mengklik ikon untuk melihat Kebijakan Perekaman Transaksi, peringatan akan muncul di bagian atas halaman. Jika Anda memperbaiki jalur resource di Kebijakan Perekaman Transaksi, indikator peringatan akan hilang. (DEVRT-2240)

Bug yang diperbaiki

Bug berikut telah diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang memeriksa apakah tiket dukungan mereka telah diselesaikan. Fitur ini tidak dirancang untuk memberikan informasi mendetail bagi semua pengguna.

Edge untuk Private Cloud

16.08.17

16.07.27 (UI)

16.07.20.01 (monetisasi)

Rilis ini mencakup perubahan skema DB kecil. Tidak ada update software lain dalam rilis ini.

16.07.13 (UI)

16.07.06.02 (monetisasi)

16.07.06 (monetisasi)

16.06.29 (UI)

16.06.22 (monetisasi)

Tidak ada

16.06.15 (UI)

16.06.08 (monetisasi)

Tidak ada

16.05.25 (monetisasi)

16.05.18 (UI)

16.05.11 (monetisasi)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (monetisasi)

Tidak ada

16.04.20 (UI)

16.04.13 (monetisasi)

Tidak ada

16.04.13 (UI)

Masalah Umum

Rilis ini memiliki masalah umum berikut: