4.16.09 - Catatan rilis Edge untuk Private Cloud

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

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

Sejak Rilis Fitur Edge for 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 rilis penomoran untuk memahami cara mengetahui apakah rilis cloud tertentu disertakan dalam versi Edge Anda untuk Private Cloud.

Ringkasan rilis

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

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

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

Tidak digunakan lagi

Layanan API

Editor Proxy Klasik dihapus (UI Cloud 16.04.20)

Versi baru Editor Proxy API sekarang menjadi satu-satunya versi yang didukung. Versi klasik tidak tersedia lagi, 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 yang tidak digunakan lagi berikut ini telah dihapus dan tidak lagi didukung:

• Menyetel batas
• Notifikasi batas pengiriman

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

• Menyiapkan peristiwa notifikasi
• Buat notifikasi pembatasan untuk paket tarif

(DEVRT-2742)

Fitur dan info terbaru

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

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

Cloud Pribadi

Upgrade Postres ke versi 9.4

Rilis ini mencakup upgrade ke Postgres 9.4. Untuk mendapatkan petunjuk tentang cara memperbarui sistem, lihat Mengupdate Apigee Edge untuk 4.16.09.

Dukungan GeoMap di UI Edge

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

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

BaaS API

Menambahkan dokumentasi tentang:

• Cara mengonfigurasi API BaaS agar menggunakan TLS. Untuk 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 bagian Mengupload aset.
• Cara mengenkripsi sandi Cassandra saat mengonfigurasi node BaaS Stack. Untuk selengkapnya informasi selengkapnya, lihat Mereset Edge Sandi.

Rilis beta Alat dan Dasbor Pemantauan

Rilis ini mencakup versi Beta dari dasbor dan alat 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 di deployment. Anda juga dapat mengambil ringkasan data dasbor dan membagikannya ke Apigee untuk membantu menyelesaikan insiden dukungan.

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

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

Rilis beta alat kolektor analisis

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

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

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

Layanan API

Payload JSON di Menetapkan Pesan dan Meningkatkan Kesalahan (Cloud 16.08.17)

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

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

Jika Anda menggunakan solusi, kode Anda akan terus berfungsi sebagaimana mestinya. Anda juga dapat menggunakan variabelPrefix dan variabelSuffix, bukan tanda kurung kurawal, untuk menunjukkan variabel.

Lihat <Set><Payload> dalam kebijakan Tetapkan Pesan dan Kebijakan Raise Fault dokumen referensi. (APIRT-1160)

Peningkatan kebijakan XML ke JSON (Cloud 16.08.17)

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

• Perlakukan beberapa elemen XML sebagai array selama konversi, yang menempatkan nilai dalam persegi tanda kurung '[ ]' dalam dokumen JSON.
• Hapus atau hilangkan level hierarki dokumen XML di dokumen JSON akhir.

