Releaseopmerkingen voor de REST API's voor Azure Database for PostgreSQL flexibele server

Dit artikel bevat het laatste nieuws en updates over de aanbevolen API-versies die moeten worden gebruikt. De API-versies die hier niet worden vermeld, worden mogelijk ondersteund, maar worden binnenkort buiten gebruik gesteld. Hier vindt u de documentatie voor de nieuwste preview- en stabiele API-versie; deze is hier beschikbaar.

API-releases

In deze sectie vindt u een overzicht van de functiewijzigingen in elke Azure Database for PostgreSQL API-versie.

Note

API-versies zijn doorgaans gebaseerd op eerdere versies, maar preview-functies kunnen worden gewijzigd of verwijderd. In de kolom Opmerkingen bij de release worden de wijzigingen voor elke versie vermeld.

API-versie Stabiel/Voorvertoning Opmerkingen bij de release
2026-10-01 Stabiel (GA) Bevat alle mogelijkheden van eerdere stabiele API-versies, met de volgende toevoegingen:

Onderhoudsbeheer: Ondersteuning voor het opnieuw plannen van gepland onderhoud, het toepassen van beschikbare onderhoudsupdates op aanvraag, het weergeven van aankomend onderhoud en het ophalen van onderhoudsgeschiedenis.

Netwerken: Ondersteuning voor het migreren van servers van VNet-integratie (virtueel netwerk) naar openbare toegang en netwerken die geschikt zijn voor privé-eindpunten.

FIPS-naleving: Ondersteuning voor het maken van servers met FIPS ingeschakeld en het in- of uitschakelen van FIPS op bestaande servers.

Onveranderbare back-ups: Ondersteuning voor het maken van servers waarvoor onveranderbare back-ups zijn ingeschakeld.

Upgrades van hoofdversies: Ondersteuning voor het uitvoeren van validatiecontroles voorafgaand aan een PostgreSQL-upgrade van een hoofdversie.

Autonoom afstemmen: Voegt vacuumTable toe als een ondersteunde optie voor autonoom afstemmen.

Door de klant beheerde sleutels (CMK) voor tenantoverschrijdende versleuteling: Ondersteuning voor het configureren van tenantoverschrijdende versleuteling met door de klant beheerde sleutels, met of zonder geografisch redundante back-ups ingeschakeld.

Flexibiliteit van PostgreSQL-versie: Hiermee verwijdert u de opsommingsbeperking voor PostgreSQL-versies, waardoor het maken van servers en upgrades van hoofdversies ondersteuning bieden voor nieuw uitgebrachte PostgreSQL-versies zonder dat hiervoor een API-schema-update is vereist.
2026-07-01-preview Preview Bevat alle mogelijkheden van vorige API-versies, met de volgende toevoegingen:

PostgreSQL 19: Voegt PostgreSQL-versie 19 toe aan de ondersteunde PostgresMajorVersion opsomming.

DatabaseAgent (DBAgent): Introduceert een nieuwe DBAgent-resource en bijbehorende beheerbewerkingen.

Opslagbeheer: Voegt nieuwe opslageigenschappen toe ter ondersteuning van Premium SSD v2 en configuratie van automatische groei van opslag.
2026-04-01-preview Preview Bevat alle mogelijkheden van vorige API-versies, met de volgende toevoegingen:

Onderhoudsbeheer: Introduceert de MaintenanceEvent API met bewerkingen voor het ophalen van onderhoudsgebeurtenisdetails, het weergeven van onderhoudsgebeurtenissen per server, het opnieuw plannen van gepland onderhoud en het toepassen van beschikbare onderhoudsupdates op aanvraag.

Prechecks voor de upgrade van hoofdversie: Introductie van de MajorVersionUpgradePrecheck API met Get- en List by Server-bewerkingen, samen met een nieuwe MajorVersionUpgradePrecheck bewerking op de Servers-API om validatiecontroles vóór de upgrade te starten.

Tenantoverschrijdende door de klant beheerde sleutels (CMK): Hiermee worden primaryFederatedIdentityClientId- en geoBackupFederatedIdentityClientId-eigenschappen toegevoegd aan de Servers-API ter ondersteuning van gegevensversleuteling tussen tenants met behulp van door de klant beheerde sleutels.
2026-01-01-vooruitblik Preview Bevat alle mogelijkheden van eerdere API-versies, met de volgende toevoeging:

