Catatan rilis untuk REST API untuk server fleksibel Azure Database for PostgreSQL

Artikel ini menyediakan berita terbaru dan pembaruan tentang versi API yang direkomendasikan untuk digunakan. Versi API yang tidak tercantum di sini mungkin didukung, tetapi akan segera dihentikan. Temukan dokumentasi untuk pratinjau terbaru dan versi API stabil yang tersedia di sini.

Rilis API

Bagian ini meringkas perubahan fitur di setiap versi API Azure Database for PostgreSQL.

Note

Versi API umumnya dibangun pada versi yang lebih lama, tetapi fitur pratinjau dapat berubah atau dihapus. Kolom Catatan Rilis mencantumkan perubahan untuk setiap versi.

Versi API Stabil/Pratinjau Catatan Rilis
2026-10-01 Stabil (GA) Termasuk semua kemampuan dari versi API stabil sebelumnya, dengan penambahan berikut:

Manajemen pemeliharaan: Dukungan untuk menjadwalkan ulang pemeliharaan terencana, menerapkan pembaruan pemeliharaan yang tersedia sesuai permintaan, melihat pemeliharaan yang akan datang, dan mengambil riwayat pemeliharaan.

Jaringan: Dukungan untuk memigrasikan server dari integrasi jaringan virtual (VNet) ke akses publik dan jaringan berkemampuan titik akhir privat.

Kepatuhan FIPS: Dukungan untuk membuat server dengan FIPS diaktifkan dan mengaktifkan atau menonaktifkan FIPS di server yang ada.

Pencadangan yang tidak dapat diubah: Dukungan untuk membuat server dengan cadangan yang tidak dapat diubah diaktifkan.

Peningkatan versi utama: Dukungan untuk menjalankan pemeriksaan validasi pra-peningkatan sebelum memulai peningkatan versi utama PostgreSQL.

Penyetelan otonom: Menambahkan vacuumTable sebagai opsi penyetelan otonom yang didukung.

Kunci yang dikelola pelanggan lintas penyewa (CMK): Dukungan untuk mengonfigurasi enkripsi lintas penyewa menggunakan kunci yang dikelola pelanggan, dengan atau tanpa cadangan geo-redundan diaktifkan.

Fleksibilitas versi PostgreSQL: Menghapus batasan enumerasi versi PostgreSQL, memungkinkan pembuatan server dan peningkatan versi utama untuk mendukung versi PostgreSQL yang baru dirilis tanpa memerlukan pembaruan skema API.
2026-07-01-preview Preview Mencakup semua kemampuan dari versi API sebelumnya, dengan penambahan berikut:

PostgreSQL 19: Menambahkan PostgreSQL versi 19 ke enumerasi yang didukung PostgresMajorVersion .

Agen Database (DBAgent): Memperkenalkan sumber daya DBAgent baru dan operasi manajemen terkait.

Manajemen penyimpanan: Menambahkan properti penyimpanan baru untuk mendukung SSD Premium v2 dan konfigurasi autogrow penyimpanan.
2026-04-01-preview Preview Mencakup semua kemampuan dari versi API sebelumnya, dengan penambahan berikut:

Manajemen pemeliharaan:MaintenanceEvent Memperkenalkan API dengan operasi untuk mengambil detail peristiwa pemeliharaan, mencantumkan peristiwa pemeliharaan menurut server, menjadwalkan ulang pemeliharaan terencana, dan menerapkan pembaruan pemeliharaan yang tersedia sesuai permintaan.

Pra-pemeriksaan peningkatan versi utama: Memperkenalkan API MajorVersionUpgradePrecheck dengan operasi Dapatkan dan Daftar menurut Server, bersama dengan operasi baru MajorVersionUpgradePrecheck pada API Server untuk memulai pemeriksaan validasi pra-peningkatan.

Kunci yang dikelola pelanggan lintas penyewa (CMK): Menambahkan properti primaryFederatedIdentityClientId dan geoBackupFederatedIdentityClientId ke API Server untuk mendukung enkripsi data lintas penyewa menggunakan kunci yang dikelola pelanggan.
Pratinjau 2026-01-01 Preview Mencakup semua kemampuan dari versi API sebelumnya, dengan penambahan berikut:

Jaringan: Dukungan untuk memigrasikan server dari integrasi jaringan virtual (VNet) ke akses publik dan jaringan berkemampuan titik akhir privat.
2025-08-01 Stabil (GA) Fitur GA sebelumnya +
Dukungan untuk PG 18
Dukungan untuk PG 17
Menambahkan dukungan untuk menentukan nama database default dalam Kluster Elastis
Menambahkan dukungan untuk rekomendasi tabel
Mengoreksi kode respons HTTP untuk mencerminkan apa yang dapat dikembalikan oleh setiap API
Menambahkan contoh untuk enkripsi data berbasis CMK dengan pembaruan versi kunci otomatis
Menambahkan contoh untuk pembuatan server di jaringan virtual milik Microsoft
Mengganti nama file untuk representasi kontennya yang lebih baik
Mengganti nama ID operasi untuk meningkatkan organisasi, kejelasan, dan navigasi
Meningkatkan metadata dari definisi lokal
Meningkatkan deskripsi untuk konsistensi
2025-06-01-preview Preview Mengganti nama file untuk representasi kontennya yang lebih baik
Mengganti nama operasi untuk meningkatkan organisasi, kejelasan, dan navigasi
Menambahkan contoh untuk enkripsi data berbasis CMK dengan pembaruan versi kunci otomatis
Menambahkan contoh untuk pembuatan server di jaringan virtual milik Microsoft
Menambahkan dukungan untuk rekomendasi tabel
Menambahkan dukungan untuk menentukan nama database default dalam Kluster Elastis
Menghapus dukungan untuk fitur penyetelan parameter
Meningkatkan deskripsi
Meningkatkan metadata dari definisi lokal
Mengoreksi kode respons HTTP untuk mencerminkan apa yang dapat dikembalikan oleh setiap API
2025-01-01-preview Preview Menambahkan dukungan untuk fitur penyetelan parameter
2024-11-01-preview Preview Penyetelan indeks
Menambahkan tipe sumber untuk migrasi
Dukungan PG 17
dukungan jenis penyimpanan UltraSSD_LRS
Kluster Elastis pada instans server fleksibel
2024-08-01 Stabil (GA) Fitur GA sebelumnya +
Geo + CMK - Menghidupkan Kembali yang Terputus
Peningkatan otomatis kapasitas penyimpanan
Penskalakan IOPS
API Lokasi Baru
Pencadangan Retensi Jangka Panjang
Catatan Server
Migrations
Pravalidasi Migrasi
Replika baca - Pengalihan (Pertukaran situs)
Replika pembacaan - Titik Akhir Virtual
Titik akhir pribadi
Azure Defender / Threat Protection API
Dukungan PG 16
dukungan jenis penyimpanan PremiumV2_LRS
Perubahan kemampuan lokasi untuk SSDv2
Peran Migrasi
Id Sumber Daya Instans Migrasi untuk mendukung Migrasi titik akhir privat
Pencadangan sesuai permintaan
Sistem menetapkan identitas terkelola
Pratinjau 01-06-2023 Preview Fitur GA sebelumnya +
Prevalidasi Migrasi
Replika baca - Pengalihan (Pertukaran situs)
Replika pembacaan - Titik Akhir Virtual
Titik akhir pribadi
Azure Defender\API Perlindungan Ancaman
Dukungan PG 16
dukungan jenis penyimpanan PremiumV2_LRS
Perubahan kemampuan lokasi untuk SSDv2
API Penggunaan Kuota
2023-03-01-preview Preview Fitur versi GA baru (2022-12-01) +
Geo + CMK
Peningkatan otomatis kapasitas penyimpanan
Penskalakan IOPS
API kemampuan lokasi baru
Azure Defender
Catatan Server
Migrations
2022-12-01 Stabil (GA) Fitur GA sebelumnya +
EntraID
CMK
Backups
Administrators
Replicas
GeoRestore
MVU
2022-05-01-preview Preview CheckMigrationNameAvailability
Migrations
2021-06-01 Stabil (GA) Fitur GA sebelumnya +
Server CRUD
PeriksaKetersediaanNama
Konfigurasi (Parameter)
Database
Peraturan firewall
Privat
Akhiran zona DNS
PITR
Menghidupkan ulang Server
Mulai Server
Server Berhenti
Jendela waktu pemeliharaan
Penggunaan subnet jaringan virtual

Daftar operasi API yang stabil

Setiap operasi API stabil yang didukung dan detailnya tercantum dalam tabel berikut.

Fitur/Operasi Rincian
Administrators Mengelola administrator server Microsoft Entra ID
Perlindungan Tingkat Lanjut terhadap Ancaman Mengelola pengaturan perlindungan ancaman tingkat lanjut
Pencadangan & Pemulihan Mengelola pencadangan server otomatis dan sesuai permintaan
Capabilities Mencantumkan kemampuan server yang tersedia berdasarkan lokasi dan server
Konfigurasi Menampilkan dan mengelola parameter server PostgreSQL
Database Membuat, membaca, memperbarui, menghapus, dan mencantumkan database
Enkripsi Data Mengonfigurasi kunci yang dikelola pelanggan (CMK), termasuk enkripsi lintas-tenant
Aturan Firewall Membuat, membaca, memperbarui, menghapus, dan mencantumkan aturan firewall
Retensi Jangka Panjang Mengelola operasi pencadangan retensi jangka panjang
Peristiwa Pemeliharaan Mencantumkan, mengambil, menjadwalkan ulang, dan menerapkan event pemeliharaan sesuai permintaan
Pra-pemeriksaan Upgrade Versi Utama Mulai pemeriksaan validasi pra-peningkatan dan ambil hasil validasi
Migrations Membuat dan mengelola operasi migrasi database
Ketersediaan Nama Periksa ketersediaan nama server dan endpoint virtual
Migrasi Mode Jaringan Memigrasikan server dari integrasi VNet ke konfigurasi jaringan berkemampuan Private Link
Operations Daftar operasi manajemen penyedia sumber daya yang tersedia
Penyetelan Kinerja Dapatkan opsi penyetelan dan rekomendasi pengoptimalan basis data
Akhiran Zona DNS Privat Mengambil akhiran zona DNS privat
Titik akhir pribadi Mengelola sambungan titik akhir privat
Sumber Private Link Mencantumkan sumber daya tautan pribadi
Penggunaan Kuota Ambil informasi kuota dan penggunaan server regional
Replika Pembacaan Membuat dan mengelola replika baca, termasuk promosi dan pengalihan
Servers Membuat, membaca, memperbarui, menghapus, mencantumkan, memulai, menghentikan, dan memulai ulang server
Titik Akhir Virtual Membuat dan mengelola endpoint virtual
Penggunaan Subnet Jaringan Virtual Mengambil informasi penggunaan subnet pada jaringan virtual

Pratinjau daftar operasi API

Tabel berikut mencantumkan setiap operasi API pratinjau yang didukung dan detailnya.

Fitur/Operasi Rincian
Administrators Membuat, mengambil, mencantumkan, dan menghapus administrator server Microsoft Entra ID
Perlindungan Tingkat Lanjut terhadap Ancaman Mengambil, mencantumkan, dan memperbarui pengaturan perlindungan ancaman tingkat lanjut
Pencadangan & Pemulihan Membuat, mengambil, mencantumkan, dan menghapus cadangan sesuai permintaan; mencantumkan cadangan otomatis yang tersedia
Capabilities Mencantumkan kemampuan server yang tersedia berdasarkan lokasi dan server
Log yang Ditangkap Tampilkan log server yang terekam yang tersedia untuk diunduh
Konfigurasi Mengambil, mencantumkan, dan memperbarui parameter server PostgreSQL
Agen Basis Data Mencantumkan, mengambil, mengaktifkan, dan menonaktifkan konfigurasi agen database
Database Membuat, mengambil, menampilkan daftar, dan menghapus database
Enkripsi Data Mengonfigurasi kunci yang dikelola pelanggan (CMK), termasuk enkripsi lintas-tenant
Aturan Firewall Membuat, mengambil, memperbarui, mencantumkan, dan menghapus aturan firewall
Retensi Jangka Panjang Memvalidasi prasyarat pencadangan, memulai pencadangan retensi jangka panjang, dan mengambil hasil operasi pencadangan
Peristiwa Pemeliharaan Mengambil dan menampilkan event pemeliharaan, memfilter berdasarkan status yang akan datang atau sebelumnya, menjadwalkan ulang pemeliharaan, dan segera menjalankan pemeliharaan
Pra-pemeriksaan untuk Upgrade Versi Utama Memulai pemeriksaan validasi pra-peningkatan dan mengambil atau mencantumkan hasil validasi
Migrations Membuat, mengambil, mencantumkan, memperbarui, dan membatalkan migrasi database; memvalidasi ketersediaan nama migrasi
Ketersediaan Nama Periksa ketersediaan nama server dan titik akhir virtual secara global atau berdasarkan lokasi
Migrasi Mode Jaringan Memigrasikan server dari integrasi VNet ke model jaringan berkemampuan Private Link
Operations Mencantumkan operasi manajemen penyedia sumber daya yang tersedia
Penyetelan Kinerja Mengambil opsi penyetelan dan rekomendasi pengoptimalan indeks atau tabel
Sufiks Zona DNS Privat Ambil sufiks zona DNS privat
Titik akhir pribadi Mengambil, mencantumkan, menyetujui, menolak, dan menghapus koneksi titik akhir privat
Sumber Private Link Mengambil dan mencantumkan sumber daya tautan privat
Penggunaan Kuota Mengambil penggunaan kuota regional untuk server fleksibel
Replika Pembacaan Membuat, mendaftar, dan mengelola replika baca, termasuk promosi dan pengalihan
Servers Membuat, mengambil, memperbarui, menghapus, dan mencantumkan server; memulai, menghentikan, dan memulai ulang server
Manajemen Penyimpanan Mengonfigurasi Premium SSD v2 dan pertumbuhan otomatis penyimpanan melalui properti penyimpanan server
Titik Akhir Virtual Membuat, mengambil, memperbarui, mencantumkan, dan menghapus titik akhir virtual
Penggunaan Subnet Virtual Network Mengambil informasi penggunaan subnet jaringan virtual

