ملاحظات الإصدار لواجهات برمجة التطبيقات REST ل قاعدة بيانات Azure لـ PostgreSQL مرن الخادم

توفر هذه المقالة أحدث الأخبار والتحديثات حول إصدارات واجهة برمجة التطبيقات الموصى بها لاستخدامها. قد يتم دعم إصدارات واجهة برمجة التطبيقات غير المدرجة هنا، ولكن سيتم إيقافها قريبا. ابحث عن الوثائق الخاصة بأحدث إصدار معاينة وواجهة برمجة تطبيقات مستقرة متاحة هنا.

إصدارات واجهة برمجة التطبيقات

يلخص هذا القسم تغييرات الميزة عبر كل إصدار قاعدة بيانات Azure لـ PostgreSQL API.

ملاحظة

تعتمد إصدارات واجهة برمجة التطبيقات بشكل عام على الإصدارات السابقة، ولكن يمكن تغيير ميزات المعاينة أو إزالتها. يسرد العمود ملاحظات الإصدار التغييرات لكل إصدار.

إصدار API مستقر/معاينة ملاحظات الإصدار
2026-10-01 مستقر (GA) يتضمن جميع الإمكانات من إصدارات واجهة برمجة التطبيقات الثابتة السابقة، مع الإضافات التالية:

إدارة الصيانة: دعم إعادة جدولة الصيانة المخطط لها، وتطبيق تحديثات الصيانة المتاحة عند الطلب، وعرض الصيانة القادمة، واسترداد محفوظات الصيانة.

الشبكات: دعم ترحيل الخوادم من تكامل الشبكة الظاهرية (VNet) إلى الوصول العام والشبكات الخاصة القادرة على نقطة النهاية.

توافق FIPS: دعم إنشاء خوادم مع تمكين FIPS وتمكين FIPS أو تعطيلها على الخوادم الموجودة.

النسخ الاحتياطية غير القابلة للتغيير: دعم إنشاء خوادم مع تمكين النسخ الاحتياطية غير القابلة للتغيير.

ترقيات الإصدار الرئيسي: دعم تشغيل عمليات التحقق من صحة ما قبل الترقية قبل بدء ترقية إصدار PostgreSQL الرئيسي.

الضبط المستقل:vacuumTable يضيف كخيار ضبط مستقل مدعوم.

المفاتيح المدارة من قبل العملاء عبر المستأجرين (CMK): دعم تكوين التشفير عبر المستأجرين باستخدام مفاتيح يديرها العميل، مع تمكين النسخ الاحتياطية المتكررة جغرافيا أو بدونها.

مرونة إصدار PostgreSQL: يزيل قيد تعداد إصدار PostgreSQL، مما يسمح بإنشاء الخادم وترقيات الإصدار الرئيسية لدعم إصدارات PostgreSQL التي تم إصدارها حديثا دون الحاجة إلى تحديث مخطط واجهة برمجة التطبيقات.
2026-07-01-معاينة Preview يتضمن جميع الإمكانات من إصدارات واجهة برمجة التطبيقات السابقة، مع الإضافات التالية:

PostgreSQL 19: إضافة الإصدار 19 من PostgreSQL إلى قائمة التعداد المدعومة PostgresMajorVersion .

عامل قاعدة البيانات (DBAgent): يقدم مورد DBAgent جديد وعمليات الإدارة المرتبطة به.

إدارة التخزين: إضافة خصائص تخزين جديدة لدعم Premium SSD v2 وتكوين التخزين التلقائي.
معاينة 2026-04-01 Preview يتضمن جميع الإمكانات من إصدارات واجهة برمجة التطبيقات السابقة، مع الإضافات التالية:

إدارة الصيانة:MaintenanceEvent يقدم واجهة برمجة التطبيقات مع عمليات لاسترداد تفاصيل حدث الصيانة، وسرد أحداث الصيانة حسب الخادم، وإعادة جدولة الصيانة المخطط لها، وتطبيق تحديثات الصيانة المتاحة عند الطلب.

التحقق المسبق من ترقية الإصدار الرئيسي:MajorVersionUpgradePrecheck يقدم واجهة برمجة التطبيقات مع عمليات Get and List by Server، جنبا إلى جنب مع عملية جديدة MajorVersionUpgradePrecheck على واجهة برمجة تطبيقات الخوادم لبدء عمليات التحقق من الصحة قبل الترقية.

المفاتيح المدارة من قبل العملاء عبر المستأجرين (CMK):primaryFederatedIdentityClientId إضافة وخصائص geoBackupFederatedIdentityClientId إلى واجهة برمجة تطبيقات الخوادم لدعم تشفير البيانات عبر المستأجرين باستخدام مفاتيح يديرها العميل.
2026-01-01-معاينة Preview يتضمن جميع الإمكانات من إصدارات واجهة برمجة التطبيقات السابقة، مع الإضافة التالية:

الشبكات: دعم ترحيل الخوادم من تكامل الشبكة الظاهرية (VNet) إلى الوصول العام والشبكات الخاصة القادرة على نقطة النهاية.
2025-08-01 مستقر (GA) ميزات GA السابقة +
دعم PG 18
دعم PG 17
يضيف دعما لتحديد اسم قاعدة البيانات الافتراضية في نظام مجموعة مرن
إضافة دعم لتوصيات الجدول
يصحح رموز استجابة HTTP لتعكس ما يمكن أن تعرضه كل واجهة برمجة تطبيقات
يضيف مثالا لتشفير البيانات المستند إلى CMK مع التحديث التلقائي لإصدار المفتاح
يضيف مثالا لإنشاء خادم في الشبكة الظاهرية المملوكة لشركة Microsoft
يعيد تسمية الملفات لتمثيل محتوياتها بشكل أفضل
إعادة تسمية معرفات العمليات لتحسين التنظيم والوضوح والتنقل
يحسن البيانات الوصفية للتعريفات المحلية
يحسن الأوصاف لتحقيق الاتساق
2025-06-01-preview Preview يعيد تسمية الملفات لتمثيل محتوياتها بشكل أفضل
إعادة تسمية العمليات لتحسين التنظيم والوضوح والتنقل
يضيف مثالا لتشفير البيانات المستند إلى CMK مع التحديث التلقائي لإصدار المفتاح
يضيف مثالا لإنشاء خادم في الشبكة الظاهرية المملوكة لشركة Microsoft
إضافة دعم لتوصيات الجدول
يضيف دعما لتحديد اسم قاعدة البيانات الافتراضية في نظام مجموعة مرن
يزيل دعم ميزة ضبط المعلمات
يحسن الأوصاف
يحسن البيانات الوصفية للتعريفات المحلية
يصحح رموز استجابة HTTP لتعكس ما يمكن أن تعرضه كل واجهة برمجة تطبيقات
2025-01-01-preview Preview إضافة دعم لميزة ضبط المعلمات
2024-11-01-preview Preview ضبط الفهرس
أنواع المصادر المضافة للترحيل
دعم PG 17
دعم نوع التخزين UltraSSD_LRS
المجموعات المرنة على مثيلات الخادم المرنة
2024-08-01 مستقر (GA) ميزات GA السابقة +
Geo + CMK - انعاش تم إسقاطه
النمو التلقائي للتخزين
تحجيم IOPS
واجهة برمجة تطبيقات جديدة لقدرة الموقع
النسخ الاحتياطي للاحتفاظ طويل المدى
سجلات الخادم
هجرات
التحقق المسبق للترحيل
قراءة النسخ المتماثلة - التبديل (تبديل الموقع)
قراءة النسخ المتماثلة - نقاط النهاية الظاهرية
نقاط النهاية الخاصة
واجهات برمجة تطبيقات Azure Defender / الحماية من التهديدات
دعم PG 16
دعم نوع التخزين PremiumV2_LRS
تغييرات إمكانية الموقع ل SSDv2
أدوار الترحيل
معرف مورد مثيل الترحيل لدعم عمليات ترحيل نقطة النهاية الخاصة
النسخ الاحتياطي عند الطلب
الهوية المدارة المعينة من قبل النظام
2023-06-01-preview Preview ميزات GA السابقة +
التحقق المسبق للترحيل
قراءة النسخ المتماثلة - التبديل (تبديل الموقع)
قراءة النسخ المتماثلة - نقاط النهاية الظاهرية
نقاط النهاية الخاصة
واجهات برمجة تطبيقات Azure Defender\Threat Protection
دعم PG 16
دعم نوع التخزين PremiumV2_LRS
تغييرات إمكانية الموقع ل SSDv2
واجهة برمجة تطبيقات استخدام الحصة النسبية
2023-03-01-preview Preview ميزات إصدار GA الجديد (2022-12-01) +
جيو + CMK
النمو التلقائي للتخزين
تحجيم IOPS
واجهة برمجة تطبيقات إمكانية الموقع الجديدة
Azure Defender
سجلات الخادم
هجرات
2022-12-01 مستقر (GA) ميزات GA السابقة +
معرف الإدخال
CMK
نسخ احتياطية
Administrators
Replicas
GeoRestore
MVU
2022-05-01-preview Preview CheckMigrationNameAvailability
هجرات
2021-06-01 مستقر (GA) ميزات GA السابقة +
CRUD للخادم
CheckNameAvailability
التكوينات (المعلمات)
قاعدة بيانات
قواعد جدار الحماية
Private
لاحقة منطقة DNS
PITR
إعادة تشغيل الخادم
بدء تشغيل الخادم
إيقاف الخادم
نافذة الصيانة
استخدام الشبكة الفرعية للشبكة الظاهرية

