إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توفر هذه المقالة أحدث الأخبار والتحديثات حول إصدارات واجهة برمجة التطبيقات الموصى بها لاستخدامها. قد يتم دعم إصدارات واجهة برمجة التطبيقات غير المدرجة هنا، ولكن سيتم إيقافها قريبا. ابحث عن الوثائق الخاصة بأحدث إصدار معاينة وواجهة برمجة تطبيقات مستقرة متاحة هنا.
إصدارات واجهة برمجة التطبيقات
يلخص هذا القسم تغييرات الميزة عبر كل إصدار قاعدة بيانات 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). لاحظ أن عنوان البريد الإلكتروني هذا ليس اسما مستعارا للدعم التقني.
وبالإضافة إلى ذلك، ضع في الاعتبار نقاط الاتصال التالية حسب الاقتضاء:
- للاتصال بدعم Azure، قم بتقديم تذكرة من مدخل Microsoft Azure.
- لإصلاح مشكلة في حسابك، قم بتقديم طلب دعم في مدخل Azure.
- لتقديم ملاحظات أو لطلب ميزات جديدة، قم بإنشاء إدخال عبر UserVoice.