この記事では、使用する推奨 API バージョンに関する最新のニュースと更新情報を提供します。 ここに記載されていない API バージョンはサポートされる可能性がありますが、間もなく廃止される予定です。 最新のプレビューと安定版 API バージョンのドキュメントはこちらで入手できます。
API リリース
このセクションでは、各Azure Database for PostgreSQL API バージョンでの機能の変更についてまとめます。
Note
API バージョンは通常、以前のバージョンに基づいて構築されますが、プレビュー機能は変更されたり削除されたりする可能性があります。 [リリース ノート] 列には、各バージョンの変更が一覧表示されます。
| API バージョン | Stable/Preview | リリース ノート |
|---|---|---|
| 2026-10-01 | 安定 (GA) | 以前の安定した API バージョンのすべての機能が含まれています。次の機能が追加されています。 メンテナンス管理: 計画メンテナンスの再スケジュール、必要に応じて利用可能なメンテナンス更新プログラムの適用、今後のメンテナンスの表示、メンテナンス履歴の取得をサポートします。 ネットワーク: 仮想ネットワーク (VNet) 統合からパブリック アクセスとプライベート エンドポイント対応ネットワークへのサーバー移行のサポート。 FIPS コンプライアンス: FIPS が有効になっているサーバーの作成と、既存のサーバーでの FIPS の有効化または無効化のサポート。 イミュータブル バックアップ: イミュータブル バックアップを有効にしたサーバーの作成をサポート。 メジャー バージョンのアップグレード: PostgreSQL メジャー バージョンのアップグレードを開始する前に、アップグレード前の検証チェックを実行するためのサポート。 自律チューニング: サポートされている自律チューニング オプションとして vacuumTable を追加します。テナント間カスタマー マネージド キー (CMK): geo 冗長バックアップが有効になっているかどうかに関係なく、カスタマー マネージド キーを使用してテナント間暗号化を構成するためのサポート。 PostgreSQL バージョンの柔軟性: PostgreSQL バージョンの列挙制約を削除し、サーバーの作成とメジャー バージョンのアップグレードで、API スキーマの更新を必要とせずに、新しくリリースされた PostgreSQL バージョンをサポートできるようにします。 |
| 2026-07-01-preview | Preview | 以前のバージョンの API のすべての機能が含まれています。次の追加点があります。 PostgreSQL 19: サポートされている PostgresMajorVersion 列挙型に PostgreSQL バージョン 19 を追加します。データベース エージェント (DBAgent): 新しい DBAgent リソースと関連する管理操作を導入します。 ストレージ管理: Premium SSD v2 とストレージの自動拡張構成をサポートする新しいストレージ プロパティを追加します。 |
| 2026-04-01-プレビュー | Preview | 以前のバージョンの API のすべての機能が含まれています。次の機能が追加されています。 メンテナンス管理; MaintenanceEvent API を紹介します。これは、メンテナンス イベントの詳細を取得したり、サーバーごとにメンテナンス イベントを一覧表示したり、予定されているメンテナンスのスケジュールを変更したり、利用可能なメンテナンス更新をオンデマンドで適用したりする操作を備えています。メジャーバージョンのアップグレード前の事前チェック: MajorVersionUpgradePrecheck API に Get および List by Server 操作が追加されたほか、Servers API には、アップグレード前の検証チェックを開始する新しい MajorVersionUpgradePrecheck 操作が追加されました。テナント間カスタマー マネージド キー (CMK): カスタマー マネージド キーを使用したテナント間のデータ暗号化をサポートするために、 primaryFederatedIdentityClientId プロパティと geoBackupFederatedIdentityClientId プロパティを Servers API に追加します。 |
| 2026-01-01-preview | Preview | 以前のバージョンの API のすべての機能が含まれています。次の追加があります: ネットワーク: 仮想ネットワーク (VNet) 統合からパブリック アクセスとプライベート エンドポイント対応ネットワークへのサーバー移行のサポート。 |
| 2025-08-01 | 安定 (GA) | 以前の GA 機能 + PG 18 のサポート PG 17 のサポート Elastic Cluster で既定のデータベース名を指定する機能を追加 テーブル推奨のサポートを追加 各 API が返す内容を反映するよう HTTP 応答コードを修正 自動キー バージョン更新を使用した CMK ベースのデータ暗号化の例を追加 Microsoft 所有の仮想ネットワークでサーバーを作成する例を追加 内容をより適切に表すためにファイル名を変更 操作 ID の名前を変更して、組織、明確さ、ナビゲーションを向上させます ローカル定義のメタデータを改善 一貫性のために説明を改善します |
| 2025-06-01-preview | Preview | 内容をより適切に表すためにファイル名を変更 組織、明確さ、ナビゲーションを向上させるために操作の名前を変更します 自動キー バージョン更新を使用した CMK ベースのデータ暗号化の例を追加 Microsoft 所有の仮想ネットワークでサーバーを作成する例を追加 テーブル推奨のサポートを追加 Elastic Cluster で既定のデータベース名を指定する機能を追加 パラメーター チューニング機能のサポートが削除されました 説明を改善 ローカル定義のメタデータを改善 各 API が返す内容を反映するよう HTTP 応答コードを修正 |
| 2025-01-01-preview | Preview | パラメーター チューニング機能のサポートを追加 |
| 2024-11-01-preview | Preview | インデックスのチューニング 移行のソースの種類を追加 PG 17 のサポート UltraSSD_LRS ストレージの種類のサポート フレキシブル サーバー インスタンス上のエラスティック クラスター |
| 2024-08-01 | 安定 (GA) | 以前の GA 機能 + Geo + CMK - 削除された機能を復活 ストレージの自動拡張 IOPS スケーリング 新しいロケーション機能 API 長期保有バックアップ サーバー ログ Migrations 移行の事前検証 読み取りレプリカ - 切り替え (サイト スワップ) 読み取りレプリカ - 仮想エンドポイント プライベート エンドポイント Azure Defender / Threat Protection API PG 16 のサポート PremiumV2_LRS ストレージの種類のサポート SSDv2 のロケーション機能の変更 移行ロール プライベート エンドポイントの移行をサポートするための移行インスタンス リソース ID オンデマンド バックアップ システムによって割り当てられたマネージド ID |
| 2023-06-01-preview | Preview | 以前の GA 機能 + 移行の事前検証 読み取りレプリカ - 切り替え (サイト スワップ) 読み取りレプリカ - 仮想エンドポイント プライベート エンドポイント Azure Defender / Threat Protection API PG 16 のサポート PremiumV2_LRS ストレージの種類のサポート SSDv2 のロケーション機能の変更 クォータ利用 API |
| 2023-03-01-preview | Preview | 新しい GA バージョン機能 (2022-12-01) + Geo + CMK ストレージの自動拡張 IOPS スケーリング 新しいロケーション機能 API Azure Defender サーバー ログ Migrations |
| 2022-12-01 | 安定 (GA) | 以前の GA 機能 + EntraID CMK Backups Administrators Replicas GeoRestore MVU |
| 2022-05-01-preview | Preview | CheckMigrationNameAvailability Migrations |
| 2021-06-01 | 安定 (GA) | 以前の GA 機能 + サーバー CRUD CheckNameAvailability 構成 (パラメーター) Database ファイアウォール規則 Private DNS ゾーン サフィックス PITR サーバーの再起動 サーバーの起動 サーバーの停止 メンテナンス期間 仮想ネットワーク サブネットの使用 |
安定版 API の操作一覧
サポートされている各安定した API 操作とその詳細を次の表に示します。
| 機能/操作 | 詳細情報 |
|---|---|
| Administrators | Microsoft Entra ID サーバー管理者の管理 |
| 高度な脅威保護 | 高度な脅威保護の設定を管理する |
| バックアップと復元 | サーバーの自動バックアップとオンデマンド バックアップを管理する |
| Capabilities | 利用可能なサーバー機能を場所とサーバー別に一覧表示する |
| Configurations | PostgreSQL サーバー パラメーターの表示と管理 |
| Databases | データベースの作成、読み取り、更新、削除、および一覧表示 |
| データの暗号化 | テナント間暗号化を含むカスタマー マネージド キー (CMK) を構成する |
| ファイアウォールルール | ファイアウォール規則の作成、読み取り、更新、削除、一覧表示 |
| 長期保有 | 長期保持バックアップ操作を管理する |
| メンテナンス イベント | 必要に応じてメンテナンス イベントを一覧表示、取得、再スケジュール、適用する |
| メジャー バージョンのアップグレードの事前チェック | アップグレード前の検証チェックを開始し、検証結果を取得する |
| Migrations | データベース移行操作の作成と管理 |
| 名前の可用性 | サーバーと仮想エンドポイント名の可用性を確認する |
| ネットワーク モードの移行 | VNet 統合からPrivate Link対応ネットワーク構成にサーバーを移行する |
| Operations | 使用可能なリソース プロバイダーの管理操作を一覧表示する |
| パフォーマンスチューニング | チューニング オプションとデータベース最適化の推奨事項を取得する |
| プライベート DNSゾーンサフィックス | プライベート DNS ゾーン サフィックスを取得する |
| プライベート エンドポイント | プライベート エンドポイント接続を管理する |
| Private Linkリソース | プライベート リンク リソースを一覧表示する |
| クォータ使用量 | リージョン サーバーのクォータと使用状況の情報を取得する |
| 読み取りレプリカ | 昇格や切り替えを含む読み取りレプリカの作成と管理 |
| Servers | サーバーの作成、読み取り、更新、削除、一覧表示、開始、停止、再起動 |
| 仮想エンドポイント | 仮想エンドポイントの作成と管理 |
| Virtual Networkサブネットの使用状況 | 仮想ネットワーク サブネットの使用状況情報を取得する |
プレビュー API 操作の一覧
次の表に、サポートされているプレビュー API 操作とその詳細を示します。
| 機能/操作 | 詳細情報 |
|---|---|
| Administrators | Microsoft Entra ID サーバー管理者の作成、取得、一覧表示、および削除 |
| 高度な脅威保護 | 脅威の高度な保護設定を取得、一覧表示、更新する |
| バックアップと復元 | オンデマンド バックアップを作成、取得、一覧表示、削除する。使用可能な自動バックアップの一覧 |
| Capabilities | 利用可能なサーバー機能を場所とサーバー別に一覧表示する |
| キャプチャされたログ | ダウンロード可能なキャプチャされたサーバー ログを一覧表示する |
| Configurations | PostgreSQL サーバー パラメーターの取得、一覧表示、更新 |
| データベース エージェント | データベース エージェント構成の一覧表示、取得、有効化、無効化 |
| Databases | データベースの作成、取得、一覧表示、および削除 |
| データの暗号化 | テナント間暗号化を含むカスタマー マネージド キー (CMK) を構成する |
| ファイアウォールルール | ファイアウォール規則の作成、取得、更新、一覧表示、削除 |
| 長期保有 | バックアップの前提条件の検証、長期保有バックアップの開始、バックアップ操作の結果の取得 |
| メンテナンス イベント | メンテナンス イベントの取得と一覧表示、今後または過去の状態によるフィルター処理、メンテナンスのスケジュール変更、メンテナンスの即時適用 |
| メジャー バージョンのアップグレードの事前チェック | アップグレード前の検証チェックを開始し、検証結果を取得または一覧表示する |
| Migrations | データベースの移行を作成、取得、一覧表示、更新、取り消す。移行名の使用可否を検証する |
| 名前の可用性 | サーバーと仮想エンドポイント名の可用性をグローバルまたは場所別に確認する |
| ネットワーク モードの移行 | VNet 統合からPrivate Link対応のネットワーク モデルにサーバーを移行する |
| Operations | 使用可能なリソース プロバイダーの管理操作を一覧表示する |
| パフォーマンスチューニング | チューニング オプションとインデックスまたはテーブルの最適化に関する推奨事項を取得する |
| プライベート DNSゾーンサフィックス | プライベート DNS ゾーン サフィックスを取得する |
| プライベート エンドポイント | プライベート エンドポイント接続の取得、一覧表示、承認、拒否、削除 |
| Private Linkリソース | プライベート リンク リソースを取得して一覧表示する |
| クォータ使用量 | フレキシブル サーバーのリージョン クォータ使用量を取得する |
| 読み取りレプリカ | 昇格や切り替えを含む読み取りレプリカの作成、一覧表示、管理 |
| Servers | サーバーの作成、取得、更新、削除、および一覧表示。サーバーの起動、停止、再起動 |
| 記憶域の管理 | サーバー ストレージのプロパティを使用して Premium SSD v2 とストレージの自動拡張を構成する |
| 仮想エンドポイント | 仮想エンドポイントの作成、取得、更新、一覧表示、削除 |
| Virtual Networkサブネットの使用状況 | 仮想ネットワーク サブネットの使用状況情報を取得する |
Terraform から Preview バージョンの API の使用
Terraform は、HashiCorp が開発した Infrastructure-as-Code (IaC) ソフトウェア ツールです。 ユーザーは、HashiCorp Configuration Language (HCL) または必要に応じて JSON と呼ばれる宣言型構成言語を使用して、データ センターのインフラストラクチャを定義および提供します。 Terraform は、GA Azure RM API に基づいて Azure Database for PostgreSQL の IaC 管理を実行する一般的な方法であり、 Azure Resource Manager (ARM) テンプレート Terraform コミュニティでは、一般公開 (GA) の Azure Resource Manager API バージョンに基づく Azure Resource Manager (AzureRM) Terraform プロバイダー の定期的な更新プログラムがリリースされます。
特定の機能が現在プレビュー API にあり、まだ GA API と AzureRM Terraform プロバイダーに組み込まれていない場合は、AzAPI Terraform プロバイダーを使用して、Terraform からプレビュー API を直接呼び出してください。 AzAPI プロバイダー は、Azure Resource Manager REST API の上にある薄いレイヤーです。 AzAPI プロバイダーを使用すると、任意の API バージョンを使用して、任意の Azure リソース タイプを管理できます。 AzAPI プロバイダーは、 Azure ARM REST API の上にある薄いレイヤーです。 AzAPI プロバイダーを使用すると、任意の API バージョンを使用して任意のAzureリソースの種類を管理できます。 このプロバイダーは、新しい Azure リソースとプロパティ (プライベート プレビューを含む) の管理を有効にすることで、AzureRM プロバイダーを補完します。
AzAPI プロバイダーには、次のような利点があります。
- すべての Azure サービスをサポートします。
- プライベート プレビュー サービスと機能
- パブリック プレビュー サービスと機能
- すべての API のバージョン
- 完全な Terraform 状態ファイルの忠実性
- プロパティと値は状態に保存
- Swagger への依存関係なし
- 一般的で一貫性のある Azure 認証
AzAPI2AzureRM は、AzAPI プロバイダーから AzureRM プロバイダーへの移行に役立つオープン ソース ツールです。
連絡先
Azure Database for PostgreSQL で質問や提案がある場合は、Azure Database for PostgreSQL チーム (Azure Database for PostgreSQL @Ask) に電子メールを送信してください。 このメール アドレスはテクニカル サポートのエイリアスではありません。
さらに、適切な連絡先について次の点を考慮してください。
- Azure サポートに連絡するには、 Azure portal からチケットを提出します。
- アカウントの問題を解決するには、Azure portal で サポート リクエスト を提出します。
- フィードバックを提供したり、新しい機能を要求したりするには、UserVoice でエントリを作成します。