قائمة عمليات واجهة برمجة التطبيقات الثابتة

يتم سرد كل عملية واجهة برمجة تطبيقات مستقرة مدعومة وتفاصيلها في الجدول التالي.

الميزة/التشغيل التفاصيل
Administrators إدارة مسؤولي خوادم Microsoft Entra ID
حماية من المخاطر المتقدمة إدارة إعدادات الحماية المتقدمة من التهديدات
النسخ الاحتياطي والاستعادة إدارة النسخ الاحتياطية التلقائية والنسخ الاحتياطية للخادم عند الطلب
Capabilities سرد قدرات الخادم المتوفرة حسب الموقع والخادم
تكوينات عرض معلمات خادم PostgreSQL وإدارتها
Databases إنشاء قواعد البيانات وقراءتها وتحديثها وحذفها وإدراجها
تشفير البيانات تكوين المفاتيح المدارة من قبل العميل (CMK)، بما في ذلك التشفير عبر المستأجرين
قواعد جدار الحماية إنشاء قواعد جدار الحماية وقراءتها وتحديثها وحذفها وإدراجها
Long-Term الاحتفاظ إدارة عمليات النسخ الاحتياطي الاستبقاء على المدى الطويل
أحداث الصيانة سرد أحداث الصيانة واستردادها وإعادة جدولتها وتطبيقها عند الطلب
التحقق المسبق من ترقية الإصدار الرئيسي بدء عمليات التحقق من الصحة قبل الترقية واسترداد نتائج التحقق من الصحة
هجرات إنشاء عمليات ترحيل قاعدة البيانات وإدارتها
توفر الأسماء التحقق من توفر اسم الخادم ونقطة النهاية الظاهرية
ترحيل وضع الشبكة ترحيل الخوادم من تكامل VNet إلى تكوين شبكة Private Link
العمليات سرد عمليات إدارة موفر الموارد المتوفرة
ضبط الأداء استرداد خيارات الضبط وتوصيات تحسين قاعدة البيانات
لاحقة منطقة Private DNS استرداد لاحقة منطقة DNS الخاصة
نقاط النهاية الخاصة إدارة اتصالات نقطة النهاية الخاصة
موارد Private Link سرد موارد الارتباط الخاص
استخدام الحصص استرداد الحصة النسبية للخادم الإقليمي ومعلومات الاستخدام
قراءة النسخ المتماثلة إنشاء النسخ المتماثلة للقراءة وإدارتها، بما في ذلك الترقية والتبديل
الخوادم إنشاء الخوادم وقراءتها وتحديثها وحذفها وإدراجها وبدء تشغيلها وإيقافها وإعادة تشغيلها
نقاط النهاية الافتراضية إنشاء نقاط النهاية الظاهرية وإدارتها
Virtual Network استخدام الشبكة الفرعية استرداد معلومات استخدام الشبكة الفرعية للشبكة الظاهرية

