Informacje o wersji interfejsów API REST dla serwera elastycznego Azure Database for PostgreSQL

Ten artykuł zawiera najnowsze informacje i aktualizacje dotyczące zalecanych wersji interfejsu API do użycia. Wersje interfejsu API, które nie są wymienione tutaj, mogą być obsługiwane, ale wkrótce zostaną wycofane. Dokumentację najnowszej wersji zapoznawczej i stabilnej wersji interfejsu API znajdziesz tutaj.

Wersje interfejsu API

W tej sekcji podsumowano zmiany funkcji w każdej wersji interfejsu API Azure Database for PostgreSQL.

Note

Wersje interfejsu API zwykle są oparte na wcześniejszych wersjach, ale funkcje w wersji zapoznawczej mogą ulec zmianie lub usunięciu. Kolumna Informacje o wersji zawiera listę zmian dla każdej wersji.

wersja API Stabilna/Wersja zapoznawcza Notatki o wydaniu
2026-10-01 Stabilna (GA) Obejmuje wszystkie możliwości z poprzednich stabilnych wersji interfejsu API z następującymi dodatkami:

Zarządzanie konserwacją: Obsługa zmiany harmonogramu planowanej konserwacji, stosowanie dostępnych aktualizacji konserwacji na żądanie, wyświetlanie nadchodzącej konserwacji i pobieranie historii konserwacji.

Sieć: Obsługa migracji serwerów z integracji z siecią wirtualną (VNet) do dostępu publicznego i sieci obsługującej prywatne punkty końcowe.

Zgodność ze standardem FIPS: Obsługa tworzenia serwerów z włączonym standardem FIPS i włączaniem lub wyłączaniem protokołu FIPS na istniejących serwerach.

Niezmienne kopie zapasowe: Obsługa tworzenia serwerów z włączonymi niezmiennymi kopiami zapasowymi.

Uaktualnienia wersji głównej: Obsługa uruchamiania sprawdzeń weryfikacyjnych przed uaktualnieniem do nowej wersji głównej przed zainicjowaniem uaktualnienia wersji głównej bazy danych PostgreSQL.

Dostrajanie autonomiczne: Dodaje vacuumTable jako obsługiwaną opcję dostrajania autonomicznego.

Klucze zarządzane przez klienta między dzierżawami (CMK): Obsługa konfigurowania szyfrowania między dzierżawami przy użyciu kluczy zarządzanych przez klienta z włączonymi lub wyłączonymi geograficznie nadmiarowymi kopiami zapasowymi.

Elastyczność wersji bazy danych PostgreSQL: Usuwa ograniczenie wyliczania wersji postgreSQL, co umożliwia tworzenie serwera i uaktualnienia wersji głównej w celu obsługi nowo wydanych wersji bazy danych PostgreSQL bez konieczności aktualizowania schematu interfejsu API.
2026-07-01-preview Preview Obejmuje wszystkie możliwości z poprzednich wersji interfejsu API z następującymi dodatkami:

PostgreSQL 19: Dodaje PostgreSQL w wersji 19 do obsługiwanej PostgresMajorVersion enumeracji.

Agent bazy danych (DBAgent): Wprowadza nowy zasób DBAgent i skojarzone operacje zarządzania.

Zarządzanie pamięcią masową: Dodaje nowe właściwości pamięci masowej, aby obsługiwać Premium SSD v2 i konfigurację automatycznego zwiększania pamięci masowej.
2026-04-01-preview Preview Obejmuje wszystkie możliwości z poprzednich wersji interfejsu API z następującymi dodatkami:

Zarządzanie konserwacją: Wprowadza interfejs API z operacjami MaintenanceEvent umożliwiającymi pobieranie szczegółów zdarzeń konserwacji, wyświetlanie listy zdarzeń konserwacji według serwera, zmianę terminu zaplanowanej konserwacji oraz stosowanie dostępnych aktualizacji konserwacji na żądanie.

