15.05.27 - Catatan rilis cloud Apigee Edge

Anda sedang melihat dokumentasi Apigee Edge.
Lihat dokumentasi Apigee X.

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

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. Update dan fitur baru meliputi:

  • Dukungan untuk Swagger 2.0, termasuk impor berdasarkan file atau URL, termasuk dukungan untuk objek keamanan bernama kustom.
  • Peningkatan desain visual di template yang menghasilkan SmartDocs.
  • Peningkatan kegunaan dan alur kerja di Portal Developer, tersedia di menu > menu 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.

Untuk deskripsi fitur selengkapnya, lihat postingan blog ini.

Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

Editor proxy API baru versi beta

Editor beta API versi baru telah tersedia. Untuk mengakses, klik link "Access the Beta Version" saat mengedit proxy API yang sudah ada. Anda dapat beralih antara editor "klasik" dan "beta".

Kebijakan OAuthV2 baru

Kebijakan DeleteOAuthV2Info baru memungkinkan Anda menghapus kode otorisasi dan token akses. Untuk mengetahui informasi selengkapnya, lihat Menghapus kebijakan Info OAuthV2.

Entitas baru dalam kebijakan Entitas Akses

Kebijakan Entitas Akses menyediakan akses ke entitas baru berikut: cakupan konsumen, kode otorisasi, requesttoken, dan pemverifikasi. Untuk informasi selengkapnya, lihat kebijakan Entitas Akses.

Menampilkan sertifikat SSL yang hampir habis masa berlakunya

Halaman Sertifikat SSL di UI pengelolaan (Admin > Sertifikat SSL) menunjukkan kapan masa berlaku sertifikat SSL berakhir dalam waktu 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di kolom drop-down akhir masa berlaku yang 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. Pada halaman Developer App di UI pengelolaan (Publikasikan > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi ditampilkan bersama dengan "Nama Tampilan", sehingga mempermudah identifikasi aplikasi menurut nama internalnya untuk pemecahan masalah dan pengelolaan API.

Laporan klasik versi klasik dihapus dari UI pengelolaan

Laporan Analytics kustom versi klasik yang bersifat opsional tidak lagi tersedia di UI pengelolaan.


Proses upgrade SmartDocs

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

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

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

Untuk melakukan upgrade dari SmartDocs versi beta ke ketersediaan umum

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test Anda di Pantheon.
  2. Buat model baru untuk mengganti model API yang ada yang telah Anda gunakan.
    • Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi dokumen tersebut ke dalam revisi baru.
    • Jika Anda telah mempertahankan model API melalui modul SmartDocs, ekspor sebagai SmartDocs JSON dan impor ke model baru menggunakan lampiran file.
  3. Tetapkan properti keamanan dari 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. Update template kustom agar menggunakan aset CSS dan JS v6, serta buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Merender ulang dan memublikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal produksi ke rilis 15.05.27.

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

Bug telah diperbaiki

Bug berikut telah 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 langkah-langkah kebijakan atau proxy API, tidak lagi otomatis ditambahkan saat Anda membuat proxy API atau menambahkan kebijakan.
MGMT-2034 Pengambilan pengembalian WSDL gagal: "Ambil Kesalahan WSDL: Kesalahan 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 Proxy API: Tambahkan kebijakan Cache Respons saat endpoint tidak memiliki error PreFlow/PostFlow yang menyebabkan error
MGMT-460 Mengganti nama kebijakan menghasilkan perilaku glitch, kebijakan duplikat yang tidak dapat dihapus
DEVRT-1565 Interval 15 menit untuk CHARGE
AXAPP-1728 Abaikan variabel monetisasi di Analytics
AXAPP-1690 "Error API Tidak Valid" pada laporan kustom
AXAPP-1533 Peta geografis Analytics menampilkan error Panggilan API Tidak Valid
APIRT-52 Laporan Kustom: Kode status respons untuk banyak API adalah null