شبكة عُقدة

يوفر مقبس الإدارة واجهة للاستعلام عن عُقدة وتكوينها أثناء التشغيل. افتراضياً، تستمع عُقدة لاتصالات الإدارة على localhost:9001.

توفر أداة uqdactl واجهة سطر أوامر سهلة الاستخدام لمقبس إدارة عُقدة. يمكنها الاتصال بكل من مثيلات عُقدة المحلية والبعيدة.

الأمثلة تشمل:

للحصول على قائمة بالأوامر المدعومة:

لتنفيذ إجراء على عقدة عُقدة بعيدة، حدد معامل -endpoint:

للحصول على نص استجابة JSON بدلاً من إخراج "ودود"، حدد معامل -json:

يستخدم مقبس إدارة عُقدة JSON لتنسيقات الطلب والاستجابة.

يجب أن يكون الطلب:

• مقطع JSON كامل
• متبوعاً بحرف سطر جديد \n

بمجرد استلام طلب صالح، يتم إرجاع مقطع الاستجابة.

هيكل الطلب النموذجي كما يلي:

الطلب:

• يجب أن يحتوي على حقل "request" (string) - قيمة تحتوي على فعل الطلب
• يمكن أن يحتوي على حقل "keepalive" (bool) - قيمة true أو false تشير إلى ما إذا كان يجب الحفاظ على الاتصال لطلبات إضافية
• يجب أن يحتوي على أي حقول مطلوبة أخرى للطلب

الاستجابة النموذجية منظمة على النحو التالي:

الاستجابة:

• دائماً تحتوي على حقل "request"، الذي يحتوي على نص الطلب الأصلي
• دائماً تحتوي على حقل "status"، الذي يكون إما "success" أو "error"
• اختيارياً تحتوي على قسم "response"، الذي يحتوي على بيانات الاستجابة من الطلب
• اختيارياً تحتوي على حقل "error"، الذي يحتوي على نص الخطأ