15.05.27 - Catatan rilis cloud Apigee Edge

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

Pada Selasa, 2 Juni 2015, kami merilis Apigee Edge versi cloud baru.

Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.

Untuk daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.

Fitur dan peningkatan baru

Berikut adalah fitur baru dan peningkatan dalam rilis ini.

Ketersediaan umum SmartDocs

SmartDocs lulus dari versi beta ke ketersediaan umum. Pembaruan dan fitur baru meliputi:

  • Dukungan untuk Swagger 2.0, termasuk impor menurut file atau URL, termasuk dukungan untuk objek keamanan bernama kustom.
  • Peningkatan desain visual pada template yang menghasilkan SmartDocs.
  • Peningkatan kegunaan dan alur kerja di Portal Developer, yang tersedia melalui menu Konten > SmartDocs di Drupal.
  • Yang sebelumnya dikenal sebagai autentikasi "Token Kustom" kini disebut "Kunci API".
  • Objek "keamanan" autentikasi yang ditentukan di tingkat revisi.
  • Konfigurasi autentikasi klien di tingkat template. Revisi baru tidak lagi mereset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.

Untuk deskripsi fitur selengkapnya, lihat postingan blog ini.

Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

Editor proxy API baru versi beta

Editor proxy API versi beta baru tersedia. Untuk mengakses, klik link "Akses Versi Beta" saat mengedit proxy API yang ada. Anda dapat beralih antara editor "klasik" dan "beta".

Kebijakan OAuthV2 baru

Kebijakan DeleteOAuthV2Info yang baru memungkinkan Anda menghapus kode otorisasi dan token akses. Untuk informasi selengkapnya, lihat Kebijakan penghapusan Info OAuthV2.

Entitas baru dalam kebijakan Access Entity

Kebijakan Entitas Akses memberikan akses ke entitas baru berikut: cakupan consumerkey, authorizationcode, requesttoken, dan verifier. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Entitas Akses.

Menampilkan sertifikat SSL yang mendekati masa berlakunya

Halaman Sertifikat SSL di UI pengelolaan (Admin > Sertifikat SSL) menunjukkan kapan sertifikat SSL akan berakhir dalam waktu 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di kolom drop-down masa berlaku baru.

Nama aplikasi developer yang ditampilkan di UI pengelolaan

Aplikasi developer di Edge memiliki Nama internal yang tidak berubah dan Nama Tampilan yang dapat Anda ubah. Di halaman Aplikasi Developer di UI pengelolaan (Publikasi > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi ditampilkan bersama dengan "Nama Tampilan", sehingga memudahkan identifikasi aplikasi secara visual berdasarkan nama internalnya untuk pemecahan masalah dan pengelolaan API.

Laporan kustom versi klasik dihapus dari UI pengelolaan

Laporan analisis kustom versi klasik opsional tidak lagi tersedia di UI pengelolaan.


Proses upgrade SmartDocs

Jika Anda sudah menggunakan SmartDocs selama periode beta, fitur dan kemampuan baru dalam versi ketersediaan umum mengharuskan Anda mengupgrade SmartDocs di portal developer.

Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan terus berfungsi, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau memublikasikan perubahan apa pun pada halaman yang ada atau baru.

Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dibuat dari model API yang ada dalam Layanan Pengelolaan API Tepi Apigee. Setiap perubahan yang Anda buat pada model API di Edge akan sama di semua lingkungan Pantheon (mirip dengan cara developer berada di seluruh lingkungan Pantheon).

Untuk mengupgrade dari SmartDocs versi beta ke versi yang tersedia secara umum

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test di Pantheon.
  2. Buat model baru untuk menggantikan model API yang ada yang telah Anda gunakan.
    • Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi ke revisi baru.
    • Jika Anda telah mengelola model API melalui modul SmartDocs, ekspor sebagai JSON SmartDocs dan impor ke model baru menggunakan lampiran file.
  3. Tetapkan properti keamanan revisi model Anda. Di halaman Konten > SmartDocs > model, pilih Setelan Keamanan.
  4. Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Konten > SmartDocs) dengan mengklik Setelan di kolom Operasi.
  5. Perbarui template kustom apa pun untuk menggunakan aset CSS dan JS v6, dan buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk informasi tentang cara memperbarui template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Render ulang dan publikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal produksi Anda ke rilis 15.05.27.

Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah terkait proses upgrade, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Jika tidak, gunakan Komunitas Apigee untuk mendapatkan respons terbaik.

Bug yang diperbaiki

Bug berikut diperbaiki dalam rilis ini.

ID Masalah Deskripsi
TBD-72 Masalah kebijakan logging pesan
MGMT-2124 Izin peran pelanggan direset saat menyimpan izin di UI
MGMT-2048 Pengguna dengan peran khusus yang membatasi izin deployment ke satu lingkungan dapat melakukan deployment di lingkungan lain
MGMT-2041 Menghapus elemen FaultRules dari template lampiran default
Elemen FaultRules, yang tidak digunakan dalam kebijakan atau langkah proxy API, tidak lagi ditambahkan secara otomatis saat Anda membuat proxy API atau menambahkan kebijakan.
MGMT-2034 Pengambilan WSDL menampilkan kegagalan: "Error Pengambilan WSDL: Error pemrosesan WSDL".
MGMT-1812 Menambahkan validasi TargetEndpoint selama impor
Serupa dengan ProxyEndpoint, TargetEndpoint akan divalidasi untuk skema dan ekspresi yang tepat yang digunakan dalam kondisi selama impor proxy API.
MGMT-1345 Impor WSDL dengan beberapa namespace menghasilkan Langkah Build SOAP yang salah
MGMT-800 Membuat resource dengan nama 'default' akan menyebabkan UI rusak
MGMT-602 Tampilan Pengembangan API Proxy: Menambahkan kebijakan Cache Respons saat endpoint tidak memiliki PreFlow/PostFlow yang menyebabkan error
MGMT-460 Mengganti nama kebijakan menyebabkan perilaku error, kebijakan duplikat yang tidak dapat dihapus
DEVRT-1565 Interval 15 menit untuk PENGISIAN DAYA
AXAPP-1728 Mengabaikan variabel monetisasi di Analytics
AXAPP-1690 "Error API Tidak Valid" pada laporan kustom
AXAPP-1533 Geomap Analytics menampilkan error Panggilan API Tidak Valid
APIRT-52 Laporan Kustom: Kode status respons untuk banyak API bernilai null