Untuk informasi selengkapnya, lihat XML ke kebijakan 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 resource Anda. Misalnya, /team/*/invoices/** mengizinkan panggilan API dengan semua satu nilai setelah /team dan jalur resource mana pun setelah invoices/. URI yang diizinkan pada panggilan API akan menjadi 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 properti sebelumnya perilaku: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Fungsi kripto dalam JavaScript (Cloud 16.08.17)

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

Pemeriksaan versi JAR Info Java (Cloud 16.08.17)

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

Validasi resource proxy API (Cloud 16.08.17)

Bila Anda memiliki file sumber daya proxy API (seperti JavaScript atau Java JAR) yang disimpan di lingkungan atau organisasi, kerangka kerja validasi tidak lagi mengharuskan Anda menyertakan sumber daya tersebut pada level proxy API dalam paket proxy agar impor dapat lulus validasi. Validasi resource kini dilakukan 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 habis setelah waktu yang ditentukan (dengan waktu tunggu gateway 504 habis status). Kasus penggunaan utamanya adalah untuk pelanggan Private Cloud yang memiliki proxy API yang menggunakan lebih lama untuk dijalankan. Misalnya, Anda memerlukan proxy tertentu untuk waktu tunggu 3 menit. Anda dapat gunakan properti api.timeout baru dalam konfigurasi untuk proxy API. Berikut caranya Anda akan melakukannya dengan contoh 3 menit:

1. Pertama, pastikan untuk mengonfigurasi load balancer, router, dan pemroses pesan agar kehabisan waktu setelah 3 menit.
2. Kemudian, konfigurasi proxy yang relevan agar waktu tunggu habis pada 3 menit. Tentukan nilai di 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 baru yang lebih tinggi, {i>router<i}, dan batas waktu prosesor pesan. Jadi, konfigurasikan proxy API lain yang tidak memerlukan waktu tunggu yang lebih lama untuk menggunakan waktu tunggu yang lebih rendah. Misalnya, perintah berikut menetapkan proxy API ke waktu tunggu setelah 1 menit:
   <Property name="api.timeout">60000</Property>

Pelanggan cloud, yang tidak dapat mengubah waktu tunggu Edge, juga dapat mengonfigurasi asalkan waktu tunggu lebih singkat dari waktu tunggu prosesor pesan Edge standar 57 detik.

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

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

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

• Pass-through SOAP, yaitu proxy hanya meneruskan permintaan SOAP {i>payload<i} apa adanya.
• REST ke SOAP ke REST, tempat proxy mengonversi payload yang masuk seperti JSON menjadi payload SOAP, lalu mengonversi respons SOAP kembali ke format pemanggil yang diharapkan.

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

SOAP Pass-through

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

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

REST ke SOAP ke REST

• WSDL 2.0 tidak didukung.
• Perilaku baru belum diuji dengan Kebijakan WS.
• Proxy memungkinkan Anda melakukan POST data JSON, bukan FormParams.
• Saat Anda menambahkan dukungan CORS (Cross-origin resource sharing) ke proxy menggunakan 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 mencakup 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 ComplexTypes apa pun yang ditentukan sebagai abstrak di WSDL dan mengenali dengan benar setiap jenis instance yang didasarkan pada jenis datanya.

Utilitas command line open source wsdl2apigee

Apigee juga menyediakan utilitas command line open source untuk menghasilkan passthrough atau {i>rest-to-soap API <i}dari WSDL. Lihat https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Berakhirnya/pembaruan default dalam kebijakan Operasi Peta Nilai Kunci (Cloud 16.06.15 UI)

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

Monetisasi

Rencana rasio notifikasi yang dapat disesuaikan (UI Cloud 16.04.20, monetisasi Cloud 16.04.13)

Paket kecepatan notifikasi baru yang dapat disesuaikan di 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 API pengelolaan (yang tersedia dalam rilis sebelumnya). Untuk informasi selengkapnya, lihat Menentukan detail paket notifikasi yang dapat disesuaikan. (DEVRT-2375, DEVRT-2370)

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

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 terjadi pada interval tertentu (persentase) hingga batas transaksi tercapai. Notifikasi webhook memberi Anda pengalaman alternatif untuk menggunakan template notifikasi yang ada. Lihat Menyiapkan notifikasi menggunakan webhook. (DEVRT-2393, DEVRT-2394)

Notifikasi yang Dapat Disesuaikan dengan paket tarif Atribut Khusus (Cloud 16.05.18 UI)

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

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

Biasanya, total transaksi dilacak untuk semua pengembang di perusahaan secara otomatis ketika pengembang menggunakan aplikasi perusahaan untuk mengakses API. Bagaimana jika Anda memiliki developer yang menggunakan aplikasi developernya sendiri untuk mengakses API, dan Anda perlu melacak transaksi gabungannya total tanpa ada gangguan lalu lintas? Anda dapat menambahkan pengembang ke perusahaan dan menyiapkan notifikasi yang akan dikirim saat nilai minimum tercapai yang didasarkan pada transaksi gabungan total untuk perusahaan dan para pengembangnya. Untuk informasi selengkapnya, lihat Menyetel 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 API pengelolaan. Untuk informasi selengkapnya, lihat Melihat dan memproses ulang notifikasi. (DEVRT-2643)

Uji Monetisasi (monetisasi Cloud 16.05.25)

Monetisasi menyediakan kumpulan API yang dapat Anda gunakan untuk menguji eksekusi webhook agar memastikan notifikasi dikirim. Untuk mengetahui detailnya, lihat Penyiapan notifikasi pengujian. (DEVRT-2625)

Memigrasikan developer ke monetisasi (monetisasi Cloud 16.05.11)

API baru tersedia untuk memfasilitasi migrasi developer ke monetisasi. Anda dapat transfer penggunaan transaksi dan tagih biaya berulang dan penyiapan yang disesuaikan. Selain itu, ketika menyetujui paket tarif yang dipublikasikan, Anda dapat mengabaikan biaya penyiapan jika telah dikenakan biaya. Untuk informasi selengkapnya, lihat Memigrasikan developer ke monetisasi. (DEVRT-2446)

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

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

Developer yang tidak ditangguhkan (monetisasi Cloud 16.06.08)

Monetisasi menyediakan serangkaian API yang dapat Anda gunakan untuk membatalkan penangguhan developer yang ditangguhkan sebelumnya. Developer mungkin ditangguhkan jika batas yang dikonfigurasi tercapai. Sebagai contoh, jumlah transaksi telah mencapai batas maksimum atau saldo akun prabayar telah habis. Untuk mengetahui informasinya, 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 memiliki terjadi selama rentang waktu tertentu menggunakan API pengelolaan. Untuk informasi selengkapnya, lihat Melihat status transaksi. (DEVRT-2640)

Menyertakan atribut khusus developer dalam laporan pendapatan (monetisasi Cloud 16.05.25)

Hanya untuk laporan pendapatan, Anda dapat menyertakan atribut khusus di laporan, jika ditentukan untuk pengembang. Untuk informasi selengkapnya, lihat Menyertakan opsi developer kustom di laporan pendapatan menggunakan API. (DEVRT-2447)

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

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

Bug diperbaiki

Bug berikut telah diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang ingin memeriksa jika tiket dukungan telah diperbaiki. Ini tidak dirancang untuk memberikan informasi terperinci tentang 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 data.

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: