Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel enthält die neuesten Neuigkeiten und Updates zu den empfohlenen API-Versionen, die verwendet werden sollen. Die hier nicht aufgeführten API-Versionen werden möglicherweise unterstützt, werden aber in Kürze eingestellt. Die Dokumentation für die neueste Vorschau- und stabile API-Version ist hier verfügbar.
API-Releases
In diesem Abschnitt werden die Featureänderungen in den einzelnen Azure Database for PostgreSQL API-Versionen zusammengefasst.
Hinweis
API-Versionen bauen in der Regel auf früheren Versionen auf, aber Vorschaufeatures können geändert oder entfernt werden. In der Spalte "Versionshinweise" werden die Änderungen für jede Version aufgelistet.
| API-Version | Stabil/Vorschau | Veröffentlichungshinweise |
|---|---|---|
| 2026-10-01 | Stabil (allgemein verfügbar) | Enthält alle Funktionen aus früheren stabilen API-Versionen mit den folgenden Ergänzungen: Wartungsmanagement: Unterstützung für die Neuplanung geplanter Wartung, Anwenden verfügbarer Wartungsupdates bei Bedarf, Anzeigen anstehender Wartung und Abrufen des Wartungsverlaufs. Netzwerk: Unterstützung für die Migration von Servern von der VNet-Integration (Virtual Network) zu öffentlichem Zugriff und Netzwerkkonnektivität mit Unterstützung für private Endpunkte. FIPS-Compliance: Unterstützung für das Erstellen von Servern mit aktiviertem FIPS und Aktivieren oder Deaktivieren von FIPS auf vorhandenen Servern. Immutable Backups: Unterstützung zum Erstellen von Servern mit aktivierten Immutable Backups. Hauptversionsupgrades: Unterstützung für die Ausführung von Überprüfungen vor dem Upgrade vor dem Initiieren eines PostgreSQL-Hauptversionsupgrades. Autonome Optimierung: Fügt vacuumTable als unterstützte autonome Optimierungsoption hinzu.Mandantenübergreifende vom Kunden verwaltete Schlüssel (CMK): Unterstützung für die Konfiguration der mandantenübergreifenden Verschlüsselung mithilfe von vom Kunden verwalteten Schlüsseln mit oder ohne aktivierte georedundante Sicherungen. Flexibilität der PostgreSQL-Version: Entfernt die Enumerationseinschränkung der PostgreSQL-Version, sodass Servererstellungs- und Hauptversionsupgrades neu veröffentlichte PostgreSQL-Versionen unterstützen können, ohne dass ein API-Schemaupdate erforderlich ist. |
| 2026-07-01-Vorschau | Vorschau | Umfasst alle Funktionen aus früheren API-Versionen mit den folgenden Ergänzungen: PostgreSQL 19: Fügt der unterstützten PostgresMajorVersion Enumeration PostgreSQL, Version 19, hinzu.Datenbank-Agent (DBAgent): Führt eine neue DBAgent-Ressource und zugeordnete Verwaltungsvorgänge ein. Speicherverwaltung: Fügt neue Speichereigenschaften hinzu, um die Premium SSD v2- und Speicher-Autogrow-Konfiguration zu unterstützen. |
| 2026-04-01-Vorschau | Vorschau | Umfasst alle Funktionen aus früheren API-Versionen mit den folgenden Ergänzungen: Wartungsmanagement: Führt die MaintenanceEvent API mit Vorgängen ein, um Wartungsereignisdetails abzurufen, Wartungsereignisse nach Server aufzulisten, geplante Wartung neu zu planen und verfügbare Wartungsupdates bei Bedarf anzuwenden.Vorabprüfungen für das Upgrade der Hauptversion: Führt die MajorVersionUpgradePrecheck-API mit den Vorgängen „Abrufen nach Server“ und „Auflisten nach Server“ ein, zusammen mit einem neuen MajorVersionUpgradePrecheck-Vorgang in der Server-API, um Vorabprüfungen vor dem Upgrade zu initiieren.Mandantenübergreifende vom Kunden verwaltete Schlüssel (CMK): Fügt der Servers-API die Eigenschaften geoBackupFederatedIdentityClientId und primaryFederatedIdentityClientId hinzu, um die mandantenübergreifende Datenverschlüsselung mithilfe von vom Kunden verwalteten Schlüsseln zu unterstützen. |
| 2026-01-01-Vorschau | Vorschau | Enthält alle Funktionen aus früheren API-Versionen mit folgendem Zusatz: Netzwerk: Unterstützung für die Migration von Servern von der VNet-Integration (Virtual Network) zu öffentlichem Zugriff und privaten endpunktfähigen Netzwerken. |
| 2025-08-01 | Stabil (allgemein verfügbar) | Frühere allgemein verfügbare Features + Unterstützung für PG 18 Unterstützung für PG 17 Fügt Unterstützung für die Angabe des Standarddatenbanknamens in einem Elastic Cluster hinzu. Fügt Unterstützung für Tabellenempfehlungen hinzu. Korrigiert HTTP-Antwortcodes, um widerzuspiegeln, was jede API zurückgeben kann Fügt ein Beispiel für die CMK-basierte Datenverschlüsselung mit automatischer Aktualisierung der Schlüsselversion hinzu. Fügt beispiel für die Erstellung von Servern in einem virtuellen Microsoft-Netzwerk hinzu Benennt Dateien um, um ihre Inhalte besser darzustellen. Benennt Vorgangs-IDs um, um Die Organisation, Klarheit und Navigation zu verbessern Verbessert metadaten von lokalen Definitionen Verbessert Beschreibungen für Konsistenz |
| 2025-06-01-preview | Vorschau | Benennt Dateien um, um ihre Inhalte besser darzustellen. Benennt Vorgänge um, um Die Organisation, Klarheit und Navigation zu verbessern Fügt ein Beispiel für die CMK-basierte Datenverschlüsselung mit automatischer Aktualisierung der Schlüsselversion hinzu. Fügt beispiel für die Erstellung von Servern in einem virtuellen Microsoft-Netzwerk hinzu Fügt Unterstützung für Tabellenempfehlungen hinzu. Fügt Unterstützung für die Angabe des Standarddatenbanknamens in einem Elastic Cluster hinzu. Entfernt die Unterstützung für die Parameteroptimierungsfunktion. Verbessert Beschreibungen Verbessert metadaten von lokalen Definitionen Korrigiert HTTP-Antwortcodes, um widerzuspiegeln, was jede API zurückgeben kann |
| 2025-01-01-preview | Vorschau | Fügt Unterstützung für die Parameteroptimierungsfunktion hinzu. |
| 2024-11-01-preview | Vorschau | Indexoptimierung Quelltypen für die Migration hinzugefügt PG 17-Unterstützung Unterstützung von UltraSSD_LRS Speichertypen Elastische Cluster auf flexiblen Serverinstanzen |
| 2024-08-01 | Stabil (allgemein verfügbar) | Frühere allgemein verfügbare Features + Geo + CMK – Wiederaktivierung verworfen Automatische Speichervergrößerung IOPS-Skalierung API der neuen Standortfunktion Sicherung mit Langzeitaufbewahrung Serverprotokolle Migrations Vorgelagerte Migrationsüberprüfung Lesereplikate – Switchover (Standorttausch) Lesereplikate – Virtuelle Endpunkte Private Endpunkte Azure Defender/Threat Protection APIs PG 16-Unterstützung Unterstützung von PremiumV2_LRS Speichertypen Änderungen der Standortfunktion für SSDv2 Migrationsrollen Migrationsinstanzressourcen-ID zur Unterstützung der Migration privater Endpunkte Bedarfsgesteuerte Sicherung Systemzugewiesene verwaltete Identität |
| 2023-06-01-preview | Vorschau | Frühere allgemein verfügbare Features + Vorabüberprüfung bei der Migration Lesereplikate – Switchover (Standorttausch) Lesereplikate – Virtuelle Endpunkte Private Endpunkte Azure Defender für Bedrohungsschutz-APIs PG 16-Unterstützung Unterstützung von PremiumV2_LRS Speichertypen Änderungen der Standortfunktion für SSDv2 Kontingentbedarf-API |
| 2023-03-01-preview | Vorschau | Neue Features der allgemein verfügbaren Version (2022-12-01) + Geo + CMK Automatische Speichervergrößerung IOPS-Skalierung API der neuen Standortfunktion Azure Defender Serverprotokolle Migrations |
| 2022-12-01 | Stabil (allgemein verfügbar) | Frühere allgemein verfügbare Features + EntraID CMK Backups Administratoren Replicas GeoRestore MVU |
| 2022-05-01-preview | Vorschau | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Stabil (allgemein verfügbar) | Frühere allgemein verfügbare Features + Server CRUD CheckNameAvailability Konfigurationen (Parameter) Datenbank Firewallregeln Privat Suffix der DNS-Zone PITR Neustarten des Servers Starten des Servers Beenden des Servers Wartungsfenster Verwendung des Subnetzes des virtuellen Netzwerks |
Liste der stabilen API-Vorgänge
Jeder unterstützte stabile API-Vorgang und seine Details sind in der folgenden Tabelle aufgeführt.
| Funktion/Vorgang | Details |
|---|---|
| Administratoren | Verwalten von Microsoft Entra ID Serveradministratoren |
| Erweiterter Bedrohungsschutz | Verwalten erweiterter Einstellungen für den Bedrohungsschutz |
| Sichern und Wiederherstellen | Automatische und On-Demand-Serversicherungen verwalten |
| Fähigkeiten | Auflisten der verfügbaren Serverfunktionen nach Standort und Server |
| Configurations | Anzeigen und Verwalten von PostgreSQL-Serverparametern |
| Datenbanken | Erstellen, lesen, aktualisieren, löschen und Datenbanken auflisten |
| Datenverschlüsselung | Konfigurieren Sie kundenseitig verwaltete Schlüssel (CMK), einschließlich mandantenübergreifender Verschlüsselung |
| Firewall-Regeln | Erstellen, Lesen, Aktualisieren, Löschen und Auflisten von Firewallregeln |
| Langzeitaufbewahrung | Verwalten von Vorgängen zur Langzeitaufbewahrung von Backups |
| Wartungsereignisse | Auflisten, Abrufen, Neu planen und Anwenden von Wartungsereignissen bei Bedarf |
| Vorabprüfungen für das Upgrade auf eine Hauptversion | Initiieren von Überprüfungen vor dem Upgrade und Abrufen von Validierungsergebnissen |
| Migrations | Erstellen und Verwalten von Datenbankmigrationsvorgängen |
| Namensverfügbarkeit | Überprüfen der Verfügbarkeit des Servers und des Namens des virtuellen Endpunkts |
| Migration des Netzwerkmodus | Server aus der VNet-Integration zu einer Private Link-fähigen Netzwerkkonfiguration migrieren |
| Operationen | Auflisten verfügbarer Ressourcenanbieterverwaltungsvorgänge |
| Leistungsoptimierung | Abrufen von Tuningoptionen und Empfehlungen zur Datenbankoptimierung |
| Suffix der privaten DNS-Zone | Privates DNS-Zonensuffix abrufen |
| Private Endpunkte | Verwalten von Verbindungen mit dem privaten Endpunkt |
| Private Link-Ressourcen | Auflisten von Private Link-Ressourcen |
| Kontingentverwendung | Regionale Serverkontingent- und Nutzungsinformationen abrufen |
| Lesereplikate | Erstellen und Verwalten von Lesereplikaten, einschließlich Heraufstufung und Switchover |
| Servers | Erstellen, Lesen, Aktualisieren, Löschen, Auflisten, Starten, Beenden und Neustarten von Servern |
| Virtuelle Endpunkte | Erstellen und Verwalten virtueller Endpunkte |
| Subnetznutzung im virtuellen Netzwerk | Abrufen von Nutzungsinformationen für Subnetze virtueller Netzwerke |
Vorschau der API-Vorgangsliste
In der folgenden Tabelle sind die einzelnen unterstützten Vorschau-API-Vorgänge und deren Details aufgeführt.
| Funktion/Vorgang | Details |
|---|---|
| Administratoren | Erstellen, Abrufen, Auflisten und Löschen von Microsoft Entra ID-Serveradministratoren |
| Erweiterter Bedrohungsschutz | Abrufen, Auflisten und Aktualisieren erweiterter Bedrohungsschutzeinstellungen |
| Sichern und Wiederherstellen | Erstellen, Abrufen, Auflisten und Löschen von On-Demand-Sicherungen; verfügbare automatische Sicherungen auflisten |
| Fähigkeiten | Auflisten der verfügbaren Serverfunktionen nach Standort und Server |
| Erfasste Protokolle | Erfasste Serverprotokolle auflisten, die zum Download verfügbar sind |
| Configurations | Abrufen, Auflisten und Aktualisieren von PostgreSQL-Serverparametern |
| Datenbank-Agenten | Auflisten, Abrufen, Aktivieren und Deaktivieren von Datenbank-Agent-Konfigurationen |
| Datenbanken | Erstellen, Abrufen, Auflisten und Löschen von Datenbanken |
| Datenverschlüsselung | Konfigurieren von vom Kunden verwalteten Schlüsseln (CMK), einschließlich mandantenübergreifender Verschlüsselung |
| Firewall-Regeln | Erstellen, Abrufen, Aktualisieren, Auflisten und Löschen von Firewallregeln |
| Langzeitaufbewahrung | Überprüfen der Sicherungsvoraussetzungen, Initiieren langfristiger Aufbewahrungssicherungen und Abrufen von Sicherungsvorgangsergebnissen |
| Wartungsereignisse | Abrufen und Auflisten von Wartungsereignissen, Filtern nach anstehendem oder vergangenem Status, Neuplanung der Wartung und sofortiges Anwenden von Wartung |
| Vorabprüfungen für das Hauptversions-Upgrade | Validierungsprüfungen vor dem Upgrade initiieren und Validierungsergebnisse abrufen oder auflisten |
| Migrations | Erstellen, Abrufen, Auflisten, Aktualisieren und Abbrechen von Datenbankmigrationen; Überprüfen der Verfügbarkeit von Migrationsnamen |
| Namensverfügbarkeit | Überprüfen der Verfügbarkeit des Servers und des Namens des virtuellen Endpunkts global oder nach Standort |
| Migration des Netzwerkmodus | Migrieren von Servern aus der VNet-Integration zu einem Private Link fähigen Netzwerkmodell |
| Operationen | Auflisten verfügbarer Ressourcenanbieterverwaltungsvorgänge |
| Leistungsoptimierung | Abrufen von Tuningoptionen und Empfehlungen zur Index- oder Tabellenoptimierung |
| Privater DNS-Zonen-Suffix | Suffix der privaten DNS-Zone abrufen |
| Private Endpunkte | Abrufen, Auflisten, Genehmigen, Ablehnen und Löschen privater Endpunktverbindungen |
| Private Link-Ressourcen | Abrufen und Auflisten privater Linkressourcen |
| Kontingentverwendung | Abrufen der regionalen Kontingentnutzung für flexible Server |
| Lesereplikate | Erstellen, auflisten und verwalten Sie Lesereplikate, einschließlich Heraufstufung und Switchover |
| Servers | Erstellen, Abrufen, Aktualisieren, Löschen und Auflisten von Servern; Starten, Beenden und Neustarten von Servern |
| Speicherverwaltung | Konfigurieren der automatischen Speichererweiterung von Premium SSD v2 über Serverspeichereigenschaften |
| Virtuelle Endpunkte | Erstellen, Abrufen, Aktualisieren, Auflisten und Löschen virtueller Endpunkte |
| Nutzung von Subnetzen im virtuellen Netzwerk | Abrufen von Subnetznutzungsinformationen für ein virtuelles Netzwerk |
Verwenden von Vorschauversionen der API aus Terraform
Terraform ist ein von HashiCorp erstelltes IaC-Softwaretool (Infrastructure-as-Code). Benutzer nutzen für die Definition und Bereitstellung der Rechenzentrumsinfrastruktur eine deklarative Konfigurationssprache, die als HashiCorp Configuration Language (HCL) bezeichnet wird. Optional wird JSON verwendet. Terraform ist eine gängige Möglichkeit, die IaC-Verwaltung für Azure Database für PostgreSQL basierend auf der GA Azure RM API durchzuführen, zusätzlich zu Azure Resource Manager (ARM) Templates. Die Terraform Community veröffentlicht regelmäßig Updates für den Azure Resource Manager (AzureRM) Terraform-Anbieter, basierend auf der Azure Resource Manager API-Version, die allgemein verfügbar ist (GA).
Wenn sich ein bestimmtes Feature derzeit in einer Vorschau-API befindet und noch nicht in die GA-API und den AzureRM Terraform provider integriert ist, verwenden Sie den AzAPI Terraform-Anbieter, um die Vorschau-API direkt aus Terraform aufzurufen. Der AzAPI-Anbieter ist eine dünne Schicht über den Azure Resource Manager-REST-APIs. Mit dem AzAPI-Anbieter können Sie jeden Azure Ressourcentyp mithilfe einer beliebigen API-Version verwalten. Der AzAPI-Anbieter ist eine dünne Schicht über den ARM-REST-APIs. Mithilfe des AzAPI-Anbieters können Sie jeden beliebigen Azure-Ressourcentyp mit jeder beliebigen API-Version verwalten. Dieser Anbieter ergänzt den AzureRM-Anbieter, indem er die Verwaltung neuer Azure-Ressourcen und -Eigenschaften (einschließlich der privaten Vorschau) ermöglicht.
Der AzAPI-Anbieter bietet die folgenden Vorteile:
- Unterstützung aller Azure-Dienste
- Dienste und Features der privaten Vorschau
- Dienste und Features der öffentlichen Vorschau
- Alle API-Versionen
- Terraform-Zustandsdatei mit vollständiger Genauigkeit
- Speicherung von Eigenschaften und Werten im Zustand
- Keine Abhängigkeit von Swagger
- Allgemeine und konsistente Azure-Authentifizierung
AzAPI2AzureRM ist ein Open Source-Tool, das zur Migration vom AzAPI-Anbieter zum AzureRM-Anbieter entwickelt wurde.
Kontakte
Bei Fragen oder Vorschlägen zu Azure Database for PostgreSQL senden Sie bitte eine E-Mail an das Azure Database for PostgreSQL Team (@Ask Azure Database for PostgreSQL). Hinweis: Bei dieser E-Mail-Adresse handelt es sich nicht um einen Alias für den technischen Support.
Zusätzlich sollten Sie je nach Bedarf die folgenden Kontaktmöglichkeiten in Betracht ziehen:
- Wenn Sie den Azure-Support kontaktieren möchten, fordern Sie im Azure-Portal ein Ticket an.
- Um ein Problem mit Ihrem Konto zu beheben, richten Sie im Azure-Portal eine Anfrage an den Support.
- Wenn Sie Feedback abgeben oder Vorschläge für neue Features einreichen möchten, erstellen Sie einen Eintrag über UserVoice.