Penghentian versi API (Juni 2024)

BERLAKU UNTUK: Konsumsi | Pengembang | Dasar | Standar | Premium

Azure API Management menggunakan Azure Resource Manager (ARM) untuk mengonfigurasikan instans API Management. Versi API disematkan dalam penggunaan template yang menjelaskan infrastruktur, alat yang digunakan untuk mengonfigurasikan layanan, dan program yang Anda tulis untuk mengelola layanan API Management.

Mulai 1 Juni 2024, semua versi API untuk layanan Azure API Management sebelum 2021-08-01 dihentikan (dinonaktifkan). Tanggal pensiun yang dikomunikasikan sebelumnya adalah 30 September 2023. Kapan saja setelah 1 Juni 2024, panggilan API menggunakan versi API sebelum 2021-08-01 mungkin gagal tanpa pemberitahuan lebih lanjut. Anda tidak akan lagi dapat membuat atau mengelola layanan API Management dengan templat, alat, skrip, dan program yang ada menggunakan versi API yang sudah dihentikan hingga diperbarui untuk menggunakan API versi 2021-08-01 atau yang lebih baru. Operasi sarana data (seperti memediasi permintaan API di gateway) tidak akan terpengaruh oleh pembaruan ini, termasuk setelah 1 Juni 2024.

Apakah layanan saya terpengaruh oleh penghentian ini?

Meskipun layanan Anda tidak terpengaruh oleh perubahan ini, alat, skrip, atau program apa pun yang menggunakan Azure Resource Manager (seperti Azure CLI, Azure PowerShell, Azure API Management DevOps Resource Kit, atau Terraform) untuk berinteraksi dengan layanan API Management dan memanggil versi API Management API sebelum 2021-08-01 terpengaruh oleh perubahan ini. Setelah versi API dihentikan, Anda tidak akan dapat menjalankan alat apa pun yang terpengaruh dengan sukses kecuali Anda memperbarui alat.

Kapan batas waktu untuk perubahan ini?

Versi API yang terpengaruh akan dihentikan secara bertahap mulai 1 Juni 2024.

Setelah versi API dihentikan, jika Anda lebih suka tidak memperbarui alat, skrip, dan program yang terpengaruh, layanan Anda akan terus berjalan. Namun, Anda tidak akan dapat menambahkan atau menghapus API, mengubah kebijakan API, atau mengonfigurasi layanan API Management Anda dengan alat yang terpengaruh.

Tindakan yang diperlukan

Perbarui alat, skrip, dan program Anda menggunakan detail di bagian berikut.

Sebaiknya atur versi API Minimum di instans API Management Anda.

Memperbarui alat, skrip, dan program Anda

  • Template ARM, Bicep, atau Terraform - Perbarui template untuk menggunakan versi API 01-08-2021 atau yang lebih baru.

  • Azure CLI - Jalankan az version untuk memeriksa versi Anda. Jika Anda menjalankan versi 2.42.0 atau yang lebih baru, tidak ada tindakan yang diperlukan. Gunakan perintah az upgrade untuk meningkatkan Azure CLI jika perlu. Untuk informasi selengkapnya, lihat Cara memperbarui Azure CLI.

  • Azure PowerShell - Jalankan Get-Module -ListAvailable -Name Az untuk memeriksa versi Anda. Jika Anda menjalankan versi 8.1.0 atau yang lebih baru, Anda tidak perlu melakukan tindakan apa pun. Gunakan Update-Module -Name Az -Repository PSGallery untuk memperbarui modul, jika diperlukan. Untuk informasi selengkapnya, lihat Menginstal modul Azure PowerShell.

  • Alat lainnya - Gunakan versi berikut (atau yang lebih baru):

    • API Management DevOps Resource Kit: 1.0.0
    • Terraform azurerm provider: 3.0.0

  • Azure SDK - Perbarui SDK Azure API Management ke versi terbaru atau setidaknya versi berikut:

    • .NET: v1.1.0
    • Go: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Memperbarui pengaturan versi API Minimum pada instans API Management Anda

Sebaiknya atur versi API Minimum untuk instans API Management Anda menggunakan portal Azure atau menggunakan REST API atau alat lainnya. Pengaturan ini membatasi panggilan API sarana kontrol ke instans Anda ke versi API yang sama dengan atau lebih baru dari nilai ini. Dengan mengatur nilai ini ke 2021-08-01, Anda dapat menilai dampak penghentian versi API pada alat Anda.

Untuk mengatur versi API Minimum di portal:

  1. Di Portal Microsoft Azure, navigasikan ke instans API Management Anda.
  2. Di menu sebelah kiri, di bawah Penyebaran + infrastruktur, pilih API Manajemen.
  3. Pilih tab Pengaturan API Manajemen.
  4. Di bawah Terapi versi API minimum, pilih Ya. Versi API Minimum muncul.
  5. Pilih Simpan.

Penting

Jika versi API Minimum di portal berwarna abu-abu, Anda hanya dapat memperbarui pengaturan secara terprogram, misalnya, menggunakan REST API atau perintah az apim update di Azure CLI.

Informasi selengkapnya

Konten terkait

Lihat semua perubahan yang dapat menyebabkan gangguan dan penghentian fitur mendatang.

  • Last updated on