Menggunakan versi pratinjau API dari Terraform

Terraform adalah alat perangkat lunak infrastructure-as-code (IaC) yang dibuat oleh HashiCorp. Pengguna menentukan dan menyediakan infrastruktur pusat data menggunakan bahasa konfigurasi deklaratif yang dikenal sebagai HashiCorp Configuration Language (HCL), atau secara opsional JSON. Terraform adalah cara umum untuk melakukan manajemen IaC untuk Azure Database for PostgreSQL berdasarkan GA Azure RM API, selain Templat Azure Resource Manager (ARM). Komunitas Terraform merilis pembaruan rutin untuk penyedia Terraform Azure Resource Manager (AzureRM) berdasarkan versi API Azure Resource Manager dalam General Availability (GA).

Jika fitur tertentu saat ini berada dalam API pratinjau dan belum dimasukkan ke dalam API GA dan penyedia AzureRM Terraform, gunakan penyedia AzAPI Terraform untuk memanggil API pratinjau langsung dari Terraform. Penyedia AzAPI adalah lapisan tipis di atas REST API Azure Resource Manager. Penyedia AzAPI memungkinkan Anda mengelola jenis sumber daya Azure apa pun dengan menggunakan versi API apa pun. Penyedia AzAPI adalah lapisan tipis di atas AZURE ARM REST API. Dengan menggunakan penyedia AzAPI, Anda dapat mengelola jenis sumber daya Azure apa pun menggunakan versi API apa pun. Penyedia ini melengkapi penyedia AzureRM dengan mengaktifkan manajemen sumber daya dan properti Azure baru (termasuk pratinjau privat).

Penyedia AzAPI menampilkan manfaat berikut:

  • Mendukung semua layanan Azure:
  • Layanan dan fitur pratinjau privat
  • Layanan dan fitur pratinjau publik
  • Semua versi API
  • Keakuratan file status Terraform penuh
  • Properti dan nilai disimpan ke status
  • Tidak ada dependensi pada Swagger
  • Autentikasi Azure umum dan konsisten

AzAPI2AzureRM adalah alat sumber terbuka yang dirancang untuk membantu bermigrasi dari penyedia AzAPI ke penyedia AzureRM.

Contacts

Untuk pertanyaan atau saran apa pun yang mungkin Anda miliki di Azure Database for PostgreSQL, kirim email ke Tim Azure Database for PostgreSQL (@Ask Azure Database for PostgreSQL). Perhatikan bahwa alamat email ini bukan alias dukungan teknis.

Selain itu, pertimbangkan titik kontak berikut sebagaimana mestinya:

Konten terkait

  • Terakhir diperbarui pada