Netwerken: Ondersteuning voor het migreren van servers van VNet-integratie (virtueel netwerk) naar openbare toegang en netwerken die geschikt zijn voor privé-eindpunten.
2025-08-01 Stabiel (GA) Eerdere GA-functies +
Ondersteuning voor PG 18
Ondersteuning voor PG 17
Hiermee wordt ondersteuning toegevoegd voor het opgeven van de standaarddatabasenaam in een elastisch cluster
Er wordt ondersteuning toegevoegd voor tabelaanbevelingen
Corrigeert HTTP-antwoordcodes om aan te geven wat elke API kan retourneren
Voegt voorbeeld toe voor gegevensversleuteling op basis van CMK met automatische update van sleutelversie
Voegt voorbeeld toe voor het maken van een server in het virtuele netwerk van Microsoft
Hiermee wijzigt u de naam van bestanden voor een betere weergave van hun inhoud
Bewerkings-ID's hernoemen om de organisatie, duidelijkheid en navigatie te verbeteren
Verbetert de metagegevens van lokale definities
Verbetert beschrijvingen voor consistentie
2025-06-01-preview Preview Hiermee wijzigt u de naam van bestanden voor een betere weergave van hun inhoud
Wijzigt de naam van bewerkingen om de organisatie, duidelijkheid en navigatie te verbeteren
Voegt voorbeeld toe voor gegevensversleuteling op basis van CMK met automatische update van sleutelversie
Voegt voorbeeld toe voor het maken van een server in het virtuele netwerk van Microsoft
Er wordt ondersteuning toegevoegd voor tabelaanbevelingen
Hiermee wordt ondersteuning toegevoegd voor het opgeven van de standaarddatabasenaam in een elastisch cluster
Hiermee verwijdert u ondersteuning voor functie voor het afstemmen van parameters
Beschrijvingen verbeteren
Verbetert de metagegevens van lokale definities
Corrigeert HTTP-antwoordcodes om aan te geven wat elke API kan retourneren
2025-01-01-preview Preview Voegt ondersteuning toe voor functie voor het afstemmen van parameters
2024-11-01-preview Preview Indexoptimalisatie
Brontypen toegevoegd voor migratie
PG 17-ondersteuning
ondersteuning voor UltraSSD_LRS opslagtype
Elastische clusters op flexibele serverinstanties
2024-08-01 Stabiel (GA) Eerdere GA-functies +
Geo + CMK - Hernieuwd opgepakt
Automatische groei van opslag
IOPS-schaalaanpassing
Api voor nieuwe locatiemogelijkheden
Langetermijnretentieback-up
Serverlogboeken
Migrations
Migratievoorvalidatie
Leesreplica's - Overschakeling (sitewisseling)
Replica's lezen - Virtuele eindpunten
Privé-eindpunten
Azure Defender/Threat Protection-API's
PG 16-ondersteuning
ondersteuning voor PremiumV2_LRS opslagtype
Locatiefunctiewijzigingen voor SSDv2
Migratierollen
Resource-ID van migratie-instantie ter ondersteuning van migraties van privé-eindpunten
Back-up op aanvraag
Door het systeem toegewezen beheerde identiteit
2023-06-01-preview Preview Eerdere GA-functies +
Migratievoorvalidatie
Leesreplica's - Overschakeling (sitewisseling)
Replica's lezen - Virtuele eindpunten
Privé-eindpunten
Azure Defender\Threat Protection API's
PG 16-ondersteuning
ondersteuning voor PremiumV2_LRS opslagtype
Locatiefunctiewijzigingen voor SSDv2
API voor quotumgebruik
2023-03-01-preview Preview Nieuwe GA-versiefuncties (2022-12-01) +
Geo + CMK
Automatische groei van opslag
IOPS-schaalaanpassing
Api voor nieuwe locatiemogelijkheden
Azure Defender
Serverlogboeken
Migrations
2022-12-01 Stabiel (GA) Eerdere GA-functies +
EntraID
CMK
Backups
Administrators
Replicas
GeoRestore
MVU
2022-05-01-preview Preview CheckMigrationNameAvailability
Migrations
2021-06-01 Stabiel (GA) Eerdere GA-functies +
Server CRUD
CheckNameAvailability
Configuraties (Parameters)
Database
Firewall-regels
Privé
Achtervoegsel van DNS-zone
PITR
Server opnieuw opstarten
Server starten
Server stoppen
Onderhoudsvenster
Subnetgebruik van virtueel netwerk

