Versionsinformation för REST-API:erna för Azure Database for PostgreSQL flexibel server

Den här artikeln innehåller de senaste nyheterna och uppdateringarna om de rekommenderade API-versionerna som ska användas. API-versionerna som inte visas här kan fortfarande stödjas, men kommer snart att dras tillbaka. Dokumentationen för den senaste förhandsversionen och den stabila API-versionen finns här.

API-utgåvor

Det här avsnittet sammanfattar funktionsändringarna för varje Azure Database for PostgreSQL API-version.

Note

API-versioner bygger vanligtvis på tidigare versioner, men förhandsversionsfunktioner kan ändras eller tas bort. I kolumnen Versionsinformation visas ändringarna för varje version.

API-version Standardversion/Förhandsgranskning Versionsanteckningar
2026-10-01 Stabil (GA) Innehåller alla funktioner från tidigare stabila API-versioner med följande tillägg:

Underhållshantering: Stöd för omplanering av planerat underhåll, tillämpning av tillgängliga underhållsuppdateringar på begäran, visning av kommande underhåll och hämtning av underhållshistorik.

Nätverk: Stöd för migrering av servrar från integrering av virtuella nätverk (VNet) till offentlig åtkomst och privata slutpunktskompatibla nätverk.

FIPS-efterlevnad: Stöd för att skapa servrar med FIPS aktiverat och aktivera eller inaktivera FIPS på befintliga servrar.

Oföränderliga säkerhetskopior: Stöd för att skapa servrar med oföränderliga säkerhetskopieringar aktiverade.

Större versionsuppgraderingar: Stöd för att köra valideringskontroller före uppgradering innan du påbörjar en större PostgreSQL-versionsuppgradering.

Autonom trimning: Lägger till vacuumTable som ett autonomt trimningsalternativ som stöds.

Kundhanterade nycklar för flera klientorganisationer (CMK): Stöd för att konfigurera kryptering mellan klientorganisationer med kundhanterade nycklar, med eller utan geo-redundanta säkerhetskopieringar aktiverade.

Flexibilitet för PostgreSQL-version: Tar bort uppräkningsbegränsningen för PostgreSQL-versionen, vilket gör att serverskapande och större versionsuppgraderingar kan stödja nyligen släppta PostgreSQL-versioner utan att kräva en API-schemauppdatering.
2026-07-01-förhandsvisning Preview Innehåller alla funktioner från tidigare API-versioner med följande tillägg:

PostgreSQL 19: Lägger till PostgreSQL version 19 i den uppräkning som stöds PostgresMajorVersion .

Databasagent (DBAgent): Introducerar en ny DBAgent-resurs och tillhörande hanteringsåtgärder.

Lagringshantering: Lägger till nya lagringsegenskaper för att stödja Premium SSD v2 och konfiguration av automatisk lagringstillväxt.
2026-04-01-förhandsvisning Preview Innehåller alla funktioner från tidigare API-versioner med följande tillägg:

Underhållshantering: Introducerar API:et MaintenanceEvent med åtgärder för att hämta information om underhållshändelser, lista underhållshändelser per server, schemalägga om planerat underhåll och tillämpa tillgängliga underhållsuppdateringar på begäran.

Förhandskontroller för huvudversionsuppgradering: Introducerar API:et MajorVersionUpgradePrecheck med Get- och List by Server-åtgärderna, tillsammans med en ny MajorVersionUpgradePrecheck åtgärd i Servers-API:et för att initiera verifieringskontroller före uppgraderingen.

Kundhanterade nycklar för flera klienter (CMK): Lägger till primaryFederatedIdentityClientId och geoBackupFederatedIdentityClientId egenskaper för server-API:et för att stödja datakryptering mellan klienter med hjälp av kundhanterade nycklar.
2026-01-01-förhandsvisning Preview Innehåller alla funktioner från tidigare API-versioner med följande tillägg:

