Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo fornisce le novità e gli aggiornamenti più recenti sulle versioni api consigliate da usare. Le versioni dell'API non elencate qui potrebbero essere supportate, ma verranno ritirate a breve. La documentazione per le versioni API di anteprima e stabile più recenti è disponibile qui.
Versioni dell'API
Questa sezione riepiloga le modifiche apportate alle funzionalità in ogni versione dell'API Database di Azure per PostgreSQL.
Note
Le versioni API in genere si basano sulle versioni precedenti, ma le funzionalità di anteprima possono cambiare o essere rimosse. Nella colonna Note sulla versione sono elencate le modifiche per ogni versione.
| Versione dell'API | Stabile/Anteprima | Note di rilascio |
|---|---|---|
| 01/10/2026 | Stabile (disponibilità generale) | Include tutte le funzionalità delle versioni precedenti dell'API stabile, con le aggiunte seguenti: Gestione della manutenzione: Supporto per la riprogrammazione della manutenzione pianificata, l'applicazione di aggiornamenti di manutenzione disponibili su richiesta, la visualizzazione della manutenzione imminente e il recupero della cronologia di manutenzione. Rete: Supporto per la migrazione dei server dall'integrazione della rete virtuale (VNet) all'accesso pubblico e alla rete che supporta endpoint privati. Conformità FIPS: Supporto per la creazione di server con FIPS abilitato e l'abilitazione o la disabilitazione di FIPS nei server esistenti. Backup non modificabili: Supporto per la creazione di server con backup non modificabili abilitati. Aggiornamenti delle versioni principali: Supporto per l'esecuzione di controlli di convalida pre-aggiornamento prima di avviare un aggiornamento della versione principale di PostgreSQL. Ottimizzazione autonoma: Aggiunge vacuumTable come opzione di ottimizzazione autonoma supportata.Chiavi gestite dal cliente tra tenant (CMK): Supporto per la configurazione della crittografia tra tenant tramite chiavi gestite dal cliente, con o senza backup con ridondanza geografica abilitati. Flessibilità della versione di PostgreSQL: Rimuove il vincolo di enumerazione della versione di PostgreSQL, consentendo la creazione del server e gli aggiornamenti delle versioni principali per supportare le versioni di PostgreSQL appena rilasciate senza richiedere un aggiornamento dello schema API. |
| 2026-07-01-preview | Preview | Include tutte le funzionalità delle versioni precedenti dell'API, con le aggiunte seguenti: PostgreSQL 19: Aggiunge PostgreSQL versione 19 all'enumerazione supportata PostgresMajorVersion .Agente di database (DBAgent): Presenta una nuova risorsa DBAgent e le operazioni di gestione associate. Gestione archiviazione: Aggiunge nuove proprietà di archiviazione per supportare la configurazione premium SSD v2 e l'aumento automatico dell'archiviazione. |
| 2026-04-01-anteprima | Preview | Comprende tutte le funzionalità delle versioni precedenti dell'API, con le aggiunte seguenti: Gestione della manutenzione: Introduce l'API MaintenanceEvent con operazioni per recuperare i dettagli degli eventi di manutenzione, elencare gli eventi di manutenzione per server, riprogrammare la manutenzione pianificata e applicare gli aggiornamenti di manutenzione disponibili su richiesta.Controlli preliminari dell'aggiornamento della versione principale: Introduce l'API MajorVersionUpgradePrecheck con operazioni Get ed List by Server, insieme a una nuova MajorVersionUpgradePrecheck operazione nell'API Servers per avviare i controlli di convalida pre-aggiornamento.Chiavi gestite dal cliente tra tenant (CMK): Aggiunge le proprietà primaryFederatedIdentityClientId e geoBackupFederatedIdentityClientId all'API dei server per supportare la crittografia dei dati tra tenant tramite chiavi gestite dal cliente. |
| 2026-01-01-preview | Preview | Comprende tutte le funzionalità delle versioni precedenti dell'API, con l'aggiunta seguente: Rete: Supporto per la migrazione dei server dall'integrazione della rete virtuale (VNet) all'accesso pubblico e alla rete con supporto per gli endpoint privati. |
| 2025-08-01 | Stabile (disponibilità generale) | Funzionalità disponibilità generale precedenti + Supporto per PG 18 Supporto per PG 17 Aggiunge il supporto per specificare il nome predefinito del database in un cluster elastico Aggiunge il supporto per gli elementi consigliati per le tabelle Corregge i codici di risposta HTTP per riflettere ciò che ogni API può restituire Aggiunge un esempio per la crittografia dei dati basata su chiave gestita dal cliente con l'aggiornamento automatico della versione della chiave Aggiunge un esempio per la creazione di un server nella rete virtuale di proprietà di Microsoft Rinomina i file per una migliore rappresentazione del contenuto Rinomina gli ID delle operazioni per migliorare organizzazione, chiarezza e navigazione Migliora i metadati delle definizioni locali Migliora le descrizioni per la coerenza |
| 2025-06-01-preview | Preview | Rinomina i file per una migliore rappresentazione del contenuto Rinomina le operazioni per migliorare l'organizzazione, la chiarezza e la navigazione Aggiunge un esempio per la crittografia dei dati basata su chiave gestita dal cliente con l'aggiornamento automatico della versione della chiave Aggiunge un esempio per la creazione di un server nella rete virtuale di proprietà di Microsoft Aggiunge il supporto per gli elementi consigliati per le tabelle Aggiunge il supporto per specificare il nome predefinito del database in un cluster elastico Rimuove il supporto per la funzionalità di ottimizzazione dei parametri Migliora le descrizioni Migliora i metadati delle definizioni locali Corregge i codici di risposta HTTP per riflettere ciò che ogni API può restituire |
| 2025-01-01-preview | Preview | Aggiunge il supporto per la funzionalità di ottimizzazione dei parametri |
| 2024-11-01-preview | Preview | Ottimizzazione indici Aggiunta di tipi di origine per la migrazione Supporto PG 17 Supporto del tipo di archiviazione UltraSSD_LRS Cluster elastici in istanze del server flessibile |
| 2024-08-01 | Stabile (disponibilità generale) | Funzionalità disponibilità generale precedenti + Geo + CMK - Riattiva rimosso Aumento automatico dello spazio di archiviazione Ridimensionamento delle operazioni di I/O al secondo Nuova API per la funzionalità Posizione Backup di conservazione a lungo termine Log del server Migrations Pre-convalida della migrazione Repliche in lettura - Cambio (scambio di sito) Repliche in lettura - Endpoint virtuali Endpoint privati API di Azure Defender/Protezione dalle minacce Supporto PG 16 Supporto del tipo di archiviazione PremiumV2_LRS Modifiche alle funzionalità Posizione per SSDv2 Ruoli di migrazione ID risorsa dell'istanza di migrazione per supportare migrazioni di endpoint privati Backup su richiesta Identità gestita assegnata dal sistema |
| 2023-06-01-preview | Preview | Funzionalità disponibilità generale precedenti + Pre-convalida della migrazione Repliche in lettura - Cambio (scambio di sito) Repliche in lettura - Endpoint virtuali Endpoint privati API di Azure Defender/Protezione dalle minacce Supporto PG 16 Supporto del tipo di archiviazione PremiumV2_LRS Modifiche alle funzionalità Posizione per SSDv2 API utilizzo quote |
| 2023-03-01-preview | Preview | Nuove funzionalità della versione disponibile a livello generale (01-12-2022) + Geo + CMK Aumento automatico dello spazio di archiviazione Ridimensionamento delle operazioni di I/O al secondo Nuova API per la funzionalità Posizione Azure Defender Log del server Migrations |
| 2022-12-01 | Stabile (disponibilità generale) | Funzionalità disponibilità generale precedenti + EntraID Chiave gestita dal cliente Backups Administrators Replicas Ripristino geografico MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Stabile (disponibilità generale) | Funzionalità disponibilità generale precedenti + Server CRUD CheckNameAvailability Configurazioni (parametri) Banca dati Regole del firewall Privato Suffisso zona DNS Ripristino temporizzato Riavvio del server Avvio del server Arresto del server Finestra di manutenzione Utilizzo della subnet della rete virtuale |
Elenco di operazioni API stabili
Ogni operazione API stabile supportata e i relativi dettagli sono elencati nella tabella seguente.
| Funzionalità/operazione | dettagli |
|---|---|
| Administrators | Gestire gli amministratori del server Microsoft Entra ID |
| Protezione Avanzata dalle Minacce | Gestire le impostazioni di Advanced Threat Protection |
| Backup e ripristino | Gestire i backup automatici e su richiesta del server |
| Capabilities | Elencare le funzionalità del server disponibili in base alla posizione e al server |
| Configurations | Visualizzare e gestire i parametri del server PostgreSQL |
| Banche dati | Creare, leggere, aggiornare, eliminare ed elencare i database |
| Crittografia dei dati | Configurare chiavi gestite dal cliente (CMK), inclusa la crittografia tra tenant |
| Regole del firewall | Creare, leggere, aggiornare, eliminare ed elencare le regole del firewall |
| Conservazione a lungo termine | Gestire le operazioni di backup a lungo termine |
| Eventi di manutenzione | Elencare, recuperare, riprogrammare e applicare eventi di manutenzione su richiesta |
| Controlli preliminari dell'aggiornamento della versione principale | Avviare controlli di convalida pre-aggiornamento e recuperare i risultati della convalida |
| Migrations | Creare e gestire operazioni di migrazione del database |
| Disponibilità del nome | Controllare la disponibilità del nome del server e dell'endpoint virtuale |
| Migrazione della modalità di rete | Eseguire la migrazione dei server dall'integrazione della rete virtuale a una configurazione di rete con supporto per collegamento privato |
| Operations | Elencare le operazioni di gestione del provider di risorse disponibili |
| Ottimizzazione delle prestazioni | Recuperare le opzioni di ottimizzazione e i consigli per l'ottimizzazione del database |
| Suffisso della zona DNS privata | Recupera il suffisso della zona DNS privata |
| Endpoint privati | Gestire le connessioni dell'endpoint privato |
| Risorse di collegamento privato | Elenca le risorse di Private Link |
| Utilizzo delle quote | Recuperare informazioni sulla quota e sull'utilizzo dei server a livello di area |
| Repliche in lettura | Creare e gestire repliche in lettura, tra cui promozione e passaggio |
| Servers | Creare, leggere, aggiornare, eliminare, elencare, avviare, arrestare e riavviare i server |
| Endpoint virtuali | Creare e gestire endpoint virtuali |
| Utilizzo della subnet della rete virtuale | Recupera le informazioni sull'utilizzo della subnet della rete virtuale |
Anteprima elenco operazioni API
La tabella seguente elenca ogni operazione API di anteprima supportata e i relativi dettagli.
| Funzionalità/operazione | dettagli |
|---|---|
| Administrators | Creare, recuperare, elencare ed eliminare amministratori del server Microsoft Entra ID |
| Protezione Avanzata dalle Minacce | Recupera, elenca e aggiorna le impostazioni di Advanced Threat Protection |
| Backup e ripristino | Creazione, recupero, elenco ed eliminazione di backup su richiesta; elenco dei backup automatici disponibili |
| Capabilities | Elencare le funzionalità del server disponibili in base alla posizione e al server |
| Registri acquisiti | Elencare i log del server acquisiti disponibili per il download |
| Configurations | Recuperare, elencare e aggiornare i parametri del server PostgreSQL |
| Agenti di database | Elencare, recuperare, abilitare e disabilitare le configurazioni dell'agente di database |
| Banche dati | Creare, recuperare, elencare ed eliminare database |
| Crittografia dei dati | Configurare chiavi gestite dal cliente (CMK), inclusa la crittografia tra tenant |
| Regole del firewall | Creare, recuperare, aggiornare, elencare ed eliminare regole del firewall |
| Conservazione a lungo termine | Convalidare i prerequisiti di backup, avviare backup di conservazione a lungo termine e recuperare i risultati dell'operazione di backup |
| Eventi di manutenzione | Recupera ed elenca gli eventi di manutenzione, filtra in base allo stato imminente o passato, riprogramma la manutenzione e applica immediatamente la manutenzione |
| Controlli preliminari dell'aggiornamento della versione major | Avviare controlli di convalida pre-aggiornamento e recuperare o elencare i risultati della convalida |
| Migrations | Creare, recuperare, elencare, aggiornare e annullare le migrazioni di database; convalidare la disponibilità del nome della migrazione |
| Disponibilità del nome | Controllare la disponibilità del nome del server e dell'endpoint virtuale a livello globale o in base alla posizione |
| Migrazione della modalità di rete | Eseguire la migrazione dei server dall'integrazione della rete virtuale a un modello di rete compatibile con collegamento privato |
| Operations | Elencare le operazioni di gestione disponibili del provider di risorse |
| Ottimizzazione delle prestazioni | Recuperare le opzioni di ottimizzazione e i consigli per l'ottimizzazione di indici o tabelle |
| Suffisso della zona DNS privata | Recupera il suffisso di zona DNS privato |
| Endpoint privati | Recupera, elenca, approva, rifiuta ed elimina connessioni di endpoint privato |
| Risorse di collegamento privato | Recuperare ed elencare le risorse collegamento privato |
| Utilizzo delle quote | Recuperare l'utilizzo della quota a livello di area per i server flessibili |
| Repliche in lettura | Creare, elencare e gestire repliche in lettura, incluse le promozioni e lo switch-over |
| Servers | Creare, recuperare, aggiornare, eliminare ed elencare i server; avviare, arrestare e riavviare i server |
| Gestione dell'archiviazione | Configurare Premium SSD v2 e l'aumento automatico dell'archiviazione tramite le proprietà di archiviazione del server |
| Endpoint virtuali | Creare, recuperare, aggiornare, elencare ed eliminare endpoint virtuali |
| Uso della subnet di rete virtuale | Recupera le informazioni sull'utilizzo della subnet della rete virtuale |
Uso delle versioni di anteprima dell'API da Terraform
Terraform è uno strumento software IaC (Infrastructure-as-Code) creato da HashiCorp. Gli utenti definiscono e forniscono l'infrastruttura del data center usando un linguaggio di configurazione dichiarativo noto come HashiCorp Configuration Language (HCL) o, facoltativamente, JSON. Terraform è un modo comune per eseguire la gestione IaC per Database di Azure per PostgreSQL in base all'API RM di Azure con disponibilità generale, oltre ai modelli di Azure Resource Manager (ARM). La community Terraform rilascia aggiornamenti regolari per il provider Terraform di Azure Resource Manager (AzureRM) in base alla versione dell'API Azure Resource Manager con disponibilità generale.
Se una particolare funzionalità è attualmente in un'API di anteprima e non è ancora incorporata nell'API GA e nel provider AzureRM Terraform, usare il provider AzAPI Terraform per chiamare l'API di anteprima direttamente da Terraform. Il provider AzAPI è un livello sottile basato sulle API REST di Azure Resource Manager. Il provider AzAPI consente di gestire qualsiasi tipo di risorsa Azure usando qualsiasi versione dell'API. Il provider AzAPI è un livello sottile basato sulle API REST di Azure Resource Manager. Usando il provider AzAPI, è possibile gestire qualsiasi tipo di risorsa Azure usando qualsiasi versione dell'API. Questo provider integra il provider AzureRM consentendo la gestione di nuove risorse e proprietà di Azure (inclusa l'anteprima privata).
Il provider AzAPI offre i vantaggi seguenti:
- Supporta tutti i servizi di Azure:
- Servizi e funzionalità dell’anteprima privata
- Servizi e funzionalità dell’anteprima pubblica
- Tutte le versioni dell'API
- Fedeltà completa dei file di stato Terraform
- Le proprietà e i valori vengono salvati nello stato
- Nessuna dipendenza da Swagger
- Autenticazione di Azure comune e coerente
AzAPI2AzureRM è uno strumento open source progettato per facilitare la migrazione dal provider AzAPI al provider AzureRM.
Contatti
Per eventuali domande o suggerimenti su Database di Azure per PostgreSQL, inviare un messaggio di posta elettronica al team di Database di Azure per PostgreSQL (@Ask Database di Azure per PostgreSQL). Tenere presente che questo indirizzo di e-mail non è un alias di supporto tecnico.
Inoltre, prendere in considerazione i seguenti punti di contatto in base alle specifiche esigenze:
- Per contattare il supporto tecnico di Azure, inviare un ticket dal portale di Azure.
- Per risolvere un problema con l'account, inviare una richiesta di supporto nel portale di Azure.
- Per fornire feedback o per richiedere nuove funzionalità, inserire un messaggio tramite UserVoice.