نوصي بشدة بأنه قبل بدء استخدام API Cato، يُرجى مراجعة سياسة الدعم لـ API Cato.

نظرة عامة على auditFeed

يساعد استعلام auditFeed على تحليل الإجراءات التي يقوم بها المسؤولون في تطبيق إدارة Cato. البيانات التي يعيدها هذا الاستعلام مشابهة لنافذة النظام > مسار التدقيق في تطبيق إدارة Cato.

لحسابات البائعين، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل تتصل به API Cato. لمزيد من المعلومات حول تحديد المعدل واستعلام auditFeed API، يرجى الاطلاع على فهم تحديد معدل API Cato.

فهم البيانات المسترجعة

الاتصال auditFeed API مصمم لدعم سحب أكثر من مليوني عنصر من بيانات التدقيق في الساعة. للمساعدة في تقسيم البيانات المسترجعة، عند وجود أكثر من 1000 عنصر تدقيق في إطار الوقت المحدد، يتكرر الاستعلام لجلب جميع بيانات التدقيق.

هذه الحقول مرتبطة بتقسيم صفحات بيانات التدقيق: العلامة، عدد العناصر المسترجع، وهل هناك المزيد. انظر أدناه لتفسيرات هذه الحقول.

تفاصيل حقول auditFeed

هذه هي التفاصيل التي يمكن أن تُظهرها حقول auditFeed للاستعلام:

• من - وقت البدء
• إلى - وقت الانتهاء
• العلامة - الحقل العلامة هو معرف فريد لآخر عنصر من بيانات التدقيق الذي أعاده استعلام API.
• عدد العناصر المسترجع - عدد العناصر المسترجعة (الحد الأقصى 1000 عنصر لكل استرجاع)
• هل هناك المزيد - عند الحقيقية، يشير إلى أن هناك المزيد من العناصر للاستعلام المسترجع
• الحسابات (auditFeedAccountRecords) - للبائعين الذين يديرون حسابات متعددة، يحدد هذا الحقل الحساب الذي تم تغييره ويشمل جميع السجلات وبيانات التدقيق (مصفوفة مع استعلامات وحقول متداخلة)

auditFeed من

يعرض حقل من وقت البدء لبيانات الاستعلام ويُعرّف في المعامل timeFrame.

auditFeed إلى

يعرض حقل إلى وقت الانتهاء لبيانات الاستعلام ويُعرّف في المعامل timeFrame.

علامة auditFeed

عندما يوجد أكثر من 1000 عنصر من بيانات التدقيق في مدة الاستعلام، يعرض الحقل العلامة معرفًا يشير إلى بدء تكرار جديد لجلب العناصر. على سبيل المثال، إذا أعاد الاستعلام 2500 عنصر، فهذه هي النتائج خلال تكرارات الجلب:

• التكرار الأول - عدد العناصر المسترجع = 1000 (عنصر)، العلامة = 1234abc، هل هناك المزيد = true
• التكرار الثاني - عدد العناصر المسترجع = 1000 (عنصر)، العلامة = 4567def، هل هناك المزيد = true
• التكرار الثالث - عدد العناصر المسترجع = 500 (عنصر)، العلامة = 8901xyz، هل هناك المزيد = false

  يمكنك تجاهل قيمة العلامة في التكرار النهائي

عدد العناصر المسترجع في auditFeed

يعرض حقل عدد العناصر المسترجع العدد الإجمالي للعناصر في إجراء الاسترجاع الحالي. القيمة القصوى لهذا الحقل هي 1000.

هل هناك المزيد في auditFeed

عندما يكون قيمة الحقل هل هناك المزيد true، فهناك تكرار آخر لجلب العناصر بعد هذا.

حسابات auditFeed

تعرض حقول الحسابات (auditFeedAccountRecords) معرفات المسؤولين وبيانات التدقيق لهذا الاستعلام. استخدم المعامل auditFeedAccountsRecords > AuditRecord > AuditFieldName لتصفية بيانات الحدث التي تم عرضها للاستعلام. لمزيد من المعلومات حول حقول AuditRecords، يُرجى الاطلاع أدناه auditFeed > fieldName > AuditFieldName.

معاملات auditFeed

هذه هي المعاملات التي يمكنك تمريرها وتحديد البيانات التي يُرجعها الاستعلام:

• معرفات حساب - معرفات الحساب (لحسابات متعددة، أدخل المعرفات كمصفوفة)
• المعرفات - معرف الحساب (معامل قديم)
• إطار زمني - وقت البدء والانتهاء للاستعلام
• التصفية (AuditFieldFilterInput) - تصفية بيانات سجل التدقيق التي تم استعلامها (مصفوفة مع استعلامات متداخلة)
• العلامة - عرض العناصر فقط لاسترجاع محدد حسب قيمة العلامة

معامل معرفات حساب auditFeed

أدخل واحد أو أكثر من معرفات الحساب للبيانات التي يعيدها الاستعلام. هذا المعامل إلزامي.

هذا المعرف للحساب غير معروض في تطبيق إدارة Cato، بل هو الرقم في عنوان التطبيق URL لتطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 للعنوان URL التالي: https://cc2.catonetworks.com/#!/26/topology.

معامل إطار الوقت auditFeed

أدخل الإطار الزمني للبيانات التي يعيدها الاستعلام. المعامل هو في الصيغة <type>.<time value>. هذا المعامل إلزامي.

هذه هي الخيارات المدعومة لتحديد الإطار الزمني:

• last.<time duration> - قيمة <time duration> لنوع last تكون حسب ISO-8601 وتعيد بيانات للفترات الزمنية المحددة السابقة. على سبيل المثال:
  • إطار الوقت = last.PT5M يعرض الدقائق الخمس السابقة
  • إطار الوقت = last.PT2H يعرض الساعتين السابقتين
  • إطار الوقت = last.P1D يعرض اليوم السابق
  • إطار الوقت = last.P3M يعرض الأشهر الثلاثة السابقة
  • إطار الوقت = last.P1Y يعرض السنة السابقة
• <timezone>.<short-time-frame-spec> - يجمع الإطار الزمني بين تاريخ البدء والإنهاء في الصيغة YY-MM-DD/hh:mm:ss حسب المنطقة الزمنية المحددة. على سبيل المثال، إطار الوقت = utc.2020-02-{11/04:50:00--21/04:50:00} يعرض بيانات التحليل من 11 فبراير 2020 4:50:00 صباحًا إلى 21 فبراير 2020 4:50:00 صباحًا.

معامل التصفية auditFeed

يسمح لك معامل التصفية (AuditFieldFilterInput) بتحديد العنصر المحدد الذي يتم تضمينه في استعلام مسار التدقيق. هذه هي المعاملات التي يمكنك تحديدها:

• fieldName > AuditFieldName - حدد العناصر من مسار التدقيق
• المشغل - حدد كيفية تفعيل القيم لتصفية بيانات التدقيق
• القيم - حدد قيمة التصفية التي تُستخدم مع المشغل

auditFeed > fieldName > AuditFieldName

هذه هي أسماء الحقول لأنواع مختلفة من تكوينات تطبيق إدارة Cato التي تتم مراقبتها في النظام > مسار التدقيق.

• مسؤول - المسؤول الذي تسبب فعله في إنشاء السجل
• اسم النموذج - اسم الكائن الذي تأثر، على سبيل المثال موقعي
• معرف المسؤول - معرف مسؤول الفعل الذي تسبب في إنشاء السجل
• الوحدة - وحدة النظام التي تم تغييرها، مثل تكوين MFA أو فحص TLS
• تاريخ الإدراج - الوقت الذي تم فيه الالتزام أو حفظ التغيير
• نوع التغيير - يصف التغيير الذي قام به المسؤول، القيم هي: مُنشأ، مُحذوف، مُعدَّل، مفعَّل، مُعطَّل، متخطى
• تاريخ الإنشاء - الوقت الذي بدأ فيه التغيير
• التغيير - حساب تفصيلي للتغيير بتنسيق JSON
• نوع النموذج - نوع الكائن الذي تم تغييره، على سبيل المثال الموقع، المقبس، واجهة المقبس

معامل العلامة auditFeed

يسمح لك معامل العلامة بتقييد الاستعلام على الأحداث لتكرار جلب محدد. لعرض قيم العلامات، قم بتشغيل الاستعلام مع معامل العلامة بقيمة فارغة. يعيد الاستعلام قيم العلامة للمعامل timeFrame المحدد.

على سبيل المثال، إذا أعاد الاستعلام 2500 حدث، فهذه هي النتائج خلال أول ثلاث تكرارات للجلب:

• التكرار الأول - عدد الأحداث المسترجع = 1000 (حدث)، العلامة = 1234abc، هل هناك المزيد = true
• التكرار الثاني - عدد الأحداث المسترجع = 1000 (حدث)، العلامة = 4567def، هل هناك المزيد = true
• التكرار الثالث - عدد الأحداث المسترجع = 1000 (حدث)، العلامة = 8901xyz، هل هناك المزيد = true

لعرض الأحداث في التكرار الثاني فقط، قم بتعيين معامل العلامة إلى 4567def.