رموز الخطأ الأساسية لواجهات برمجة التطبيقات gRPC API
قد يتم أحيانًا تطبيق عدة رموز خطأ. يجب أن تعرض الخدمات رمز الخطأ الأكثر تحديدًا الذي ينطبق. على سبيل المثال، يمكنك تفضيل OUT_OF_RANGE
على FAILED_PRECONDITION
إذا تم تطبيق كلا الرمزين. وبالمثل، يتم تفضيل NOT_FOUND
أو ALREADY_EXISTS
على FAILED_PRECONDITION
.
عمليات التعداد | |
---|---|
OK |
حدث خطأ ولم يتم عرض الخطأ. ربط HTTP: 200 حسنًا |
CANCELLED |
تم إلغاء العملية عادةً بواسطة المتصل. ربط HTTP: 499 طلب مغلق من قِبل العميل |
UNKNOWN |
حدث خطأ غير معروف. على سبيل المثال، قد يتم عرض هذا الخطأ عندما تنتمي قيمة تعيين HTTP: خطأ في الخادم الداخلي 500 |
INVALID_ARGUMENT |
حدَّد العميل وسيطة غير صالحة. ملاحظة: تختلف هذه القيمة عن تعيين HTTP: 400 طلب غير صالح |
DEADLINE_EXCEEDED |
انتهت صلاحية الموعد النهائي قبل اكتمال العملية. بالنسبة إلى العمليات التي تغيّر حالة النظام، قد يتم عرض هذا الخطأ حتى في حال اكتمال العملية بنجاح. على سبيل المثال، قد يتأخّر ردّ ناجح من خادم لفترة طويلة بما يكفي لكي تنتهي صلاحية الموعد النهائي. ربط HTTP: انتهاء مهلة مدخل 504 |
NOT_FOUND |
لم يتم العثور على كيان مطلوب (مثل ملف أو دليل). ملاحظة لمطوّري الخوادم: إذا تم رفض طلب لفئة كاملة من المستخدمين، مثل طرح الميزة تدريجيًا أو القائمة المسموح بها غير الموثَّقة، قد يتم استخدام ربط HTTP: 404 لم يتم العثور على الصفحة |
ALREADY_EXISTS |
الكيان الذي حاول العميل إنشاءه (مثل ملف أو دليل) موجود سلفًا. ربط HTTP: 409 تعارض |
PERMISSION_DENIED |
ليس لدى المتصل إذن بتنفيذ العملية المحددة. يجب عدم استخدام ربط HTTP: 403 محظور |
UNAUTHENTICATED |
لا يحتوي الطلب على بيانات اعتماد مصادقة صالحة للعملية. ربط HTTP: 401 غير مصرّح به |
RESOURCE_EXHAUSTED |
تم استنفاد بعض الموارد، أو ربما تم تجاوز الحصة المخصصة لكل مستخدم، أو ربما نفدت مساحة التخزين في نظام الملفات بالكامل. ربط HTTP: 429 عدد كبير جدًا من الطلبات |
FAILED_PRECONDITION |
تم رفض العملية لأن النظام ليس في الحالة المطلوبة لتنفيذ العملية. على سبيل المثال، الدليل الذي سيتم حذفه غير فارغ، يتم تطبيق عملية rmdir على دليل غير الدليل، إلخ. يمكن لمنفذي الخدمات استخدام الإرشادات التالية لاتخاذ قرار بشأن بين تعيين HTTP: 400 طلب غير صالح |
ABORTED |
تم إلغاء العملية في العادة، بسبب مشكلة في التزامن مثل تعذّر التحقّق من التسلسل أو إلغاء العملية. يُرجى الاطّلاع على الإرشادات أعلاه لتحديد ما بين ربط HTTP: 409 تعارض |
OUT_OF_RANGE |
تمت محاولة العملية بعد النطاق الصحيح. على سبيل المثال، تقديم/ترجيع أو قراءة نهاية الملف على عكس هناك بعض التداخل بين تعيين HTTP: 400 طلب غير صالح |
UNIMPLEMENTED |
لم يتم تنفيذ العملية أو كانت غير متاحة أو مفعّلة في هذه الخدمة. ربط HTTP: 501 لم يتم التنفيذ |
INTERNAL |
أخطاء داخلية. ويعني ذلك أنّ بعض الثوابت التي توقّعها النظام الأساسي قد تعطّلت. رمز الخطأ هذا محجوز للأخطاء الخطيرة. تعيين HTTP: خطأ في الخادم الداخلي 500 |
UNAVAILABLE |
هذه الخدمة غير متاحة حاليًا. هذه الحالة على الأرجح عابرة، ويمكن تصحيحها من خلال إعادة المحاولة باستخدام تراجع. يُرجى العِلم أنّه من غير الآمن دائمًا إعادة محاولة إجراء عمليات غير محتمَلة. يُرجى الاطّلاع على الإرشادات أعلاه لتحديد ما بين خريطة HTTP: خدمة 503 غير متوفرة |
DATA_LOSS |
البيانات أو التلف غير القابل للاسترداد تعيين HTTP: خطأ في الخادم الداخلي 500 |