Microsoft Dataverseنظرة عامة على حدود واجهة برمجة التطبيقات

تساعد تقييدات واجهة API لـ Dataverse على ضمان مستويات الخدمة والتوفر والجودة. تُمثل تقييدات API Dataverse جزءًا من تقييدات طلب Power Platform وتخصيصاته. ستقدم هذه المقالة تقييدات خاصة بـ Dataverse تنطبق على Power Apps وPower Automate وتطبيقات مشاركة العميل (Dynamics 365 Sales وDynamics 365 Customer Service وDynamics 365 Field Service وDynamics 365 Marketing وDynamics 365 Project Service Automation) التي تتصل بـ Dataverse.

لمزيد من المعلومات حول التقييدات لكافة المناطق داخل Power Platform، راجع تقييدات طلب Power Platform والتخصيصات.

هناك فئتان من الحدود التي تنطبق عليها Dataverse: الاستحقاق و حماية الخدمة الحدود كما تم تلخيصها أدناه.

Service Protection limits	Power Platform Request (API Entitlement) limits
Immediately return 429 Too Many Requests when limits are exceeded.	Enforced for Power Automate flows but will have provisions for occasional overages on Dataverse, when enforced
Evaluated in a 5-minute sliding window.	Evaluated in a 24-hour period.
Applies to all external requests to Dataverse web services.	Applies to all compute operations and analytics originating from internal or external requests.
Developer is responsible for avoiding conditions that can cause errors and managing retry when they occur.	Administrator is responsible to manage assigned capacity. They can purchase capacity add-ons to increase limits.
Enforced today within the product.	- Will be enforced after preview report, available today for administrators to track and estimate usage, is made generally available. -Preview reports are available now.
More information: https://aka.ms/serviceprotectionlimits	More information: https://aka.ms/PlatformLimits

قيود الاستحقاق

تمثل هذه القيود عدد الطلبات المُستحقة للمستخدمين لإنجاز كل يوم. يعتمد الحد المُخصص على نوع الترخيص المُعيّن لكل مستخدم.

إذا تجاوز أي مستخدم استحقاق طلبه، فسوف يتعين إعلام المسؤول وسوف قادرًا على تعيين Power Apps وسعة طلب Power Automate لهذا المستخدم. ولن يتم حظر المستخدمين من استخدام التطبيقات للمتوسطات العرضية والمعقولة في هذا الوقت.

بالنسبة إلى Dataverse، تتضمن طلبات واجهة API كافة عمليات البيانات التي تتفاعل مع صفوف الجدول حيث يتم إنشاء الصفوف أو استردادها أو تحديثها أو حذفها (CRUD). ويتم تضمين العمليات الخاصة مثل مشاركة و تعيين لأنها تُعتبر تحديثات. يُمكن أن تكون هذه الطلبات من أي عميل أو تطبيق وباستخدام أي نقطة نهاية. وتشمل هذه ، على سبيل المثال لا الحصر ، العمليات التي يتم إجراؤها بواسطة المكونات الإضافية ، ومهام سير العمل غير المتزامنة ، وعناصر التحكم المخصصة ، وعمليات الدُفعات (ExecuteMultiple). هناك مجموعة صغيرة من العمليات الداخلية للنظام مستبعدة ، مثل تسجيل الدخول وتسجيل الخروج وعمليات البيانات الوصفية للنظام.

هام

تتضمن عمليات توزيع طلبات Power Platform API استخدام Power Automate، وAI Builder، وواجهات برمجة تطبيقات الموصلات. سوف تُمثل كافة الطلبات عبر موصل التي ينتج عنها طلب Dataverse، طلب Power Platform.

لمعرفة تفاصيل بخصوص حدود الاستحقاق هذه، راجع تخصيصات طلبات Microsoft Power Platform بناءً على التراخيص.

لمزيد من المعلومات حول عرض وتخصيص الدالات الإضافية للسعة، راجع الدالات الإضافية للسعة.

للحصول على معلومات حول شراء الدالات الإضافية للسعة الفردية، راجع دليل ترخيص Power Apps وPower Automate .

حدود حماية الخدمة

لضمان التوافر والأداء المتناسق لكل شخص، نقوم بتطبيق بعض القيود على كيفية استخدام واجهات API باستخدام Dataverse. تُساعد قيود API لحماية الخدمة على التأكد من عدم تداخل المستخدمين الذين يقومون بتشغيل التطبيقات مع بعضهم البعض بناءً على قيود الموارد. لن تؤثر الحدود على مستخدمي النظام الأساسي العاديين. وقد تتأثر فقط التطبيقات التي تؤدي عددًا كبيرًا من طلبات API. وتوفر الحدود مستوى من الحماية من التغييرات المفاجئة والعشوائية في أحجام الطلبات التي تهدد توفر وأداء خصائص النظام الأساسي Dataverse.

وسوف نقوم بتحديد عدد الاتصالات المتزامنة لكل حساب مستخدم وعدد طلبات API لكل اتصال ومقدار الفترة الزمنية للتنفيذ التي يُمكن استخدامها لكل اتصال. يتم تقييم هذه المقاييس خلال نافذة انزلاقية مدتها خمس دقائق. وعند تجاوز أحد هذه الحدود، سيتم طرح استثناء بواسطة النظام الأساسي.

ملاحظة

تنطبق حدود حماية الخدمة على كافة طلبات خدمات ويب الخارجية، وليس فقط عمليات CRUD على الجداول التي يتم حسابها مقابل حدود الاستحقاق.

لا تنطبق حدود API الخاصة بحماية الخدمة في مقابل استدعاءات API التي تم اجراؤها ضمن مهام سير العمل، أو أنشطة سير العمل المخصصة أو رمز المكون الإضافي. يتم استدعاء هذه العمليات داخليًا.

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

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

راجع أيضًا

إدارة Power Platform /الترخيص وإدارة الرخصة/ قيود الطلبات والتخصيصات
المطور /العمل باستخدام رمز استخدام البيانات /القيود المفروضة على API لحماية الخدمة