مولَّد من إصدار Techstack v0.39.0 (المصدر
49677b729cb9). بالنسبة إلى إصدار مثبَّت، فإن techstack api <command> --help هو المرجع.techstack api servers detach
إبطال وفصل خادم BYO واحد محدد يشغّله العميل. يحتفظ بإيصال الخادم القياسي النهائي ولا يجري أي استدعاء لـ API المزوّد.techstack api servers get
جلب دورة حياة الخادم القياسي واتصاله وحالته الصحية وقنواته.techstack api servers list
عرض حالة وقت التشغيل القياسية للعقد. يُرجع العقد المحصورة بالمالك مع الهويتين القياسيتينnode_id وkit_deployment_id.
techstack api servers maintenance get
قراءة مهمة صيانة واحدة لخادم مملوك. محصورة مثل POST: استحقاقtechstack.servers.maintenance الموقَّع من Edge، والمستأجر، وملكية الخادم، ومهمة تخص هذا الخادم وطلبها المستدعي. وأي شيء آخر يُرجع 404. لمهام الصيانة دفتر خاص بها ولا تُقدَّم عبر /api/v1/jobs/{id}. لا توجد نقطة نهاية للسجلات: تحمل المهمة نتيجتها، ويحمل الفشل رمزه الثابت مع إرشادات للمستخدم.
techstack api servers maintenance run
ضع خطة تحديث نظام التشغيل أو تحديثه أو إعادة تشغيل خادم مملوك في قائمة الانتظار. يلزم استحقاقtechstack.servers.maintenance الموقّع من Edge، وملكية الخادم داخل المستأجر، والصلاحية الدائمة الحالية المرتبطة بالخادم لاستدعاءات MCP الأصلية المفوّضة. لا تتطلب هذه الإجراءات الاعتيادية الثلاثة تسجيل MFA جديدًا أو إقرار owner_approved مستقلاً. يُفك ترميز الجسم بصرامة: مفاتيح صغيرة مطابقة تمامًا، بلا تكرار أو حقول مجهولة. تُرجع إعادة الطلب باستخدام Idempotency-Key نفسه الإيصال المحفوظ قبل التحقق من الهدف. يمكن أن تنشط لكل خادم مهمة واحدة لإعادة التشغيل أو تحديث النظام، ومهمة مستقلة لخطة تحديث؛ تفشل المهمة التي تتجاوز موعدها بالرمز deadline_exceeded وتحرّر خانتها. لا يُعرض الإجراء في allowed_actions إلا إذا أعلن وكيل الخادم stackkit.host-maintenance.v1، كما تتطلب إعادة التشغيل أن يبلّغ الخادم عن host_boot_id. الرفض مستند client-error-envelope/v1؛ إحدى قيم reason_code في 409 هي control_plane_host أو substrate_node أو protected_demo_server أو service_locked أو maintenance_active أو node_operation_active أو plan_stale أو agent_capability_missing أو boot_id_unknown أو agent_not_connected أو heartbeat_stale أو inventory_revision_stale أو idempotency_key_reused؛ وتحمل 403 القيمة entitlement_required أو maintenance_origin_authority_denied.
techstack api servers network get
اقرأ حقائق شبكة الخادم وأي انتقال مسجّل للشبكة المنزلية. يشمل ذلك الشبكة التي رصدها kombify Guard الخاص بالخادم آخر مرة، بما فيها العنوان والبوابة والشبكة الفرعية والواجهة وشبكة WiFi، وسجلnetwork_move الذي كتبه kombify عند ظهور الخادم على شبكة أخرى، وحالة إعادة الربط اللاحقة. يعيد الخادم المنقول ربط نفسه تلقائيًا؛ وتبيّن can_rebind ما إذا كان المالك يستطيع بدء إعادة ربط الآن.
techstack api servers network rebind
أعِد ربط الخادم المنقول بالشبكة الموجودة عليه الآن. يشغّلstackkit network rebind على الخادم عبر kombify Guard الخاص به: تعيد العقدة اكتشاف عنوان LAN، وتعيد إصدار سجل حفظ LAN DNS الموقّع، وتعيد توليد مساحة العمل وتطبيقها. لا يحمل الطلب جسمًا. يلزم المالك ومنحة operate من Inventory واستحقاق techstack.servers.maintenance وGuard متصل، وإلا تُرجع 409 server_network_not_ready. إذا كانت إعادة الربط في الانتظار أو قيد التشغيل، يُرجع طلبها القائم بدلًا من إدراج طلب آخر.
techstack api servers ports
جلب جرد المنافذ للمالك المصادَق عليه لخادم قياسي واحد. إسقاط واجهة تفاصيل الخادم فوق سلطة المنافذ المركزية نفسها التي يستخدمها سطح Inventory/MCP، مع تفويض عبر حد القراءة القياسي للخوادم المحصور بالمالك.techstack api servers reach set
انشر الخادم على عنوان kombify.me أو أوقف نشره. لا يُنشر شيء افتراضيًا: لا يملك الخادم المقترن مسارًا عامًا، ولا ينقل المرحّل حركة مرور. يفعّله المالك لكل خادم باسمservice صريح وtarget_port، ويمكنه سحبه في أي وقت؛ ويكون المصدر دائمًا عنوان loopback لمضيف Guard، لا جهازًا آخر. يصادق المرحّل على Guard لا على الزائر، لذا يجب أن تحمي الخدمة التي تجيب على ذلك المنفذ نفسها. يتطلب التفعيل المالك واستحقاق techstack.servers.maintenance وتسجيل دخول حديثًا متعدد العوامل، بسبب server_reach_step_up_required؛ أما السحب فلا يخضع لهذا الشرط. تتضمن الاستجابة قسم reach من نموذج قراءة الخادم؛ ثم ينشئ المُوفّق المسار أو يسحبه.
techstack api servers security auto-repair get
اقرأ موافقة المالك على الإصلاح الأمني التلقائي. الخادم الذي لا يملك موافقة، أو انتهت موافقته، يظل للمراقبة فقط.techstack api servers security auto-repair set
وافق على الإصلاح التلقائي لمجموعة صغيرة آمنة من الضوابط أو اسحب الموافقة. معطّل افتراضيًا. تسمّي الموافقة ضوابط من المجموعة الآمنة،allowed_controls: الحماية من التخمين المتكرر وسياسة الجدار الناري ومعلمات النواة والتحديثات الأمنية التلقائية، دون ضوابط ssh مطلقًا. تنتهي خلال 90 يومًا ولا تجدّد نفسها. أثناء سريانها يصلح مستوى التحكم الضابط المسمّى الذي تُظهر أدلة حديثة انحرافه، ضمن حدود الإصلاح الذي يطلبه المشغّل. يلزم المالك واستحقاق techstack.servers.maintenance وتسجيل دخول حديث متعدد العوامل. تسحب enabled: false الموافقة.
techstack api servers security findings
اعرض النتائج المفتوحة وسجل النتائج الحديث لخادم واحد. هذا سجل النتائج وراءsecurity وrecovery وتنبيهات Guard الخاصة بالخادم. تمثل كل نتيجة حادثة واحدة: تُفتح عند أول رصد لحقيقة غير صحيحة وتُحل عند رصدها صحيحة مجددًا، مع تنبيه واحد كحد أقصى، alerted_at، وحل واحد. يُحتفَظ بالسجل 90 يومًا.
techstack api servers security repairs list
اعرض الإصلاحات الأمنية الحديثة لخادم واحد.techstack api servers security repairs request
أصلح ضوابط أمن المضيف المسمّاة والمنحرفة. يطلب إصلاحًا محدودًا لضوابط تُظهر أدلة أمن مضيف حديثة أنها منحرفة وقابلة للإصلاح التلقائي. يلزم مالك الخادم واستحقاقtechstack.servers.maintenance الموقّع من Edge وتسجيل دخول حديث متعدد العوامل، لا يتجاوز عمره 300 ثانية. يصل الإصلاح كأمر Guard ذي نوع محدد ومسجّل، يشغّل stackkit host security repair --apply للضوابط المسمّاة وحدها؛ ويرفض StackKits، قبل أي تغيير، تغييرًا يقطع مسار الإدارة أو يمنع المالك من الدخول. الحدود: إصلاح واحد لكل خادم في المرة، 409 repair_in_progress؛ وفترة تهدئة لكل ضابط، 429 repair_cooldown؛ وميزانية محاولات يومية لكل ضابط، 429 repair_attempts_exhausted؛ وقاطع بعد إخفاقات متتالية، 429 repair_circuit_open. تحمل استجابات 429 قيمة retry_after. يُرفض الضابط المتوافق، 409 control_not_drifted، أو المشمول باستثناء معتمد، control_has_exception، أو اليدوي، control_not_repairable، أو المنتظر لمفتاح SSH معتمد، needs_authorized_key، أو غير المرصود. يُفك ترميز الجسم بصرامة.
techstack api servers security verify
اطلب من kombify Guard رصدًا حديثًا لأمن المضيف. يسجّل طلب رصد حديث لخط أساس المضيف. يجيب Guard في اتصاله الدوري التالي، خلال نحو دقيقة، بتقرير جديد؛ ولا يتغير شيء على المضيف. يُحدَّث نموذج قراءةsecurity للخادم بهذا التقرير فقط، لا بهذا الطلب مطلقًا. يُرجع خادم مستأجر أو مالك آخر 404، والخادم الذي بلا Guard يعيد 409 guard_not_connected.