وثائق Guardrail Ledger

استكشاف الأخطاء وإصلاحها

ابدأ بسجل مسار البناء. تذكر الخطوة اسم الماسح أو الخطأ.

العَرَضالسبب والحل
تفشل الخطوة مع ذكر اسم ماسحالماسح مفقود من PATH أو انهار أو انتهى بخطأ أو لم يكتب SARIF صالحًا للاستخدام. ثبّته على الوكيل وأعد التشغيل.
يردّ الإدخال بالحالة 401رمز الإدخال مفقود أو خاطئ أو ملغى. أنشئ رمزًا جديدًا في صفحة المسار.
يردّ الإدخال بالحالة 415أرسل Content-Type: application/json.
يردّ الإدخال بالحالة 400 مع empty_sarif أو invalid_sarifلا يحتوي الجسم على SARIF، أو يحتوي على مستندات لا تذكر اسم أداتها. تحقق من خرج الماسح.
يردّ الإدخال بالحالة 409حظرت البوابة التشغيل. افتح النتائج، وأصلح النتائج التي بمستوى العتبة لديك أو أعلى منه أو استثنِها.
لا يوجد تعليق على طلب السحبAzure DevOps: أضف سطر البيئة SYSTEM_ACCESSTOKEN، وامنح خدمة البناء إذن المساهمة في طلبات السحب (Contribute to pull requests)، وشغّل المسار على طلبات السحب. GitHub: امنح المهمة pull-requests: write، وشغّلها على الفروع (branches) وليس على النسخ المتفرعة (forks).
يُرفض تغيير مع insufficient_roleلا يمكن إلا لمالكي مساحة العمل ومسؤوليها تغيير البوابة والرموز ومشاركة Azure DevOps والاستثناءات.
لا يوجد رابط Marketplace في صفحة المسارتتم مشاركة الامتداد يدويًا بعد أن تحفظ مؤسستك. إلى ذلك الحين، استخدم مثال أول فحص أو إجراء GitHub.
لا شيء ضمن النتائجأرسل مثال أول فحص من صفحة المسار، ثم تحقق من مرشّح الحالة في النتائج.

لأي أمر آخر راسل hello@spot-suite.com وأرفق عنوان مساحة العمل وسجل مسار البناء.