الانتقال إلى المحتوى الرئيسي
POST
مفتاح إيقاف الطوارئ
استخدم نقطة النهاية هذه لحالة طوارئ مثل وكيل مخترق. قم بتوفير معرف الوكيل وحادث غير فارغ reason (بحد أقصى 2000 بايت UTF-8). تحدد مساحة العمل والبيئة الموثقة الوكيل الذي يمكنك إلغاءه. تقوم العملية بإلغاء الوكيل وذريته المفوضة، وإنهاء جلساتهم النشطة، وإلغاء روابط التفويض النشطة الخاصة بهم، والاحتفاظ بالقرار في معاملة قاعدة بيانات واحدة. إذا فشلت هذه المعاملة، يتم التراجع عن تغييرات حالتها.
الإلغاء دائم. سجل وكيلًا جديدًا إذا كان العمل بحاجة إلى الاستئناف. يتم الاحتفاظ بأدلة الإيصالات الصادرة مسبقًا؛ لا تقوم نقطة النهاية هذه بمسحها أو إعادة كتابتها.

التحقق من النتيجة

يحتوي الرد الناجح على status: "killed". يتضمن agents_changed الوكيل المطلوب؛ ويحسب cascade_count الفروع الملغاة حديثًا. يبلغ sessions_terminated و delegations_revoked عن الجلسات المتأثرة وروابط التفويض. عند نجاح التوقيع المدار، يكون receipt_status هو signed ويحدد receipt_id إيصال إلغاء موقع. استرجعه عبر واجهة برمجة تطبيقات الإيصالات. صلاحية التوقيع وحالة دورة حياة الوكيل الملغى هي فحوصات منفصلة. عندما يكون التوقيع غير متاح، يظل الإلغاء ناجحًا: يكون receipt_status هو unavailable و receipt_id هو null. يظل قرار الإلغاء الدائم مسجلاً. لا يترتب على هذه الاستجابة إيصال موقع أو إعادة محاولة توقيع تلقائية.

سلوك التدقيق

تسجل الخدمة حدث agent.killed وحدث إبطال جنبًا إلى جنب مع تغييرات الحالة. لا تنشئ الاستجابة تثبيت شفافية خارجيًا، أو تسليم webhook، أو تسليم SIEM. تحقق من تلك القنوات بشكل منفصل إذا كانت عملية الحوادث الخاصة بك تعتمد عليها. يعيد وكيل غير معروف في بيئة مساحة العمل المحددة 404. يعيد وكيل تم إلغاؤه بالفعل 409. راجع الحالة الحالية قبل إعادة محاولة طلب طارئ.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

معلمات المسار

agentId
string
مطلوب

معرف الوكيل

الجسم

application/json
reason
string
مطلوب

سبب الحادث غير فارغ، بحد أقصى 2000 بايت UTF-8

Required string length: 1 - 2000

الاستجابة

تم قتل الوكيل

agent_id
string
tenant_id
string<uuid>
status
enum<string>
الخيارات المتاحة:
killed
agents_changed
integer
cascade_count
integer

تم إلغاء الوكلاء الفرعيين حديثًا، باستثناء الوكيل المطلوب.

sessions_terminated
integer
delegations_revoked
integer
reason
string
killed_at
string<date-time>
receipt_id
string | null

معرف إيصال الإلغاء الموقع، أو لا شيء عندما يكون التوقيع غير متاح.

receipt_status
enum<string>

غير متاح لا يلغي الإلغاء الطارئ المكتمل.

الخيارات المتاحة:
signed,
unavailable