Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article fournit les dernières actualités et mises à jour sur les versions d’API recommandées à utiliser. Les versions d’API qui ne sont pas répertoriées ici peuvent être prises en charge, mais seront bientôt abandonnées. Vous trouverez ici la documentation relative à la dernière préversion et à la version stable de l’API.
Versions d’API
Cette section récapitule les modifications des fonctionnalités dans chaque version de l’API Azure Database pour PostgreSQL.
Remarque
Les versions d’API s’appuient généralement sur des versions antérieures, mais les fonctionnalités en préversion peuvent changer ou être supprimées. La colonne Notes de publication répertorie les modifications pour chaque version.
| Version de l’API | Stable/préversion | Notes de publication |
|---|---|---|
| 2026-10-01 | Stable (GA) | Inclut toutes les fonctionnalités des versions d’API stables précédentes, avec les ajouts suivants : Gestion de la maintenance : Prise en charge de la reprogrammation de la maintenance planifiée, application de mises à jour de maintenance disponibles à la demande, affichage de la maintenance à venir et récupération de l’historique de maintenance. Mise en réseau : Prise en charge de la migration de serveurs à partir de l’intégration au réseau virtuel (VNet) vers un accès public et une mise en réseau avec point de terminaison privé. Conformité FIPS : Prise en charge de la création de serveurs avec FIPS activée et activation ou désactivation de FIPS sur des serveurs existants. Sauvegardes immuables : Prise en charge de la création de serveurs avec des sauvegardes immuables activées. Mises à niveau des versions principales : Prise en charge de l’exécution de vérifications de validation de pré-mise à niveau avant de lancer une mise à niveau de version majeure PostgreSQL. Réglage autonome : Ajoute vacuumTable en tant qu’option de réglage autonome prise en charge.Clés gérées par le client entre locataires (CMK) : Prise en charge de la configuration du chiffrement entre locataires à l’aide de clés gérées par le client, avec ou sans sauvegardes géoredondantes activées. Flexibilité de version PostgreSQL : Supprime la contrainte d’énumération de version PostgreSQL, ce qui permet la création du serveur et les mises à niveau de version majeure pour prendre en charge les versions nouvellement publiées de PostgreSQL sans nécessiter de mise à jour de schéma d’API. |
| 2026-07-01-preview | Preview | Inclut toutes les fonctionnalités des versions précédentes de l’API, avec les ajouts suivants : PostgreSQL 19 : Ajoute PostgreSQL version 19 à l’énumération prise en charge PostgresMajorVersion .Agent de base de données (DBAgent) : Introduit une nouvelle ressource DBAgent et des opérations de gestion associées. Gestion du stockage : Ajoute de nouvelles propriétés de stockage pour prendre en charge la configuration de Premium SSD v2 et l’augmentation automatique du stockage. |
| 2026-04-01-preview | Preview | Inclut toutes les fonctionnalités des versions précédentes de l’API, avec les ajouts suivants : Gestion de la maintenance : Présente l’API MaintenanceEvent avec des opérations pour récupérer les détails des événements de maintenance, répertorier les événements de maintenance par serveur, replanifier la maintenance planifiée et appliquer les mises à jour de maintenance disponibles à la demande.Vérifications préalables de la mise à niveau des versions principales : Introduit l’API MajorVersionUpgradePrecheck avec les opérations Get et List by Server, ainsi qu’une nouvelle opération MajorVersionUpgradePrecheck sur l’API Servers pour lancer des vérifications de validation avant la mise à niveau.Clés gérées par le client entre locataires (CMK) : Ajoute les propriétés geoBackupFederatedIdentityClientId et primaryFederatedIdentityClientId à l’API Serveurs pour prendre en charge le chiffrement des données entre locataires à l’aide de clés gérées par le client. |
| 2026-01-01-preview | Preview | Inclut toutes les fonctionnalités des versions précédentes de l’API, avec l’ajout suivant : Mise en réseau : Prise en charge de la migration de serveurs à partir de l’intégration au réseau virtuel (VNet) vers un accès public et une mise en réseau prenant en charge les points de terminaison privés. |
| 2025-08-01 | Stable (GA) | Fonctionnalités GA antérieures + Prise en charge de PG 18 Prise en charge de PG 17 Ajoute la prise en charge de la spécification du nom de base de données par défaut dans un cluster élastique Ajoute la prise en charge des recommandations de table Corrige les codes de réponse HTTP pour refléter ce que chaque API peut retourner Ajoute un exemple pour le chiffrement des données basée sur CMK avec la mise à jour automatique de la version de clé Ajoute un exemple de création de serveur dans un réseau virtuel appartenant à Microsoft Renomme les fichiers pour une meilleure représentation de leur contenu Renomme les ID d’opération pour améliorer l’organisation, la clarté et la navigation Améliore les métadonnées des définitions locales Améliore les descriptions pour la cohérence |
| 2025-06-01-preview | Preview | Renomme les fichiers pour une meilleure représentation de leur contenu Renomme les opérations pour améliorer l’organisation, la clarté et la navigation Ajoute un exemple pour le chiffrement des données basée sur CMK avec la mise à jour automatique de la version de clé Ajoute un exemple de création de serveur dans un réseau virtuel appartenant à Microsoft Ajoute la prise en charge des recommandations de table Ajoute la prise en charge de la spécification du nom de base de données par défaut dans un cluster élastique Supprime la prise en charge de la fonctionnalité d’optimisation des paramètres Améliore les descriptions Améliore les métadonnées des définitions locales Corrige les codes de réponse HTTP pour refléter ce que chaque API peut retourner |
| 2025-01-01-preview | Preview | Ajoute la prise en charge de la fonctionnalité de paramétrage des paramètres |
| 2024-11-01-preview | Preview | Réglage des index Ajout de types sources pour la migration Prise en charge PG 17 Prise en charge des types de stockage UltraSSD_LRS Clusters élastiques sur des instances de serveur flexibles |
| 2024-08-01 | Stable (GA) | Fonctionnalités GA antérieures + Geo + CMK : Réanimation abandonnée Croissance automatique du stockage Mise à l’échelle IOPS Api nouvelle fonctionnalité d’emplacement Sauvegarde de conservation à long terme Journaux d’activité du serveur Migrations Migration de la fonction de pré-validation Réplicas en lecture - Basculement (échange de site) Réplicas en lecture - Points de terminaison virtuels Points de terminaison privés Azure Defender / API de protection contre les menaces Prise en charge PG 16 Prise en charge des types de stockage PremiumV2_LRS Modifications des fonctionnalités d’emplacement pour SSDv2 Rôles de migration ID de ressource de l’instance de migration pour prendre en charge les migrations de points de terminaison privés Sauvegarde à la demande Identité gérée attribuée par le système |
| 2023-06-01-preview | Preview | Fonctionnalités GA antérieures + Prévalidation de migration Réplicas en lecture - Basculement (échange de site) Réplicas en lecture - Points de terminaison virtuels Points de terminaison privés Azure Defender\API de protection contre les menaces Prise en charge PG 16 Prise en charge des types de stockage PremiumV2_LRS Modifications des fonctionnalités d’emplacement pour SSDv2 API d’utilisation des quotas |
| 2023-03-01-preview | Preview | Nouvelles fonctionnalités de la version GA (2022-12-01) + Géo + CMK Croissance automatique du stockage Mise à l’échelle IOPS Nouvelle API de capacité d’emplacement Azure Defender Journaux d’activité du serveur Migrations |
| 2022-12-01 | Stable (GA) | Fonctionnalités GA antérieures + EntraID CMK Backups Administrators Replicas Géorestauration MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Stable (GA) | Fonctionnalités GA antérieures + Serveur CRUD CheckNameAvailability Configurations (paramètres) Database Règles de pare-feu Privé Suffixe de zone DNS Restauration à un instant dans le passé Redémarrage du serveur Démarrage du serveur Arrêt du serveur réseau Fenêtre de maintenance Utilisation du sous-réseau de réseau virtuel |
Liste des opérations d’API stables
Chaque opération d’API stable prise en charge et ses détails sont répertoriés dans le tableau suivant.
| Fonctionnalité/opération | Détails |
|---|---|
| Administrators | Gérer les administrateurs de serveur Microsoft Entra ID |
| Protection avancée contre les menaces | Gérer les paramètres de protection avancée contre les menaces |
| Sauvegarder et restaurer | Gérer les sauvegardes automatiques et à la demande du serveur |
| Fonctionnalités | Répertorier les fonctionnalités de serveur disponibles par emplacement et serveur |
| Configurations | Afficher et gérer les paramètres du serveur PostgreSQL |
| Databases | Créer, lire, mettre à jour, supprimer et répertorier des bases de données |
| Chiffrement de données | Configurer des clés gérées par le client (CMK), y compris le chiffrement inter-locataire |
| Règles de pare-feu | Créer, lire, mettre à jour, supprimer et répertorier des règles de pare-feu |
| Rétention à long terme | Gérer les opérations de sauvegarde de rétention à long terme |
| Événements de maintenance | Lister, consulter, replanifier et appliquer à la demande des événements de maintenance |
| Pré-vérifications de mise à niveau de version majeure | Lancer des vérifications de validation avant la mise à niveau et récupérer les résultats de validation |
| Migrations | Créer et gérer des opérations de migration de base de données |
| Nom Disponibilité | Vérifier la disponibilité du nom du serveur et du point de terminaison virtuel |
| Migration en mode réseau | Migrer des serveurs de l’intégration VNet vers une configuration réseau compatible avec Private Link |
| Operations | Répertorier les opérations de gestion des fournisseurs de ressources disponibles |
| Réglage des performances | Récupérer les options de réglage et les recommandations d’optimisation de base de données |
| Suffixe de zone DNS privé | Récupérer le suffixe de zone DNS privé |
| Points de terminaison privés | Gérer les connexions de point de terminaison privé |
| Private Link Ressources | Répertorier les ressources de liens privés |
| Utilisation du quota | Récupérer les informations régionales relatives au quota et à l’utilisation du serveur |
| Réplicas en lecture | Créer et gérer des réplicas en lecture, notamment la promotion et le basculement |
| Servers | Créer, lire, mettre à jour, supprimer, lister, démarrer, arrêter et redémarrer des serveurs |
| Points de terminaison virtuels | Créer et gérer des points de terminaison virtuels |
| Utilisation du sous-réseau du réseau virtuel | Récupérer les informations d’utilisation du sous-réseau de réseau virtuel |
Liste des opérations d’API en préversion
Le tableau suivant répertorie chaque opération d’API en préversion prise en charge et ses détails.
| Fonctionnalité/opération | Détails |
|---|---|
| Administrators | Créer, récupérer, répertorier et supprimer des administrateurs de serveur Microsoft Entra ID |
| Protection avancée contre les menaces | Récupérer, répertorier et mettre à jour les paramètres de protection avancée contre les menaces |
| Sauvegarder et restaurer | Créer, récupérer, répertorier et supprimer des sauvegardes à la demande ; répertorier les sauvegardes automatiques disponibles |
| Fonctionnalités | Répertorier les fonctionnalités de serveur disponibles par emplacement et serveur |
| Journaux capturés | Afficher la liste des journaux du serveur capturés disponibles au téléchargement |
| Configurations | Récupérer, répertorier et mettre à jour les paramètres du serveur PostgreSQL |
| Agents de base de données | Répertorier, récupérer, activer et désactiver les configurations de l’agent de base de données |
| Databases | Créer, récupérer, répertorier et supprimer des bases de données |
| Chiffrement de données | Configurer des clés gérées par le client (CMK), y compris le chiffrement inter-locataire |
| Règles de pare-feu | Créer, récupérer, mettre à jour, lister et supprimer des règles de pare-feu |
| Rétention à long terme | Valider les prérequis de sauvegarde, lancer des sauvegardes de rétention à long terme et récupérer les résultats de l’opération de sauvegarde |
| Événements de maintenance | Récupérer et répertorier les événements de maintenance, filtrer selon le statut à venir ou passé, replanifier la maintenance et appliquer immédiatement la maintenance |
| Pré-vérifications de mise à niveau de version majeure | Lancer des vérifications de validation avant la mise à niveau et récupérer ou répertorier les résultats de validation |
| Migrations | Créer, récupérer, répertorier, mettre à jour et annuler des migrations de base de données ; valider la disponibilité du nom de migration |
| Nom Disponibilité | Vérifier la disponibilité du nom du serveur et du point de terminaison virtuel globalement ou par emplacement |
| Migration en mode réseau | Migrer des serveurs de l’intégration au réseau virtuel vers un modèle de mise en réseau compatible Private Link |
| Operations | Répertorier les opérations de gestion des fournisseurs de ressources disponibles |
| Réglage des performances | Récupérer les options de réglage et les recommandations d’optimisation des index ou des tables |
| Suffixe de zone DNS privé | Récupérer le suffixe de la zone DNS privée |
| Points de terminaison privés | Récupérer, répertorier, approuver, rejeter et supprimer des connexions de point de terminaison privé |
| Private Link Ressources | Récupérer et répertorier les ressources Private Link |
| Utilisation du quota | Récupérer l’utilisation du quota régional pour les serveurs flexibles |
| Réplicas en lecture | Créer, répertorier et gérer des réplicas en lecture, y compris la promotion et le basculement |
| Servers | Créer, récupérer, mettre à jour, supprimer et répertorier des serveurs ; démarrer, arrêter et redémarrer des serveurs |
| Gestion du stockage | Configurer Premium SSD v2 et la croissance automatique du stockage via les propriétés de stockage du serveur |
| Points de terminaison virtuels | Créer, récupérer, mettre à jour, répertorier et supprimer des points de terminaison virtuels |
| Utilisation du sous-réseau de réseau virtuel | Récupérer les informations d’utilisation du sous-réseau de réseau virtuel |
Utilisation des préversions de l’API à partir de Terraform
Terraform est un outil logiciel IaC (infrastructure-as-code) créé par HashiCorp. Les utilisateurs définissent et fournissent une infrastructure de centre de données à l’aide d’un langage de configuration déclaratif appelé HashiCorp Configuration Language (HCL), ou éventuellement JSON. Terraform est un moyen courant d’effectuer la gestion IaC pour Azure Database pour PostgreSQL basé sur l’API Azure RM en disponibilité générale, en plus des modèles Azure Resource Manager (ARM). La communauté Terraform publie régulièrement des mises à jour pour le fournisseur Terraform Azure Resource Manager (AzureRM) basées sur la version de l’API Azure Resource Manager en disponibilité générale.
Si une fonctionnalité particulière se trouve actuellement dans une API en préversion et n’est pas encore incorporée dans l’API GA et le fournisseur Terraform AzureRM, utilisez le fournisseur Terraform AzAPI pour appeler l’API de préversion directement à partir de Terraform. Le fournisseur AzAPI est une couche mince qui se superpose aux API REST Azure Resource Manager. Le fournisseur AzAPI vous permet de gérer n’importe quel type de ressource Azure à l’aide de n’importe quelle version de l’API. Le fournisseur AzAPI est une couche mince qui se superpose aux API REST ARM. À l’aide du fournisseur AzAPI, vous pouvez gérer n’importe quel type de ressource Azure à l’aide de n’importe quelle version de l’API. Ce fournisseur complète le fournisseur AzureRM en activant la gestion des nouvelles ressources et propriétés Azure (y compris la préversion privée).
Le fournisseur AzAPI présente les avantages suivants :
- Prise en charge de tous les services Azure :
- Services et fonctionnalités en préversion privée
- Services et fonctionnalités en préversion publique
- Toutes les versions d’API
- Fidélité complète des fichiers d’état Terraform
- Les propriétés et les valeurs sont enregistrées dans l’état
- Aucune dépendance envers Swagger
- Authentification Azure commune et cohérente
AzAPI2AzureRM est un outil open source conçu pour faciliter la migration du fournisseur AzAPI vers le fournisseur AzureRM.
Contacts
Pour toute question ou suggestions que vous pouvez avoir sur Azure Database pour PostgreSQL, envoyez un e-mail à l’équipe Azure Database pour PostgreSQL (@Ask Azure Database pour PostgreSQL). Notez que cette adresse e-mail n’est pas un alias de support technique.
En outre, tenez compte des points de contact suivants le cas échéant :
- Pour contacter le support Azure, déposez un ticket à partir du portail Azure.
- Pour résoudre un problème avec votre compte, déposez une demande de support dans le portail Azure.
- Pour fournir des commentaires ou demander de nouvelles fonctionnalités, créez une entrée via UserVoice.