usage.threshold_reached

إصدار API 2026-10-affable-towhee

Lingara ← أنت usage.threshold_reached

استخدم حساب أو عميل يُفوتَر بحسب الاستهلاك جزءًا من حدّ الإنفاق الشهري. لا يُبلَّغ إلا عن أعلى عتبة تم تجاوزها، لذا فإن الاستخدام الذي يقفز من 40% إلى 95% يرسل حدثًا واحدًا مع threshold_pct بقيمة 90. أما التكامل الذي يُفوتَر من حصة فلا يتلقّاه أبدًا.

النطاقات events:readusage:read

طرق النقل خطاف ويب الموجزGET /v1/events البثGET /v1/events/stream

الحمولة

idstringمطلوب

typestringمطلوب

created_atstringمطلوب

api_versionstringمطلوب

subjectstringمطلوب

dataUsageThresholdReachedDataمطلوب

scopeThresholdScopeمطلوب

threshold_pctintegerمطلوب

monthstringمطلوب

client_idstring | nullاختياري

مثال

{
  "id": "lgr_evt_9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b",
  "type": "usage.threshold_reached",
  "created_at": "2026-10-01T12:00:00Z",
  "api_version": "2026-09-equipped-boxfish",
  "subject": "lgr_sub_8f445eaad6febfab1731b2f8cb17c24e",
  "data": {
    "scope": "client",
    "threshold_pct": 100,
    "month": "2026-10",
    "client_id": "lgr_cid_4hT9kQ2mZx7Lp1Vb8Nc3Rw"
  }
}

إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.