Nätverk: Stöd för migrering av servrar från integrering av virtuella nätverk (VNet) till offentlig åtkomst och nätverk med stöd för privata slutpunkter.
2025-08-01 Stabil (GA) Tidigare GA-funktioner +
Stöd för PG 18
Stöd för PG 17
Lägger till stöd för att ange standarddatabasnamnet i ett elastiskt kluster
Lägger till stöd för tabellrekommendationer
Korrigerar HTTP-svarskoder för att återspegla vad varje API kan returnera
Lägger till exempel för CMK-baserad datakryptering med automatisk uppdatering av nyckelversion
Lägger till exempel för att skapa en server i ett microsoftägt virtuellt nätverk
Byter namn på filer för bättre representation av innehållet
Byter namn på åtgärds-ID:t för att förbättra organisationen, tydligheten och navigeringen
Förbättrar metadata för lokala definitioner
Förbättrar beskrivningar för enhetlighet
2025-06-01-preview Preview Byter namn på filer för bättre representation av innehållet
Byter namn på åtgärder för att förbättra organisationen, tydligheten och navigeringen
Lägger till exempel för CMK-baserad datakryptering med automatisk uppdatering av nyckelversion
Lägger till exempel för att skapa en server i ett microsoftägt virtuellt nätverk
Lägger till stöd för tabellrekommendationer
Lägger till stöd för att ange standarddatabasnamnet i ett elastiskt kluster
Tar bort stöd för parameterjusteringsfunktionen
Förbättrar beskrivningar
Förbättrar metadata för lokala definitioner
Korrigerar HTTP-svarskoder för att återspegla vad varje API kan returnera
2025-01-01-preview Preview Lägger till stöd för parameterjusteringsfunktionen
2024-11-01-preview Preview Indexoptimering
Källtyper för migrering har lagts till
Stöd för PG 17
stöd för UltraSSD_LRS lagringstyp
Elastiska kluster på flexibla serverinstanser
2024-08-01 Stabil (GA) Tidigare GA-funktioner +
Geo + CMK – Återuppliva tappade
Automatisk tillväxt för lagring
IOPS-skalning
Api för ny platsfunktion
Långsiktig kvarhållningssäkerhetskopiering
Serverloggar
Migrations
Förvalidering av migrering
Läsrepliker – Omkoppling (byte av plats)
Läs repliker – virtuella slutpunkter
Privata slutpunkter
Api:er för Azure Defender/Threat Protection
Stöd för PG 16
stöd för PremiumV2_LRS lagringstyp
Platskapacitetsändringar för SSDv2
Migreringsroller
Migreringsinstansresurs-ID för att stödja privata slutpunktsmigreringar
Säkerhetskopiering på begäran
Systemtilldelad managerad identitet
2023-06-01-preview Preview Tidigare GA-funktioner +
Förvalidation för migrering
Läsrepliker – Omkoppling (byte av plats)
Läs repliker – virtuella slutpunkter
Privata slutpunkter
API:er för Azure Defender\Threat Protection
Stöd för PG 16
stöd för PremiumV2_LRS lagringstyp
Platskapacitetsändringar för SSDv2
API för kvotanvändning
2023-03-01-preview Preview Nya GA-versionfunktioner (2022-12-01) +
Geo + CMK
Automatisk tillväxt för lagring
IOPS-skalning
API för ny platsfunktion
Azure Defender
Serverloggar
Migrations
2022-12-01 Stabil (GA) Tidigare GA-funktioner +
EntraID
CMK
Backups
Administrators
Replicas
GeoRestore
MVU
2022-05-01-preview Preview KontrolleraMigreringsnamntillgänglighet
Migrations
2021-06-01 Stabil (GA) Tidigare GA-funktioner +
Server CRUD
KontrolleraNamntillgänglighet
Konfigurationer (parametrar)
Database
Brandväggsregler
Privat
DNS-zonsuffix
PITR (återställning till en specifik tidpunkt)
Omstart av server
Serverstart
Serverstopp
Underhållsfönster
Användning av undernät för virtuellt nätverk

Lista över stabila API-åtgärder

Varje stabil API-åtgärd som stöds och dess information visas i följande tabell.

Funktion/åtgärd Detaljer
Administrators Hantera Microsoft Entra ID serveradministratörer
Avancerat skydd mot hot Hantera avancerade inställningar för avancerat hotskydd
Säkerhetskopiering & Återställning Hantera automatiska och behovsstyrda serversäkerhetskopior
Kapaciteter Visa en lista över tillgängliga serverfunktioner efter plats och server
Configurations Visa och hantera PostgreSQL-serverparametrar
Databaser Skapa, läs, uppdatera, ta bort och lista databaser
Datakryptering Konfigurera kundhanterade nycklar (CMK), inklusive kryptering mellan klientorganisationer
Brandväggsregler Skapa, läs, uppdatera, ta bort och lista brandväggsregler
Långsiktigt bevarande Hantera säkerhetskopieringsåtgärder för långsiktig kvarhållning
Underhållshändelser Lista, hämta, schemalägga om och köra underhållshändelser vid behov
Förhandskontroller för huvudversionsuppgradering Initiera valideringskontroller före uppgraderingen och hämta valideringsresultat
Migrations Skapa och hantera databasmigreringsoperationer
Namn Tillgänglighet Kontrollera tillgängligheten för server- och virtuella slutpunktsnamn
Migrering av nätverksläge Migrera servrar från VNet-integrering till en Private Link-kompatibel nätverkskonfiguration
Operations Lista tillgängliga hanteringsåtgärder för resursprovider
Prestandaoptimering Hämta justeringsalternativ och rekommendationer för databasoptimering
Privat DNS-zonsuffix Hämta suffixet för den privata DNS-zonen
Privata slutpunkter Hantera privata slutpunktsanslutningar
Private Link-resurser Lista resurser för privat länk
Kvotanvändning Hämta kvot för regional server och användningsinformation
Läsa repliker Skapa och hantera läsrepliker, inklusive promotering och rollbyte
Servers Skapa, läsa, uppdatera, ta bort, lista, starta, stoppa och starta om servrar
Virtuella slutpunkter Skapa och hantera virtuella slutpunkter
Virtual Network Subnet-användning Hämta användningsinformation för undernät för virtuella nätverk

Förhandsgranska API-åtgärdslista

I följande tabell visas varje api-åtgärd för förhandsversion som stöds och dess information.

Funktion/åtgärd Detaljer
Administrators Skapa, hämta, lista och ta bort Microsoft Entra ID serveradministratörer
Avancerat skydd mot hot Hämta, lista och uppdatera inställningar för avancerat hotskydd
Säkerhetskopiering & Återställning Skapa, hämta, lista och ta bort säkerhetskopieringar på begäran; lista tillgängliga automatiska säkerhetskopieringar
Kapaciteter Visa en lista över tillgängliga serverfunktioner efter plats och server
Samlade loggar Lista insamlade serverloggar som är tillgängliga för nedladdning
Configurations Hämta, lista och uppdatera PostgreSQL-serverparametrar
Databasagenter Lista, hämta, aktivera och inaktivera databasagentkonfigurationer
Databaser Skapa, hämta, lista och ta bort databaser
Datakryptering Konfigurera kundhanterade nycklar (CMK), inklusive kryptering mellan klientorganisationer
Brandväggsregler Skapa, hämta, uppdatera, lista och ta bort brandväggsregler
Långsiktigt bevarande Validera förutsättningar för säkerhetskopiering, initiera säkerhetskopior för långtidslagring och hämta resultat av säkerhetskopieringsåtgärden
Underhållshändelser Hämta och lista underhållshändelser, filtrera efter kommande eller tidigare status, boka om underhåll och utför underhåll omedelbart
Förhandskontroller för huvudversionsuppgradering Initiera valideringskontroller före uppgraderingen och hämta eller visa valideringsresultat
Migrations Skapa, hämta, lista, uppdatera och avbryta databasmigreringar. verifiera tillgängligheten för migreringsnamn
Namn Tillgänglighet Kontrollera tillgängligheten för server- och virtuella slutpunktsnamn globalt eller per plats
Migrering av nätverksläge Migrera servrar från VNet-integrering till en Private Link-kompatibel nätverksmodell
Operations Lista tillgängliga hanteringsåtgärder för resursprovider
Prestandaoptimering Hämta justeringsalternativ och rekommendationer för index- eller tabelloptimering
Privat DNS-zonssuffix Hämta suffixet för den privata DNS-zonen
Privata slutpunkter Hämta, lista, godkänna, avvisa och ta bort privata slutpunktsanslutningar
Private Link-resurser Hämta och lista privata länkresurser
Kvotanvändning Hämta regional kvotanvändning för flexibla servrar
Läsa repliker Skapa, lista och hantera läsrepliker, inklusive uppgradering och växling
Servers Skapa, hämta, uppdatera, ta bort och lista servrar; starta, stoppa och starta om servrar
Lagringshantering Konfigurera Premium SSD v2 och automatisk lagringsökning via serverlagringsegenskaper
Virtuella slutpunkter Skapa, hämta, uppdatera, lista och ta bort virtuella slutpunkter
Virtual Network Subnet-användning Hämta användningsinformation för undernät för virtuellt nätverk

Använda förhandsversioner av API från Terraform

Terraform är ett IaC-programvaruverktyg (infrastructure-as-code) som skapats av HashiCorp. Användare definierar och tillhandahåller datacenterinfrastruktur med hjälp av ett deklarativt konfigurationsspråk som kallas HashiCorp Configuration Language (HCL) eller eventuellt JSON. Terraform är ett vanligt sätt att utföra IaC-hantering för Azure Database for PostgreSQL baserat på GA Azure RM API, utöver Azure Resource Manager-mallar (ARM) Terraform Community släpper regelbundna uppdateringar för Azure Resource Manager (AzureRM) Terraform-provider baserat på Azure Resource Manager API-version i Allmänt tillgänglighet (GA).

Om en viss funktion för närvarande finns i ett förhandsversions-API och ännu inte har införlivats i GA-API:et och AzureRM Terraform-providern, använder du AzAPI Terraform-providern för att anropa förhandsversions-API:et direkt från Terraform. AzAPI-providern är ett tunt lager ovanpå Rest-API:erna för Azure Resource Manager. Med AzAPI-providern kan du hantera alla Azure resurstyper med hjälp av valfri API-version. AzAPI-providern är ett tunt lager ovanpå Azure ARM REST-API:erna. Genom att använda AzAPI-providern kan du hantera valfri Azure resurstyp med valfri API-version. Den här providern kompletterar AzureRM-providern genom att aktivera hantering av nya Azure-resurser och egenskaper (inklusive privat förhandsversion).

AzAPI-providern har följande fördelar:

  • Stöder alla Azure-tjänster:
  • Tjänster och funktioner för privat förhandsversion
  • Tjänster och funktioner för offentlig förhandsversion
  • Alla API-versioner
  • Fullständig trohet i Terraform-tillståndsfilen
  • Egenskaper och värden lagras i state
  • Inget beroende av Swagger
  • Vanlig och konsekvent Azure-autentisering

AzAPI2AzureRM är ett verktyg med öppen källkod som är utformat för att migrera från AzAPI-providern till AzureRM-providern.

Kontakter

Om du har frågor eller förslag på Azure Database for PostgreSQL skickar du ett e-postmeddelande till Azure Database for PostgreSQL-teamet (@Ask Azure Database for PostgreSQL). Observera att den här e-postadressen inte är ett tekniskt supportalias.

Tänk dessutom på följande kontaktpunkter efter behov:

Relaterat innehåll

  • Uppdaterades senast