معاينة قائمة عمليات واجهة برمجة التطبيقات

يسرد الجدول التالي كل عملية واجهة برمجة تطبيقات معاينة مدعومة وتفاصيلها.

الميزة/التشغيل التفاصيل
Administrators إنشاء مسؤولي الخادم Microsoft Entra ID واستردادهم وإدراجهم وحذفهم
حماية من المخاطر المتقدمة استرداد إعدادات الحماية المتقدمة من التهديدات وإدراجها وتحديثها
النسخ الاحتياطي والاستعادة إنشاء النسخ الاحتياطية عند الطلب واستردادها وإدراجها وحذفها؛ قائمة النسخ الاحتياطية التلقائية المتوفرة
Capabilities سرد قدرات الخادم المتوفرة حسب الموقع والخادم
السجلات التي تم الاستيلاء عليها قائمة سجلات الخادم الملتقطة المتوفرة للتنزيل
تكوينات استرداد معلمات خادم PostgreSQL وإدراجها وتحديثها
عوامل قاعدة البيانات سرد تكوينات عامل قاعدة البيانات واستردادها وتمكينها وتعطيلها
Databases إنشاء قواعد البيانات واستردادها وإدراجها وحذفها
تشفير البيانات تكوين المفاتيح المدارة من قبل العميل (CMK)، بما في ذلك التشفير عبر المستأجرين
قواعد جدار الحماية إنشاء قواعد جدار الحماية واستردادها وتحديثها وإدراجها وحذفها
Long-Term الاحتفاظ التحقق من صحة المتطلبات الأساسية للنسخ الاحتياطي، وبدء النسخ الاحتياطية للاحتفاظ على المدى الطويل، واسترداد نتائج عملية النسخ الاحتياطي
أحداث الصيانة استرداد أحداث الصيانة وسردها، والتصفية حسب الحالة القادمة أو السابقة، وإعادة جدولة الصيانة، وتطبيق الصيانة على الفور
التحقق المسبق من ترقية الإصدار الرئيسي بدء عمليات التحقق من صحة ما قبل الترقية واسترداد نتائج التحقق من الصحة أو سردها
هجرات إنشاء عمليات ترحيل قاعدة البيانات واستردادها وإدراجها وتحديثها وإلغائها؛ التحقق من توفر اسم الترحيل
توفر الأسماء التحقق من توفر اسم الخادم ونقطة النهاية الظاهرية عالميا أو حسب الموقع
ترحيل وضع الشبكة ترحيل الخوادم من تكامل VNet إلى نموذج شبكة Private Link قادر على
العمليات سرد عمليات إدارة موفر الموارد المتوفرة
ضبط الأداء استرداد خيارات الضبط وتوصيات تحسين الفهرس أو الجدول
لاحقة منطقة Private DNS استرداد لاحقة منطقة DNS الخاصة
نقاط النهاية الخاصة استرداد اتصالات نقطة النهاية الخاصة وإدراجها والموافقة عليها ورفضها وحذفها
موارد Private Link استرداد موارد الارتباط الخاص وإدراجها
استخدام الحصص استرداد استخدام الحصة النسبية الإقليمية للخوادم المرنة
قراءة النسخ المتماثلة إنشاء النسخ المتماثلة للقراءة وإدراجها وإدارتها، بما في ذلك الترقية والتبديل
الخوادم إنشاء واسترداد وتحديث وحذف وسرد الخوادم؛ بدء تشغيل الخوادم وإيقافها وإعادة تشغيلها
إدارة التخزين تكوين Premium SSD v2 والتحجيم التلقائي للتخزين من خلال خصائص تخزين الخادم
نقاط النهاية الافتراضية إنشاء نقاط النهاية الظاهرية واستردادها وتحديثها وإدراجها وحذفها
Virtual Network استخدام الشبكة الفرعية استرداد معلومات استخدام الشبكة الفرعية للشبكة الظاهرية