Lijst van stabiele API-bewerkingen

Elke ondersteunde stabiele API-bewerking en de bijbehorende details worden vermeld in de volgende tabel.

Functie/bewerking Details
Administrators Beheerders van Microsoft Entra ID-servers beheren
Geavanceerde bedreigingsbeveiliging Advanced Threat Protection-instellingen beheren
Backup maken en herstellen Automatische en on-demand serverback-ups beheren
Capabilities Beschikbare servermogelijkheden per locatie en server weergeven
Configurations PostgreSQL-serverparameters weergeven en beheren
Databases Databases maken, lezen, bijwerken, verwijderen en weergeven
Gegevensversleuteling Door de klant beheerde sleutels (CMK) configureren, inclusief versleuteling tussen tenants
Firewallregels Firewallregels maken, lezen, bijwerken, verwijderen en weergeven
Langetermijnbewaring Back-upbewerkingen voor langetermijnretentie beheren
Onderhoudsevenementen Onderhoudsgebeurtenissen op aanvraag weergeven, ophalen, opnieuw plannen en toepassen
Prechecks voor upgrade van hoofdversie Validatiecontroles vóór de upgrade initiëren en validatieresultaten ophalen
Migrations Databasemigratiebewerkingen maken en beheren
Naam beschikbaarheid Beschikbaarheid van server- en virtuele eindpuntnamen controleren
Migratie van netwerkmodus Servers migreren van VNet-integratie naar een netwerkconfiguratie die geschikt is voor Private Link
Operations Beschikbare beheerbewerkingen voor resourceproviders weergeven
Prestaties optimaliseren Afstemmingsopties en aanbevelingen voor databaseoptimalisatie ophalen
Privé-DNS Zone achtervoegsel Het achtervoegsel van de privé-DNS-zone ophalen
Privé-eindpunten Privé-eindpuntverbindingen beheren
Private Link Bronnen Privékoppelingbronnen weergeven
Quotumverbruik Regionale serverquota en gebruiksgegevens ophalen
Leeskopieën Leesreplica's maken en beheren, inclusief promotie en switchover
Servers Servers maken, lezen, bijwerken, verwijderen, weergeven, starten, stoppen en opnieuw opstarten
Virtuele eindpunten Virtuele eindpunten maken en beheren
Gebruik van Virtual Network Subnet Gebruiksgegevens van het subnet van het virtuele netwerk ophalen

Lijst met preview-API-bewerkingen

De volgende tabel bevat elke ondersteunde preview-API-bewerking en de bijbehorende details.

