15.05.27 - Catatan rilis cloud Apigee Edge

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

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

Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.

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

Fitur dan peningkatan baru

Berikut adalah sejumlah fitur dan peningkatan baru dalam rilis ini.

Ketersediaan umum SmartDocs

SmartDocs dirilis dari versi beta ke ketersediaan umum. Update dan fitur baru meliputi:

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

Untuk deskripsi fitur lainnya, 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 telah 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 mengetahui informasi selengkapnya, lihat Menghapus kebijakan Info OAuthV2.

Entity baru dalam kebijakan Access Entity

Kebijakan Access Entity memberikan akses ke entity baru berikut: Consumerkey-scopes, authorizationcode, requesttoken, dan verifier. Untuk mengetahui informasi selengkapnya, lihat kebijakan Akses Entitas.

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 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di kolom drop-down 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 Aplikasi Developer di UI pengelolaan (Publikasikan > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi akan ditampilkan bersama dengan "Nama Tampilan", sehingga memudahkan identifikasi aplikasi secara visual berdasarkan nama internalnya untuk pemecahan masalah dan pengelolaan API.

Versi klasik laporan kustom yang dihapus dari UI pengelolaan

Versi klasik opsional dari laporan analisis kustom 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 dalam portal developer.

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

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

Untuk mengupgrade dari SmartDocs beta ke ketersediaan 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 mempertahankan 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 (Content > SmartDocs) dengan mengklik Settings di kolom Operations.
  5. Update template kustom apa pun agar menggunakan aset CSS dan JS v6, lalu buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk mengetahui informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Render ulang dan publikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal production Anda ke rilis 15.05.27.

Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah tentang proses upgrade, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Atau, 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 di-deploy di lingkungan lain
MGMT-2041 Hapus elemen FaultRules dari template lampiran default
Elemen FaultRules, yang tidak digunakan dalam kebijakan atau langkah proxy API, tidak lagi otomatis ditambahkan saat Anda membuat proxy API atau menambahkan kebijakan.
MGMT-2034 Pengambilan WSDL menampilkan kegagalan: "Pengambilan Error WSDL: Error memproses WSDL".
MGMT-1812 Tambahkan 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' menyebabkan UI tidak berfungsi
MGMT-602 Tampilan Pengembangan Proxy API: Menambahkan kebijakan Cache Respons jika endpoint tidak memiliki PreFlow/PostFlow yang menyebabkan error
MGMT-460 Penggantian nama kebijakan akan menghasilkan perilaku gangguan, kebijakan duplikat yang tidak dapat dihapus
DEVRT-1565 Interval 15 menit untuk CHARGES
AXAPP-1728 Mengabaikan variabel monetisasi di Analytics
AXAPP-1690 "Error API tidak valid" pada laporan kustom
AXAPP-1533 Peta Geo Analytics menampilkan error Panggilan API Tidak Valid
APIRT-52 Laporan Kustom: Kode status respons untuk banyak API adalah null