استخدام إصدارات المعاينة لواجهة برمجة التطبيقات من Terraform

Terraform هو أداة برمجية للبنية التحتية كتعليمية (IaC) تم إنشاؤها بواسطة HashiCorp. يحدد المستخدمون البنية الأساسية لمركز البيانات ويوفرونها باستخدام لغة تكوين تعريفية تعرف باسم HashiCorp Configuration Language (HCL)، أو JSON اختياريا. Terraform هي طريقة شائعة لتنفيذ إدارة IaC لقاعدة بيانات Azure ل PostgreSQL استنادا إلى GA Azure RM API، بالإضافة إلى قوالب Azure Resource Manager (ARM) يصدر مجتمع Terraform تحديثات منتظمة لموفر Azure Resource Manager (AzureRM) استنادا إلى إصدار واجهة برمجة تطبيقات Azure Resource Manager في التوفر العام (GA).

إذا كانت ميزة معينة موجودة حاليا في واجهة برمجة تطبيقات المعاينة ولم يتم دمجها بعد في واجهة برمجة تطبيقات GA وموفر AzureRM Terraform، فاستخدم موفر AzAPI Terraform لاستدعاء واجهة برمجة تطبيقات المعاينة مباشرة من Terraform. موفر AzAPI هو طبقة رقيقة أعلى واجهات برمجة تطبيقات REST ل Azure Resource Manager. يتيح لك موفر AzAPI إدارة أي نوع مورد Azure باستخدام أي إصدار من إصدارات واجهة برمجة التطبيقات. موفر AzAPI هو طبقة رقيقة أعلى واجهات برمجة تطبيقات AZURE ARM REST. باستخدام موفر AzAPI، يمكنك إدارة أي نوع مورد Azure باستخدام أي إصدار API. يكمل هذا الموفر موفر AzureRM من خلال تمكين إدارة موارد وخصائص Azure الجديدة (بما في ذلك المعاينة الخاصة).

يتميز موفر AzAPI بالمزايا التالية:

  • يدعم جميع خدمات Azure:
  • خدمات وميزات المعاينة الخاصة
  • خدمات وميزات المعاينة العامة
  • جميع إصدارات واجهة برمجة التطبيقات
  • دقة ملف حالة Terraform الكاملة
  • يتم حفظ الخصائص والقيم في الحالة
  • لا توجد تبعية على Swagger
  • مصادقة Azure الشائعة والمتناسقة

AzAPI2AzureRM هو أداة مفتوحة المصدر صممت للمساعدة في الانتقال من مزود AzAPI إلى مزود AzureRM.

جهات الاتصال

لأية أسئلة أو اقتراحات قد تكون لديك حول قاعدة بيانات Azure ل PostgreSQL، أرسل بريدا إلكترونيا إلى قاعدة بيانات Azure لفريق PostgreSQL (@Ask قاعدة بيانات Azure ل PostgreSQL). لاحظ أن عنوان البريد الإلكتروني هذا ليس اسما مستعارا للدعم التقني.

وبالإضافة إلى ذلك، ضع في الاعتبار نقاط الاتصال التالية حسب الاقتضاء: