هذه المقالة تمثل منصة للإشعارات حول التغييرات التي قد تكون مكسورة وإعلانات نهاية العمر (EoL) للهيكلية البيانية (GraphQL) الخاصة بواجهة برمجة تطبيقات كاتو وتحتوي على معلومات قد تتطلب منك تحديث عميل واجهة البرمجة.
تم توضيح المصطلحات المستخدمة في واجهة برمجة التطبيقات في هذه المقالة في ما هي واجهة برمجة تطبيقات كاتو.
لأي عملاء يستخدمون واجهة برمجة تطبيقات كاتو، نوصي بالنقر على متابعة لتلقي إشعارات البريد الإلكتروني تلقائيًا لتحديثات هذه المقالة المتعلقة بتغييرات واجهة البرمجة. يمكنك أيضًا رؤية المزيد من المعلومات حول واجهات برمجة التطبيقات الجديدة والمحدثة في سجل التغييرات لواجهة برمجة تطبيقات Cato.
لمزيد من المعلومات حول واجهات برمجة التطبيقات، انظر مرجع واجهة برمجة تطبيقات GraphQL لشبكات كاتو.
حاليًا، قد يعيد بوابة API الخاصة بـ Cato حقول المعرف كإما سلسلة نصية أو عدد صحيح طويل (integer). كجزء من تحديث البنية التحتية القادمة، سيتم إعادة جميع حقول المعرف بشكل متسق كسلاسل نصية.
-
ما الذي يتغير: ستعيد استجابات API التي أعادت سابقًا حقول المعرف كقيم عددية طويلة (على سبيل المثال،
1000000002) دائماً إعادتها كسلاسل نصية (على سبيل المثال،"1000000002"). - من المتأثر: عملاء API الذين يتعاملون مع حقول المعرف بشكل صارم كنواع طويلة/عدد صحيح قد يتعرضون للخلل عند تنفيذ هذا التغيير.
- ماذا يجب أن تفعل قبل 21 يونيو 2026: قم بتحديث كود عميل API الخاص بك لقبول كل من الأنواع الطويلة والسلاسل النصية لحقول المعرف. سيضمن ذلك انتقالًا سلسًا وتجنب الانقطاعات عندما يدخل التغيير حيز التنفيذ.
ففي 10 أغسطس 2025، أصبح حقل البريد الإلكتروني في واجهات addAdmin وupdateAdmin API اختياريًا (قابل للتفرغ). يدعم هذا التغيير البنية التحتية القادمة لدعم التحكم الدقيق في الوصول باستخدام واجهات برمجة التطبيقات، والتي تشمل السكريبتات والأتمتة باستخدام المبادئ الخدمية.
- يجب على مديري CMA الحاليين والمستقبليين تضمين قيمة
بريد إلكترونيدائمًا - الاستعلامات التي تُرجع فقط المديرين البشر لا تتأثر.
- قد يحتاج بعض العملاء إلى التعامل مع القيم الفارغة في حمولات الرد، مثل addAdminPayload
هذا ليس عادةً تغييرًا مكسورًا، لكنه قد يؤثر على العملاء الذين يفترضون أن email موجودة دائمًا. راجع تكاملك لتجنب المشاكل.
تستخدم واجهة برمجة التطبيقات eventsFeed علامة لتمكين السحب التكراري لتغذية الأحداث. يظهر حقل العلامة معرّفًا يحدد بداية دورة جديدة لجلب الأحداث. تقرأ واجهة برمجة التطبيقات الأحداث من القائمة بناءً على الحقل الفريد للعلامة، وتوفر موقع العلامة التالي في الاستجابة. إذا لم تكن هناك أحداث جديدة في القائمة، فإن حقل العلامة يكون فارغًا.
نموذج بديل لاستهلاك الأحداث هو استخدام التكامل المباشر بدون كود، انظر دمج أحداث كاتو مع AWS S3 ودمج أحداث كاتو مع حساب تخزين Azure.
ماذا قمنا بتغييره؟
- سابقًا، عندما لم يتم تحديد العلامة، كانت واجهة برمجة التطبيقات تُرجع أقدم علامة متاحة. كان المطلوب استهلاك قائمة الأحداث كاملة قبل الوصول إلى الأحداث الأكثر حداثة.
- اعتبارًا من 27 أبريل، 2025، إذا لم يتم تحديد علامة، فإن واجهة برمجة التطبيقات تُرجع العلامة الأحدث. هذا يسمح لواجهة برمجة التطبيقات بجلب الأحداث الأحدث مباشرة.
هل هو تغيير مكسور؟
- لا يوجد تأثير لمعظم حالات استخدام واجهة برمجة التطبيقات eventsFeed. لا يوجد تغيير عندما يتم استخدام حقل العلامة للاستعلام، ومنطق استهلاك خلاصة الأحداث هو نفسه.
-
إذا كان لديك منطق مخصص لاستهلاك القائمة للوصول إلى الأحداث الحديثة، لم يعد هذا المنطق مطلوبًا.
- الآن، إذا لم يتم تحديد علامة إدخال، فإن واجهة برمجة التطبيقات تقدم العلامة الأحدث. استدعاء واجهة برمجة التطبيقات بهذه العلامة يجلب الأحداث الأحدث
- رد واجهة برمجة التطبيقات يحتوي على علامة تشير إلى الموقع الأحدث (أعلى القائمة)
- يجب تحديث البرامج النصية والعمليات الآلية المقابلة
قمنا بتغيير وظيفة حقل limit بحيث لم يعد limit=0 مدعومًا لأنه لا يعتبر من أفضل الممارسات. لضمان استمرار العمل السلس، يجب عليك تحديث أي سكريبتات أو استعلامات تعتمد على هذا المعامل. بدلاً من ذلك، يمكنك تحديد حد بين 1-2000، والذي يدعم بشكل كامل واجهة البرمجة.
إذا كنت بحاجة لاسترداد جميع القصص، نوصي باستخدام نهج التصفح الصفحي.
حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة LastMileBWInput API كمهمَلة وانتهت حياتها في 30 يونيو 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع منتهي الصلاحية | نوع موصى به |
|---|---|
| downstream | downstreamMbpsPrecision |
| upstream | upstreamMbpsPrecision |
حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة InterfaceInfo API كمهمَلة وانتهت حياتها في 30 يونيو 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع منتهي الصلاحية | نوع موصى به |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة SocketInterfaceBandwidthInput API كمهمَلة وانتهت حياتها في 30 يونيو 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع منتهي الصلاحية | نوع موصى به |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
- تقبل واجهة برمجة التطبيقات
auditFeedقائمة من الفلاتر باستخدام النوعAuditFieldFilterInput. يتضمن كل فلترfieldNameمحددًا بالنوعFieldNameInput، الذي يتضمن حاليًا حقلي إدخال:AuditFieldNameوEventFieldName. - ومع ذلك، فقط
AuditFieldNameهو حقل إدخال صالح ومدعوم. لتحسين وضوح المخطط وتجنب الالتباس، تم إزالة حقلEventFieldNameمن المخطط في 8 يونيو 2025. - قم بتحديث جميع السكريبتات والاستعلامات التي تستخدم فلاتر
auditFeedلتستخدم فقط حقل الإدخالAuditFieldName.
حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة EventFieldName API كمهمَلة وانتهت حياتها في 1 مايو 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع منتهي الصلاحية | نوع موصى به |
|---|---|
| application | application_id/application_name |
| custom_categories | custom_category_id/custom_category_name |
| custom_category | custom_category_id/custom_category_name |
| dest_site | dest_site_id/dest_site_name |
| device_posture_profiles | device_posture_profile |
| internalId | event_id |
| rule | rule_name |
| src_site | src_site_id/src_site_name |
الحقول والأنواع التالية في EventFieldName API تم تحديدها بأنها مستغنى عنها وتم إنهاء العمر (EoL) اعتبارًا من 1 مارس 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع متوقف | نوع موصى به |
|---|---|
| parent_pid | src_process_parent_pid |
| pid | src_pid |
| process_path | src_process_path |
الحقل التالي في StoryDrillDownFilter Beta API تم تحديده بأنه مستغنى عنه وتم إنهاء العمر (EoL) اعتبارًا من 23 فبراير 2025.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع مهمل | نوع موصى به |
|---|---|
| value | values |
بعد الإعلان عن انتهاء العمر لبعض قيم النوع الفرعي المستخدمة في واجهات برمجة التطبيقات الخاصة باستهلاك الأحداث المتعلقة بعملاء Cato، تم تعليق الإطلاق لحسابات تستخدم موقع CMA في أيرلندا (cc.catonetworks.com) للحقول التالية:
| نوع مهمل | نوع موصى به |
|---|---|
| معاد الاتصال | متصل أو غير متصل |
| تغيير PoP |
متصل أو غير متصل (يتم إرجاع اسم PoP في حقل lastPopName.) |
- لمزيد من المعلومات، راجع التوجيهات التقنية لـ CMA
وُضِعَت علامة على الحقول والأنواع المتعلقة بعميل Cato كمهملة وستنتهي في ٢ يناير ٢٠٢٥.
يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.
| نوع مهمل | نوع موصى به | ملاحظات |
|---|---|---|
| VPN عدم التجاوز أبداً | تجاوز دائم | يتم استبدال قيمة النوع الفرعي VPN عدم التجاوز أبداً بالقيمة تجاوز دائم |
| معاد الاتصال | متصل أو غير متصل | لزيادة التفصيل، يتم تقسيم قيمة النوع الفرعي معاد الاتصال إلى قيمتين جديدتين، متصل وغير متصل |
| تغيير PoP |
متصل أو غير متصل (يتم إرجاع اسم PoP في حقل lastPopName) |
لزيادة التفصيل، يتم تقسيم قيمة النوع الفرعي تغيير PoP إلى قيمتين جديدتين، متصل وغير متصل |
- لمزيد من المعلومات، انظر هذه المقالة: الإيقاف المتوقع لبعض الأنواع الفرعية لبيانات أحداث Cato
لا توجد تعليقات
الرجاء تسجيل الدخول لترك تعليق.