Perubahan yang melanggar ruang kerja, bagian 2 (Maret 2025)
BERLAKU UNTUK: Premium
Penting
Perubahan yang melanggar ini hanya berlaku untuk pratinjau ruang kerja di Azure API Management. Jika Anda membuat ruang kerja setelah rilis yang tersedia secara umum pada Agustus 2024 dan menggunakan ruang kerja dengan gateway ruang kerja, ruang kerja Anda tidak boleh terpengaruh oleh perubahan ini.
Ruang kerja Azure API Management sekarang tersedia secara umum, dan kami memperkenalkan beberapa pembaruan fitur dengan rilis tersebut. Sebagai bagian dari pengembangan ruang kerja yang berkelanjutan, kami menghapus dukungan untuk ruang kerja pratinjau (dibuat sebelum Agustus 2024). Jika Anda membuat ruang kerja pratinjau di Azure API Management dan ingin terus menggunakannya, Anda perlu memigrasikan ruang kerja Anda ke versi yang tersedia secara umum.
Setelah 31 Maret 2025, ruang kerja pratinjau dan API yang dikelola di dalamnya mungkin berhenti berfungsi jika Anda belum bermigrasi ke kemampuan ruang kerja terbaru. API dan sumber daya yang dikelola di luar ruang kerja tidak terpengaruh oleh perubahan ini.
Apakah layanan saya terpengaruh oleh perubahan ini?
Layanan Anda mungkin terpengaruh oleh perubahan ini jika Anda membuat ruang kerja pratinjau di instans API Management Anda, sebelum rilis ruang kerja yang tersedia secara umum pada Agustus 2024. Ruang kerja yang dibuat setelah tanggal rilis yang tersedia secara umum yang menggunakan gateway ruang kerja untuk runtime API tidak terpengaruh oleh perubahan yang melanggar.
Perubahan mencolok
Berikut ini adalah perubahan melanggar yang mengharuskan Anda mengambil tindakan untuk memigrasikan ruang kerja pratinjau Anda ke versi yang tersedia secara umum:
- Gateway API ruang kerja diperlukan - Setiap ruang kerja harus dikaitkan dengan gateway API ruang kerja yang mengisolasi lalu lintas runtime ruang kerja. Dalam pratinjau, ruang kerja berbagi gateway dengan layanan.
- Identitas terkelola tingkat layanan tidak didukung - Untuk meningkatkan keamanan ruang kerja, identitas terkelola yang ditetapkan sistem dan ditetapkan pengguna yang diaktifkan di tingkat layanan tidak dapat digunakan di ruang kerja. Saat ini, fitur API Management terkait yang bergantung pada identitas terkelola, seperti menyimpan nilai dan sertifikat bernama di Azure Key Vault, dan menggunakan
authentication-managed-identitykebijakan, tidak didukung di ruang kerja.
Catatan
Perubahan yang melanggar ini selain perubahan yang melanggar Juni 2024 untuk ruang kerja pratinjau yang diumumkan sebelumnya.
Kapan batas waktu untuk perubahan ini?
Perubahan yang melanggar akan diberlakukan di ruang kerja pratinjau setelah 31 Maret 2025. Kami sangat menyarankan Agar Anda membuat semua perubahan yang diperlukan pada konfigurasi ruang kerja pratinjau Anda sebelum tanggal tersebut.
Apa yang perlu saya lakukan?
Jika ruang kerja Anda terpengaruh oleh perubahan ini, Anda perlu memigrasikan ruang kerja Anda agar selaras dengan kemampuan yang tersedia secara umum. Bagian berikut memberikan panduan tentang cara memigrasikan ruang kerja Anda.
Menggunakan tingkat Premium untuk instans API Management Anda
Pastikan instans API Management Anda berjalan di tingkat Premium untuk terus menggunakan ruang kerja. Seperti yang diumumkan sebelumnya, jika instans Anda berada di tingkat Standar atau Pengembang, Anda perlu meningkatkan ke tingkat Premium.
Mengonfirmasi wilayah untuk instans Anda
Menambahkan gateway ruang kerja ke ruang kerja mengharuskan gateway berada di wilayah yang sama dengan instans Anda. Saat ini, gateway ruang kerja didukung di subset wilayah tempat API Management tersedia. Wilayah dengan dukungan untuk gateway ruang kerja akan diperbarui dari waktu ke waktu.
Untuk menentukan apakah ruang kerja pratinjau berada di wilayah yang didukung:
- Di Portal Microsoft Azure, navigasikan ke instans API Management Anda.
- Di menu sebelah kiri, di bawah API, pilih Ruang Kerja, dan pilih ruang kerja.
- Jika ruang kerja Anda berada di wilayah yang tidak mendukung gateway ruang kerja, Anda akan melihat pesan di portal yang mirip dengan "Ruang kerja saat ini tidak tersedia di wilayah layanan API Management Anda".
- Jika melihat pesan ini, Anda dapat memindahkan instans API Management ke wilayah yang didukung.
- Jika Anda tidak melihat pesan ini, ruang kerja Anda berada di wilayah yang didukung dan Anda dapat melanjutkan untuk menambahkan gateway ruang kerja.
Menambahkan gateway ruang kerja ke ruang kerja Anda
Berikut ini adalah langkah-langkah singkatan untuk menambahkan gateway ruang kerja ke ruang kerja. Untuk opsi jaringan gateway, prasyarat, dan instruksi terperinci, lihat Membuat dan mengelola ruang kerja.
Catatan
- Gateway ruang kerja dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat Harga API Management.
- API Management saat ini hanya mendukung gateway khusus per ruang kerja. Jika ini berdampak pada rencana migrasi Anda, lihat peta jalan ruang kerja di pengumuman GA ruang kerja.
- Di Portal Microsoft Azure, navigasikan ke instans API Management Anda.
- Di menu sebelah kiri, di bawah API, pilih Ruang Kerja.
- Pilih ruang kerja.
- Di menu sebelah kiri, di bawah Penyebaran + infrastruktur, pilih Gateway>+ Tambahkan.
- Selesaikan wizard untuk membuat gateway. Saat ini, provisi gateway dapat memakan waktu dari beberapa menit hingga 3 jam atau lebih.
- Setelah gateway Anda disediakan, buka halaman Gambaran Umum gateway. Perhatikan nilai nama host Runtime. Gunakan nilai ini untuk memperbarui aplikasi klien Anda yang memanggil API ruang kerja Anda.
- Ulangi langkah-langkah sebelumnya untuk ruang kerja Anda yang tersisa.
Memperbarui aplikasi klien untuk menggunakan nama host gateway baru
Setelah menambahkan gateway ke ruang kerja, Anda perlu memperbarui aplikasi klien yang memanggil API ruang kerja untuk menggunakan nama host gateway baru alih-alih nama host gateway instans API Management Anda.
Catatan
Untuk membantu Anda memigrasikan ruang kerja, API di ruang kerja masih dapat diakses pada runtime hingga Oktober 2024 menggunakan nama host gateway instans API Management Anda, bahkan jika gateway ruang kerja dikaitkan dengan ruang kerja. Kami sangat menyarankan Anda menyelesaikan migrasi sebelum tanggal ini. Jika gateway ruang kerja Anda dikonfigurasi dengan akses masuk privat dan akses keluar privat, pastikan bahwa konektivitas ke gateway bawaan instans API Management Anda juga diamankan.
Memperbarui dependensi pada identitas terkelola tingkat layanan
Jika Anda menggunakan identitas terkelola tingkat layanan dalam konfigurasi entitas ruang kerja (misalnya, nilai atau sertifikat bernama), Anda perlu memperbarui konfigurasi. Langkah-langkah yang direkomendasikan bervariasi tergantung pada entitas. Contoh: Perbarui nilai bernama untuk menggunakan nilai rahasia alih-alih rahasia yang disimpan di Azure Key Vault.
Bantuan dan dukungan
Jika Anda memiliki pertanyaan, dapatkan jawaban dari pakar komunitas di Microsoft Q&A. Jika Anda memiliki rencana dukungan dan memerlukan bantuan teknis, buat permintaan dukungan.
Informasi selengkapnya
Konten terkait
Lihat semua perubahan yang dapat menyebabkan gangguan dan penghentian fitur mendatang.