Wstępne sprawdzanie uaktualnienia wersji głównej: Wprowadza interfejs API MajorVersionUpgradePrecheck z operacjami Get i List by Server wraz z nową MajorVersionUpgradePrecheck operacją w interfejsie API serwerów w celu zainicjowania testów weryfikacji przed uaktualnieniem.

Klucze zarządzane przez klienta między dzierżawami (CMK): Dodanie właściwości primaryFederatedIdentityClientId i geoBackupFederatedIdentityClientId do interfejsu API serwerów w celu obsługi szyfrowania danych między dzierżawami przy użyciu kluczy zarządzanych przez klienta.
Zapowiedź 1 listopada 2026 Preview Obejmuje wszystkie możliwości z poprzednich wersji interfejsu API z następującym dodatkiem:

Sieć: Obsługa migracji serwerów z integracji z siecią wirtualną (VNet) do sieci publicznej i sieci obsługującej prywatne punkty końcowe.
2025-08-01 Stabilna (GA) Wcześniejsze funkcje ogólnej dostępności
Obsługa PG 18
Obsługa PG 17
Dodaje obsługę określania domyślnej nazwy bazy danych w klastrze elastycznym
Dodaje obsługę zaleceń dotyczących tabel
Poprawia kody odpowiedzi HTTP, aby odzwierciedlić, co każde API może zwrócić
Dodaje przykład szyfrowania danych opartego na kluczu cmK z automatyczną aktualizacją wersji klucza
Dodaje przykład tworzenia serwera w sieci wirtualnej należącej do firmy Microsoft
Zmienia nazwy plików, aby lepiej przedstawić ich zawartość
Zmienia nazwy identyfikatorów operacji, aby poprawić organizację, przejrzystość i nawigację
Poprawia metadane definicji lokalnych
Poprawia opisy, aby były spójne
2025-06-01-preview Preview Zmienia nazwy plików, aby lepiej przedstawić ich zawartość
Zmienia nazwy operacji, aby poprawić organizację, przejrzystość i nawigację
Dodaje przykład szyfrowania danych opartego na kluczu cmK z automatyczną aktualizacją wersji klucza
Dodaje przykład tworzenia serwera w sieci wirtualnej należącej do firmy Microsoft
Dodaje obsługę zaleceń dotyczących tabel
Dodaje obsługę określania domyślnej nazwy bazy danych w klastrze elastycznym
Usuwa obsługę funkcji dostrajania parametrów
Poprawia opisy
Poprawia metadane definicji lokalnych
Poprawia kody odpowiedzi HTTP, aby odzwierciedlić, co każde API może zwrócić
2025-01-01-preview Preview Dodaje obsługę funkcji dostrajania parametrów
2024-11-01-preview Preview Dostosowywanie indeksu
Dodano typy źródeł do migracji
Obsługa PG 17
Obsługa typu przechowywania UltraSSD_LRS
Klastry elastyczne na elastycznych instancjach serwerowych
2024-08-01 Stabilna (GA) Wcześniejsze funkcje ogólnej dostępności
Geo + CMK — przywracanie wstrzymane
Automatyczne zwiększanie pamięci
Skalowanie IOPS
Interfejs API nowej funkcjonalności lokalizacji
Długoterminowe przechowywanie kopii zapasowej
Dzienniki serwera
Migracje
Wstępna walidacja migracji
Repliki do odczytu — przełączanie (zamiana stron)
Repliki do odczytu — wirtualne punkty końcowe
Prywatne punkty końcowe
Interfejsy API Azure Defender / Ochrona przed zagrożeniami
Obsługa PG 16
Obsługa typu magazynu PremiumV2_LRS
Zmiany możliwości lokalizacji dla usługi SSDv2
Role migracji
Identyfikator zasobu wystąpienia migracji do obsługi migracji prywatnych punktów końcowych
Kopia zapasowa na żądanie
Tożsamość zarządzana przypisana systemowo
2023-06-01-preview Preview Wcześniejsze funkcje ogólnej dostępności
Prewalidacja migracji
Repliki do odczytu — przełączanie (zamiana stron)
Repliki do odczytu — wirtualne punkty końcowe
Prywatne punkty końcowe
Interfejsy API usługi Azure Defender\Threat Protection
Obsługa PG 16
Obsługa typu magazynu PremiumV2_LRS
Zmiany możliwości lokalizacji dla usługi SSDv2
Interfejs API użycia limitu przydziału
2023-03-01-preview Preview Nowe funkcje wersji ogólnie dostępnej (2022-12-01) +
Geo + CMK
Automatyczne zwiększanie pamięci
Skalowanie IOPS
Nowa funkcja lokalizacji API
Azure Defender
Dzienniki serwera
Migracje
2022-12-01 Stabilna (GA) Wcześniejsze funkcje ogólnej dostępności
EntraID
CMK
Backups
Administrators
Replicas
GeoRestore
MVU
2022-05-01-preview Preview CheckMigrationNameAvailability
Migracje
2021-06-01 Stabilna (GA) Wcześniejsze funkcje ogólnej dostępności
Operacje CRUD serwera
CheckNameAvailability
Konfiguracje (Parametry)
Database
Reguły zapory sieciowej
Prywatne
Sufiks strefy DNS
PITR
Ponowne uruchamianie serwera
Uruchamianie serwera
Zatrzymanie serwera
Okno obsługi
Użycie podsieci sieci wirtualnej

Lista stabilnych operacji interfejsu API

Każda obsługiwana stabilna operacja interfejsu API i jej szczegóły są wymienione w poniższej tabeli.

Funkcja/operacja Szczegóły
Administrators Zarządzanie administratorami serwera Microsoft Entra ID
Advanced Threat Protection Zarządzanie ustawieniami zaawansowanej ochrony przed zagrożeniami
Wykonywanie kopii zapasowych i ich przywracanie Zarządzaj automatycznymi kopiami zapasowymi serwera i kopiami zapasowymi na żądanie
Capabilities Wyświetlanie listy dostępnych możliwości serwera według lokalizacji i serwera
Konfiguracje Wyświetlanie parametrów serwera PostgreSQL i zarządzanie nimi
Databases Tworzenie, odczytywanie, aktualizowanie, usuwanie i listowanie baz danych
Szyfrowanie danych Konfigurowanie kluczy zarządzanych przez klienta (CMK), w tym szyfrowania między dzierżawami
Reguły zapory sieciowej Tworzenie, odczytywanie, aktualizowanie, usuwanie i wyświetlanie reguł zapory
Przechowywanie długoterminowe Zarządzanie operacjami tworzenia kopii zapasowych przechowywania długoterminowego
Zdarzenia konserwacji Wyświetlanie, pobieranie, zmiana terminu i stosowanie zdarzeń konserwacji na żądanie
Wstępne kontrole przed uaktualnieniem do nowej wersji głównej Inicjowanie sprawdzania poprawności przed uaktualnieniem i pobieranie wyników weryfikacji
Migracje Tworzenie operacji migracji bazy danych i zarządzanie nimi
Dostępność nazwy Sprawdzanie dostępności nazwy serwera i wirtualnego punktu końcowego
Migracja trybu sieciowego Migrowanie serwerów z integracji z siecią wirtualną do konfiguracji sieci obsługującej Private Link
Operations Wyświetl dostępne operacje zarządzania dostawcami zasobów
Dostosowywanie wydajności Pobieranie opcji dostrajania i zaleceń dotyczących optymalizacji bazy danych
Sufiks strefy prywatnego DNS Pobierz sufiks prywatnej strefy DNS
Prywatne punkty końcowe Zarządzanie połączeniami z prywatnymi punktami końcowymi
Zasoby linków prywatnych Wyświetl listę zasobów łącza prywatnego
Użycie limitu przydziału Pobieranie informacji o limitach przydziału i użyciu serwera regionalnego
Repliki do odczytu Tworzenie replik do odczytu i zarządzanie nimi, w tym promowanie repliki i przełączanie
Servers Tworzenie, odczytywanie, aktualizowanie, usuwanie, wyświetlanie listy, uruchamianie, zatrzymywanie i ponowne uruchamianie serwerów
Wirtualne punkty końcowe Tworzenie wirtualnych punktów końcowych i zarządzanie nimi
Wykorzystanie podsieci sieci wirtualnej Pobieranie informacji o użyciu podsieci sieci wirtualnej

Lista operacji interfejsu API w wersji zapoznawczej

W poniższej tabeli wymieniono każdą obsługiwaną operację interfejsu API w wersji zapoznawczej i jej szczegóły.

Funkcja/operacja Szczegóły
Administrators Tworzenie, pobieranie, wyświetlanie listy i usuwanie administratorów serwera Microsoft Entra ID
Advanced Threat Protection Pobieranie, wyświetlanie listy i aktualizowanie zaawansowanych ustawień ochrony przed zagrożeniami
Wykonywanie kopii zapasowych i ich przywracanie Twórz, pobieraj, wyświetlaj i usuwaj kopie zapasowe na żądanie; wyświetlaj dostępne automatyczne kopie zapasowe
Capabilities Wyświetlanie listy dostępnych możliwości serwera według lokalizacji i serwera
Przechwycone dzienniki Wyświetlanie listy przechwyconych dzienników serwera dostępnych do pobrania
Konfiguracje Pobieranie, wyświetlanie i aktualizowanie parametrów serwera PostgreSQL
Agenci baz danych Wyświetlanie listy, pobieranie, włączanie i wyłączanie konfiguracji agenta bazy danych
Databases Tworzenie, pobieranie, wyświetlanie listy i usuwanie baz danych
Szyfrowanie danych Konfigurowanie kluczy zarządzanych przez klienta (CMK), w tym szyfrowania między dzierżawami
Reguły zapory sieciowej Tworzenie, pobieranie, aktualizowanie, wyświetlanie i usuwanie reguł zapory
Przechowywanie długoterminowe Weryfikowanie wymagań wstępnych kopii zapasowych, inicjowanie kopii zapasowych długoterminowego przechowywania i pobieranie wyników operacji tworzenia kopii zapasowej
Zdarzenia konserwacji Pobieranie i wyświetlanie listy zdarzeń konserwacji, filtrowanie według nadchodzącego lub wcześniejszego stanu, zmiana terminu konserwacji i natychmiastowe zastosowanie konserwacji
Wstępne sprawdzanie uaktualnienia wersji głównej Inicjowanie sprawdzania poprawności przed uaktualnieniem i pobieranie lub wyświetlanie wyników sprawdzania poprawności
Migracje Tworzenie, pobieranie, wyświetlanie listy, aktualizowanie i anulowanie migracji bazy danych; weryfikowanie dostępności nazwy migracji
Dostępność nazwy Sprawdzanie dostępności nazwy serwera i wirtualnego punktu końcowego globalnie lub według lokalizacji
Migracja trybu sieciowego Migrowanie serwerów z integracji z siecią wirtualną do modelu sieci obsługującego Private Link
Operations Wyświetl listę dostępnych operacji zarządzania dostawcą zasobów
Dostosowywanie wydajności Pobieranie opcji dostrajania i rekomendacji dotyczących optymalizacji indeksu lub tabeli
Sufiks strefy Prywatna strefa DNS Pobierz sufiks prywatnej strefy DNS
Prywatne punkty końcowe Pobieranie, wyświetlanie listy, zatwierdzanie, odrzucanie i usuwanie połączeń prywatnych punktów końcowych
Zasoby linków prywatnych Pobierz i wyświetl zasoby linku prywatnego
Użycie limitu przydziału Pobierz użycie limitu regionalnego dla serwerów elastycznych
Repliki do odczytu Tworzenie, wyświetlanie listy replik do odczytu i zarządzanie nimi, w tym promowanie i przełączanie
Servers Tworzenie, pobieranie, aktualizowanie, usuwanie i wyświetlanie listy serwerów; uruchamianie, zatrzymywanie i ponowne uruchamianie serwerów
Zarządzanie magazynem Konfigurowanie dysków Premium SSD w wersji 2 i automatycznego zwiększania magazynu za pomocą właściwości magazynu serwera
Wirtualne punkty końcowe Tworzenie, pobieranie, aktualizowanie, wyświetlanie listy i usuwanie wirtualnych punktów końcowych
Wykorzystanie podsieci sieci wirtualnej Pobieranie informacji o użyciu podsieci sieci wirtualnej

Korzystanie z wersji zapoznawczej interfejsu API z programu Terraform

Terraform to narzędzie programowe typu infrastruktura jako kod (IaC) utworzone przez firmę HashiCorp. Użytkownicy definiują i udostępniają infrastrukturę centrum danych przy użyciu deklaratywnego języka konfiguracji znanego jako HashiCorp Configuration Language (HCL) lub opcjonalnie JSON. Narzędzie Terraform to powszechny sposób zarządzania IaC dla usługi Azure Database for PostgreSQL, opartego na interfejsie API Azure RM dostępnego w ogólnej dostępności, oprócz szablonów usługi Azure Resource Manager (ARM). Terraform udostępnia regularne aktualizacje dostawcy Terraform dla Azure Resource Manager (AzureRM), opartego na wersji interfejsu API Azure Resource Manager dostępnej w ogólnej dostępności.

Jeśli określona funkcja jest obecnie w interfejsie API w wersji zapoznawczej i nie jest jeszcze włączona do interfejsu GA API i dostawcy AzureRM Terraform, użyj dostawcy AzAPI Terraform, aby wywołać interfejs API w wersji zapoznawczej bezpośrednio z narzędzia Terraform. Dostawca AzAPI to cienka warstwa na szczycie interfejsów API REST usługi Azure Resource Manager. Dostawca AzAPI umożliwia zarządzanie dowolnym typem zasobu Azure przy użyciu dowolnej wersji interfejsu API. Dostawca AzAPI to cienka warstwa na szczycie interfejsów API REST usługi Azure ARM. Za pomocą dostawcy AzAPI można zarządzać dowolnym typem zasobu platformy Azure przy użyciu dowolnej wersji interfejsu API. Ten dostawca uzupełnia dostawcę modułu AzureRM, włączając zarządzanie nowymi zasobami i właściwościami platformy Azure (w tym prywatną wersję zapoznawcza).

Dostawca AzAPI oferuje następujące korzyści:

  • Obsługuje wszystkie usługi platformy Azure:
  • Prywatne usługi i funkcje w wersji zapoznawczej
  • Publiczne usługi i funkcje w wersji zapoznawczej
  • Wszystkie wersje interfejsu API
  • Pełna wierność pliku stanu Terraform
  • Właściwości i wartości są zapisywane w stanie
  • Brak zależności od Swagger
  • Typowe i spójne uwierzytelnianie platformy Azure

AzAPI2AzureRM to narzędzie typu open source zaprojektowane w celu ułatwienia migracji z dostawcy AzAPI do dostawcy modułu AzureRM.

Kontakty

Jeśli masz pytania lub sugestie dotyczące usługi Azure Database for PostgreSQL, wyślij wiadomość e-mail do zespołu usługi Azure Database for PostgreSQL (@Ask Azure Database for PostgreSQL). Należy pamiętać, że ten adres e-mail nie jest aliasem pomocy technicznej.

Ponadto, w zależności od potrzeb, należy wziąć pod uwagę następujące punkty kontaktowe:

Treści powiązane

  • Ostatnia aktualizacja o