Functie/bewerking Details
Administrators Microsoft Entra ID serverbeheerders maken, ophalen, weergeven en verwijderen
Geavanceerde bedreigingsbeveiliging Geavanceerde instellingen voor bedreigingsbeveiliging ophalen, weergeven en bijwerken
Backup maken en herstellen Back-ups op aanvraag maken, ophalen, vermelden en verwijderen; beschikbare automatische back-ups weergeven
Capabilities Beschikbare servermogelijkheden per locatie en server weergeven
Vastgelegde logboeken Lijst met vastgelegde serverlogbestanden die kunnen worden gedownload
Configurations PostgreSQL-serverparameters ophalen, weergeven en bijwerken
database-agenten Configuraties van databaseagents weergeven, ophalen, inschakelen en uitschakelen
Databases Databases maken, ophalen, weergeven en verwijderen
Gegevensversleuteling Door de klant beheerde sleutels (CMK) configureren, inclusief versleuteling tussen tenants
Firewallregels Firewallregels maken, ophalen, bijwerken, weergeven en verwijderen
Langetermijnbewaring Back-upvereisten valideren, back-ups voor langetermijnretentie initiëren en resultaten van back-upbewerkingen ophalen
Onderhoudsevenementen Onderhoudsgebeurtenissen ophalen en vermelden, filteren op aanstaande of afgelopen status, onderhoud opnieuw plannen en onderhoud onmiddellijk uitvoeren
Prechecks voor upgrade van hoofdversie Validatiecontroles vóór de upgrade initiëren en validatieresultaten ophalen of weergeven
Migrations Databasemigraties maken, ophalen, weergeven, bijwerken en annuleren; beschikbaarheid van migratienaam valideren
Naam beschikbaarheid Beschikbaarheid van server- en virtuele eindpuntnamen globaal of op locatie controleren
Migratie van netwerkmodus Servers migreren van VNet-integratie naar een Private Link-geschikt netwerkmodel
Operations Lijst met beschikbare beheerbewerkingen van resourceproviders
Prestaties optimaliseren Afstemmingsopties en aanbevelingen voor index- of tabeloptimalisatie ophalen
Privé-DNS Zone achtervoegsel Het achtervoegsel van de privé-DNS-zone ophalen
Privé-eindpunten Privé-eindpuntverbindingen ophalen, weergeven, goedkeuren, afwijzen en verwijderen
Private Link Bronnen Private Link-resources ophalen en weergeven
Quotumverbruik Regionaal quotumgebruik voor flexibele servers ophalen
Leeskopieën Leesreplica's maken, weergeven en beheren, waaronder promotie en overschakeling
Servers Servers maken, ophalen, bijwerken, verwijderen en weergeven; servers starten, stoppen en opnieuw opstarten
Opslagbeheer Premium SSD v2 en opslag automatisch vergroten via serveropslageigenschappen configureren
Virtuele eindpunten Virtuele eindpunten maken, ophalen, bijwerken, weergeven en verwijderen
Gebruik van Virtual Network Subnet Gebruiksgegevens van het subnet van het virtuele netwerk ophalen

Preview-versies van API gebruiken vanuit Terraform

Terraform is een softwarehulpprogramma voor infrastructuur als code (IaC) dat is gemaakt door HashiCorp. Gebruikers definiëren en bieden datacentruminfrastructuur met behulp van een declaratieve configuratietaal die bekend staat als HashiCorp Configuration Language (HCL) of optioneel JSON. Terraform is een veelgebruikte manier om IaC-beheer uit te voeren voor Azure Database for PostgreSQL op basis van de GA Azure RM API, naast Azure Resource Manager-sjablonen (ARM) Templates. De Terraform-community brengt regelmatig updates uit voor de Azure Resource Manager (AzureRM) Terraform provider, gebaseerd op de in algemene beschikbaarheid (GA) beschikbare Azure Resource Manager API-versie.

Als een bepaalde functie zich momenteel in een preview-API bevindt en nog niet is opgenomen in de GA-API en De AzureRM Terraform-provider, gebruikt u de AzAPI Terraform-provider om de preview-API rechtstreeks vanuit Terraform aan te roepen. De AzAPI-provider is een dunne laag boven op de Azure Resource Manager REST API's. Met de AzAPI-provider kunt u elk Azure resourcetype beheren met behulp van een API-versie. De AzAPI-provider is een dunne laag boven op de Azure ARM REST API's. Met behulp van de AzAPI-provider kunt u elk Azure resourcetype beheren met behulp van elke API-versie. Deze provider vormt een aanvulling op de AzureRM-provider door het beheer van nieuwe Azure-resources en -eigenschappen in te schakelen (inclusief beperkte preview).

AzAPI-provider biedt de volgende voordelen:

  • Ondersteunt alle Azure-services:
  • Persoonlijke preview-services en -functies
  • Openbare previewdiensten en functies
  • Alle API-versies
  • Volledige kwaliteit van Terraform-statusbestand
  • Eigenschappen en waarden worden opgeslagen in status
  • Geen afhankelijkheid van Swagger
  • Algemene en consistente Azure-verificatie

AzAPI2AzureRM is een opensource-hulpprogramma dat is ontworpen om te migreren van de AzAPI-provider naar de AzureRM-provider.

Contacten

Stuur een e-mailbericht naar het Azure Database for PostgreSQL-team (@Ask Azure Database for PostgreSQL) voor vragen of suggesties die u mogelijk hebt in Azure Database for PostgreSQL. Houd er rekening mee dat dit e-mailadres geen alias voor technische ondersteuning is.

Overweeg ook de volgende aanspreekpunten, indien van toepassing: