Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tento článek obsahuje nejnovější zprávy a aktualizace o doporučených verzích rozhraní API, které se mají použít. Verze rozhraní API, které tu nejsou uvedené, se můžou podporovat, ale brzy budou vyřazeny. Dokumentace k nejnovější preview verzi rozhraní API a stabilní verzi rozhraní API je k dispozici zde.
Vydané verze rozhraní API
Tato část shrnuje změny funkcí v jednotlivých verzích rozhraní API Azure Database for PostgreSQL.
Note
Verze rozhraní API obecně vycházejí z předchozích verzí, ale funkce ve verzi Preview se můžou měnit nebo odebírat. Ve sloupci Poznámky k verzi jsou uvedené změny pro každou verzi.
| Verze rozhraní API | Stable/Preview | Poznámky k vydání |
|---|---|---|
| 2026-10-01 | Stabilní (GA) | Zahrnuje všechny možnosti z předchozích stabilních verzí rozhraní API s následujícími dodatky: Správa údržby: Podpora pro přeplánování plánované údržby, použití dostupných aktualizací údržby na vyžádání, zobrazení nadcházející údržby a načítání historie údržby Sítě: Podpora migrace serverů z integrace virtuální sítě do síťového připojení podporujícího veřejný přístup a privátní koncové body. Dodržování předpisů FIPS: Podpora vytváření serverů s povoleným FIPS a povolení nebo zakázání FIPS na existujících serverech Neměnné zálohy: Podpora vytváření serverů s povolenými neměnnými zálohami Upgrade hlavní verze: Podpora spouštění ověřovacích kontrol před upgradem před zahájením upgradu hlavní verze PostgreSQL Autonomní ladění: Přidá vacuumTable jako podporovanou možnost autonomního ladění.Klíče spravované zákazníkem napříč tenanty (CMK): Podpora konfigurace šifrování mezi tenanty pomocí klíčů spravovaných zákazníkem s povolenými geograficky redundantními zálohami nebo bez. Flexibilita verze PostgreSQL: Odstraňuje omezení výčtu verze PostgreSQL, což umožňuje vytvoření serveru a upgrady hlavních verzí tak, aby podporovaly nově vydané verze PostgreSQL bez nutnosti aktualizace schématu rozhraní API. |
| 2026-07-01-preview | Preview | Zahrnuje všechny funkce z předchozích verzí rozhraní API s následujícími doplňky: PostgreSQL 19: Přidá do podporovaného PostgresMajorVersion výčtu PostgreSQL verze 19.Databázový agent (DBAgent): Zavádí nový prostředek DBAgent a přidružené operace správy. Správa úložiště: Přidává nové vlastnosti úložiště na podporu Premium SSD v2 a konfigurace automatického zvětšování úložiště. |
| 2026-04-01-preview | Preview | Zahrnuje všechny funkce z předchozích verzí rozhraní API s následujícími doplňky: Správa údržby: MaintenanceEvent Zavádí rozhraní API s operacemi pro načtení podrobností o událostech údržby, výpis událostí údržby podle serveru, přeplánování plánované údržby a použití dostupných aktualizací údržby na vyžádání.Předběžné kontroly upgradu hlavní verze: MajorVersionUpgradePrecheck Zavádí rozhraní API s operacemi Get a List by Server spolu s novou MajorVersionUpgradePrecheck operací v rozhraní API Servers, která slouží ke spuštění kontrol ověření před upgradem.Klíče spravované zákazníkem napříč tenanty (CMK): Přidává do rozhraní API serverů vlastnosti primaryFederatedIdentityClientId a geoBackupFederatedIdentityClientId pro podporu šifrování dat napříč tenanty pomocí klíčů spravovaných zákazníkem. |
| 2026-01-01-preview | Preview | Zahrnuje všechny funkce z předchozích verzí rozhraní API s následujícím doplňkem: Sítě: Podpora migrace serverů z integrace virtuální sítě do síťového prostředí podporujícího veřejný přístup a privátní koncové body |
| 2025-08-01 | Stabilní (GA) | Dřívější funkce GA + Podpora pro PG 18 Podpora pro PG 17 Přidá podporu pro zadání výchozího názvu databáze v elastickém clusteru. Přidává podporu pro doporučení tabulek Opraví kódy odpovědí HTTP tak, aby odrážely, co může každé rozhraní API vrátit. Přidá příklad pro šifrování dat založených na CMK s automatickou aktualizací verze klíče. Přidá příklad pro vytvoření serveru ve virtuální síti vlastněné Microsoftem. Přejmenuje soubory pro lepší znázornění jejich obsahu. Přejmenování ID operací za účelem zlepšení uspořádání, přehlednosti a navigace Vylepšuje metadata místních definic. Zlepšuje popisy pro zajištění konzistence. |
| 2025-06-01-preview | Preview | Přejmenuje soubory pro lepší znázornění jejich obsahu. Přejmenování operací za účelem zlepšení uspořádání, přehlednosti a navigace Přidá příklad pro šifrování dat založených na CMK s automatickou aktualizací verze klíče. Přidá příklad pro vytvoření serveru ve virtuální síti vlastněné Microsoftem. Přidává podporu pro doporučení tabulek Přidá podporu pro zadání výchozího názvu databáze v elastickém clusteru. Odebere podporu funkce ladění parametrů. Vylepšuje popisy. Vylepšuje metadata místních definic. Opraví kódy odpovědí HTTP tak, aby odrážely, co může každé rozhraní API vrátit. |
| 2025-01-01-preview | Preview | Přidá podporu pro funkci ladění parametrů. |
| 2024-11-01-preview | Preview | Ladění indexu Přidání typů zdrojů pro migraci Podpora PG 17 podpora typu úložiště UltraSSD_LRS Elastické clustery na instancích flexibilního serveru |
| 2024-08-01 | Stabilní (GA) | Dřívější funkce GA + Geo + CMK - Obnovte zahozené Automatický růst úložiště Škálování IOPS Rozhraní API pro nové funkce umístění Dlouhodobé uchovávání záložních dat Protokoly serveru Migrations Předběžné ověření migrace Repliky pro čtení – Přepnutí (výměna lokalit) Repliky pro čtení – Virtuální koncové body Privátní koncové body Rozhraní API služby Azure Defender / Ochrana před internetovými útoky Podpora PG 16 podpora typu úložiště PremiumV2_LRS Změny možností umístění pro SSDv2 Migrační role ID prostředku instance migrace pro podporu migrací privátních koncových bodů Zálohování na vyžádání Systémově spravovaná identita |
| 2023-06-01-preview | Preview | Dřívější funkce GA + Předvalidace migrace Repliky pro čtení – Přepnutí (výměna lokalit) Repliky pro čtení – Virtuální koncové body Privátní koncové body Rozhraní API Azure Defender\Ochrana před hrozbami Podpora PG 16 podpora typu úložiště PremiumV2_LRS Změny možností umístění pro SSDv2 Rozhraní API pro využití kvót |
| 2023-03-01-preview | Preview | Nové funkce verze GA (2022-12-01) + Geo + CMK Automatický růst úložiště Škálování IOPS Nové rozhraní API pro schopnosti umístění Azure Defender Protokoly serveru Migrations |
| 2022-12-01 | Stabilní (GA) | Dřívější funkce GA + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | Stabilní (GA) | Dřívější funkce GA + Server CRUD CheckNameAvailability Konfigurace (Parametry) Database Pravidla firewallu Soukromý Přípona zóny DNS Obnovení bodu v čase (PITR) Restartování serveru Spuštění serveru Zastavení serveru Časové období údržby Využití podsítě virtuální sítě |
Seznam stabilních operací rozhraní API
Každá podporovaná stabilní operace rozhraní API a její podrobnosti jsou uvedené v následující tabulce.
| Funkce nebo operace | Podrobnosti |
|---|---|
| Administrators | Správa správců serveru Microsoft Entra ID |
| Advanced Threat Protection | Správa rozšířených nastavení pokročilé ochrany před hrozbami |
| Zálohování & Obnovení | Spravujte automatické zálohy serverů a zálohy serverů na vyžádání |
| Capabilities | Výpis dostupných schopností serveru podle umístění a serveru |
| Konfigurace | Zobrazte a spravujte parametry serveru PostgreSQL |
| Databáze | Vytvořit, číst, aktualizovat, odstranit a vypsat databáze |
| Šifrování dat | Nakonfigurujte klíče spravované zákazníkem (CMK), včetně šifrování mezi tenanty |
| Pravidla brány firewall | Vytvoření, čtení, aktualizace, odstranění a výpis pravidel brány firewall |
| Dlouhodobé uchovávání | Správa operací dlouhodobého uchovávání záloh |
| Události údržby | Vypsat, načíst, přeplánovat a použít události údržby na vyžádání |
| Předběžné kontroly upgradu hlavní verze | Spusťte kontroly ověření před upgradem a načtení výsledků ověření |
| Migrations | Vytvořit a spravovat operace migrace databáze |
| Název Dostupnost | Zkontrolovat dostupnost názvu serveru a virtuálního koncového bodu |
| Migrace režimu sítě | Migrujte servery z integrace virtuální sítě do konfigurace sítě podporující Private Link |
| Operations | Vypište dostupné operace správy poskytovatele prostředků |
| Ladění výkonu | Získání možností ladění a doporučení pro optimalizaci databáze |
| Přípona privátní zóny DNS | Načíst příponu privátní zóny DNS |
| Privátní koncové body | Správa připojení privátních koncových bodů |
| Zdroje pro soukromé odkazy | Vypsat prostředky Private Link |
| Využití kvót | Načtení informací o kvótě a využití regionálních serverů |
| Repliky pro čtení | Vytváření a správa replik pro čtení, včetně promoce a switchoveru |
| Servers | Vytvořit, číst, aktualizovat, odstranit, vypsat, spustit, zastavit a restartovat servery |
| Virtuální koncové body | Vytváření a správa virtuálních koncových bodů |
| Využití podsítě virtuální sítě | Načíst informace o využití podsítě virtuální sítě |
Seznam operací rozhraní Preview API
Následující tabulka uvádí každou podporovanou operaci rozhraní API ve verzi Preview a její podrobnosti.
| Funkce nebo operace | Podrobnosti |
|---|---|
| Administrators | Vytvoření, načtení, výpis a odstranění správců serveru pro Microsoft Entra ID |
| Advanced Threat Protection | Načtení, výpis a aktualizace nastavení pokročilé ochrany před hrozbami |
| Zálohování & Obnovení | Vytváření, načítání, výpis a odstraňování záloh na vyžádání; seznam dostupných automatických záloh |
| Capabilities | Výpis dostupných funkcí serveru podle umístění a serveru |
| Zachycené protokoly | Seznam zachycených protokolů serveru ke stažení |
| Konfigurace | Načtení, výpis a aktualizace parametrů serveru PostgreSQL |
| Databázové agenty | Vypsat, načíst, povolit a zakázat konfigurace databázového agenta |
| Databáze | Vytvořit, načíst, vypsat a odstranit databáze |
| Šifrování dat | Nakonfigurujte klíče spravované zákazníkem (CMK), včetně šifrování mezi tenanty |
| Pravidla brány firewall | Vytvořit, načíst, aktualizovat, vypsat a odstranit pravidla brány firewall |
| Dlouhodobé uchovávání | Ověřte předpoklady pro zálohování, zahajte dlouhodobé uchovávání záloh a načtěte výsledky operace zálohování. |
| Události údržby | Načíst a vypsat události údržby, filtrovat podle nadcházejících nebo minulých událostí, změnit plánování údržby a okamžitě použít údržbu |
| Předběžné kontroly upgradu hlavní verze | Spusťte kontroly ověření před upgradem a načíst nebo vypsat výsledky ověření |
| Migrations | Vytváření, načítání, výpis, aktualizace a rušení migrací databází; ověření dostupnosti názvu migrace |
| Název Dostupnost | Kontrola dostupnosti názvu serveru a virtuálního koncového bodu globálně nebo podle umístění |
| Migrace režimu sítě | Migrujte servery z integrace virtuální sítě do síťového modelu s podporou Private Link |
| Operations | Vypsat dostupné operace správy poskytovatele prostředků |
| Ladění výkonu | Načtení možností ladění a doporučení pro optimalizaci indexů nebo tabulek |
| Přípona privátní zóny DNS | Načíst příponu privátní zóny DNS |
| Privátní koncové body | Načíst, vypsat, schválit, odmítnout a odstranit připojení privátního koncového bodu |
| Zdroje pro soukromé odkazy | Načíst a vypsat prostředky Private Link |
| Využití kvót | Načtení využití regionální kvóty pro flexibilní servery |
| Repliky pro čtení | Vytvářet, zobrazit seznam a spravovat repliky pro čtení, včetně povýšení a přepnutí |
| Servers | Vytvořit, načíst, aktualizovat, odstranit a vypsat servery; spustit, zastavit a restartovat servery |
| Správa úložiště | Konfigurace Premium SSD v2 a automatického zvětšování úložiště prostřednictvím vlastností úložiště serveru |
| Virtuální koncové body | Vytvořit, načíst, aktualizovat, vypsat a odstranit virtuální koncové body |
| Využití podsítě virtuální sítě | Načíst informace o využití podsítě virtuální sítě |
Použití verzí Preview rozhraní API z Terraformu
Terraform je softwarový nástroj pro infrastrukturu jako kód (IaC), který vytvořil HashiCorp. Uživatelé definují a poskytují infrastrukturu datového centra pomocí deklarativního konfiguračního jazyka označovaného jako HashiCorp Configuration Language (HCL) nebo volitelně JSON. Terraform je běžným způsobem, jak provádět správu IaC pro službu Azure Database for PostgreSQL na základě rozhraní API Azure RM ve fázi obecné dostupnosti (GA) a kromě šablon Azure Resource Manager (ARM). Komunita Terraformu vydává pravidelné aktualizace pro poskytovatele Azure Resource Manageru (AzureRM) Terraformu na základě verze rozhraní API Azure Resource Manageru v obecné dostupnosti (GA).
Pokud je určitá funkce aktuálně v rozhraní API ve verzi Preview a ještě není zahrnuta do GA API a AzureRM Terraform provider, použijte AzAPI Terraform provider k přímému volání preview API z Terraformu. Zprostředkovatel AzAPI je tenká vrstva nad rozhraními REST API Azure Resource Manageru. Poskytovatel AzAPI umožňuje spravovat libovolný typ prostředku Azure pomocí libovolné verze rozhraní API. Zprostředkovatel AzAPI je tenká vrstva nad rozhraními Azure ARM REST API. Pomocí poskytovatele AzAPI můžete spravovat libovolný typ prostředku Azure pomocí libovolné verze rozhraní API. Tento poskytovatel doplňuje poskytovatele AzureRM povolením správy nových prostředků a vlastností Azure (včetně privátní verze Preview).
Poskytovatel AzAPI nabízí následující výhody:
- Podporuje všechny služby Azure:
- Služby a funkce privátní verze Preview
- Služby a funkce ve verzi Public Preview
- Všechny verze rozhraní API
- Úplná věrnost stavu souboru Terraformu
- Vlastnosti a hodnoty se ukládají do stavu.
- Bez závislosti na Swaggeru
- Běžné a konzistentní ověřování Azure
AzAPI2AzureRM je opensourcový nástroj, který je navržený tak, aby pomohl migrovat z poskytovatele AzAPI na poskytovatele AzureRM.
Contacts
Pokud máte jakékoli dotazy nebo návrhy týkající se služby Azure Database for PostgreSQL, pošlete e-mail týmu Azure Database for PostgreSQL (@Ask Azure Database for PostgreSQL). Upozorňujeme, že tato e-mailová adresa není aliasem technické podpory.
Kromě toho zvažte následující kontaktní místa jako vhodná:
- Pro kontaktování podpory Azure odešlete žádost z portálu Azure.
- Pokud chcete vyřešit problém s vaším účtem, vytvořte žádost o podporu na webu Azure Portal.
- Pokud chcete poskytnout zpětnou vazbu nebo požádat o nové funkce, vytvořte položku prostřednictvím UserVoice.