نمایک، نیاز اول کسب و کارها
پرش به محتوای اصلی

مستندات

عیب‌یابی و کدهای خطا

معنای هر کد خطای کار، API و لبه، و راه رفع آن.

در این صفحه

خطای کارها

کد خطای هر کار در پنل، رویداد backup.failed و API همین‌هاست؛ متن فارسی همان است که در پنل می‌بینید.

کدهای خطای کار
کدنوع / مقدارتوضیح
USAGEتنظیمات این کار معتبر نیستاگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
TOOL_NOT_FOUNDابزار پشتیبان گیری این پایگاه داده روی سرور عامل نصب نیستابزار موتور را روی سرور عامل نصب کنید؛ namayek-agent doctor فهرست را نشان می‌دهد.
CONNECTION_FAILEDاتصال به پایگاه داده برقرار نشدنشانی، درگاه و دیواره آتش را بررسی کنید؛ namayek-agent source test.
AUTH_FAILEDنام کاربری یا رمز پایگاه داده پذیرفته نشدنام کاربری و رمز متغیر محیطی منبع را بررسی کنید.
PERMISSION_DENIEDکاربر پایگاه داده دسترسی لازم را ندارددسترسی‌های لازم کاربر پشتیبان را طبق صفحه موتور بدهید.
VERSION_MISMATCHنسخه ابزار با نسخه پایگاه داده سازگار نیستابزار سمت عامل را هم‌نسخه یا تازه‌تر از سرور پایگاه داده کنید.
NOT_FOUNDپایگاه داده یا فایل خواسته شده پیدا نشداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
TARGET_EXISTSمقصد بازگردانی از قبل وجود دارد؛ نام دیگری انتخاب کنیدنام مقصد دیگری انتخاب کنید؛ بازگردانی پیش‌فرض چیزی را بازنویسی نمی‌کند.
TOOL_FAILEDابزار پشتیبان گیری با خطا متوقف شداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
UNSUPPORTEDاین کار برای این پایگاه داده پشتیبانی نمی شوداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
INTEGRITYدرستی نسخه تایید نشدنسخه یا کلید نادرست است؛ نسخه دیگری را امتحان کنید و با پشتیبانی تماس بگیرید.
TIMEOUTکار از زمان مجاز طولانی تر شدمهلت منبع را در تنظیمات بیشتر کنید یا حجم را کم کنید.
IOخطای خواندن یا نوشتن روی دیسک یا شبکه رخ داداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
CANCELLEDکار لغو شداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
INTERNALخطای داخلی رخ داداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
POLICY_REFUSEDتنظیمات عامل اجازه این کار را نمی دهدسیاست restore/encryption فایل پیکربندی عامل را بررسی کنید.
NOT_STARTEDعامل در زمان مقرر در دسترس نبودعامل در زمان اجرا آنلاین نبود؛ سرویس عامل را بررسی کنید.
LEASE_LOSTارتباط عامل در میانه کار قطع شداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
AGENT_REVOKEDعامل این کار باطل شده استاگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
STORAGE_FAILEDذخیره نسخه در فضای ذخیره سازی انجام نشداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
UPLOAD_EXPIREDزمان بارگذاری نسخه به پایان رسیداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
SNAPSHOT_TOO_LARGEحجم نسخه از سقف مجاز بیشتر استحجم از سقف بیشتر است؛ با پشتیبانی تماس بگیرید.
VALIDATION_FAILEDبررسی نسخه دریافتی رد شداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
SSRF_BLOCKEDنشانی پایگاه داده به شبکه داخلی اشاره می کندنشانی عمومی پایگاه داده را بدهید یا از عامل استفاده کنید.
SSH_HOST_KEY_CHANGEDکلید سرور SSH تغییر کرده است؛ اثر انگشت را دوباره بررسی و تایید کنیداگر کلید سرور را عمدا عوض کرده‌اید، اثر انگشت تازه را تایید کنید؛ وگرنه موضوع را امنیتی بررسی کنید.
SSH_AUTH_FAILEDورود به سرور SSH پذیرفته نشداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
TLS_FAILEDاتصال امن TLS برقرار یا تایید نشدگواهی سرور، نام میزبان و CA را بررسی کنید.
KEY_SERVICE_FAILEDسرویس کلید در دسترس نبوداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
SSH_HOST_KEY_UNCONFIRMEDاثر انگشت کلید سرور SSH را تایید کنیداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.
PRE_BACKUP_FAILEDپشتیبان گیری پیش از بازگردانی انجام نشد؛ چیزی بازگردانی نشداگر تکرار شد، شناسه کار را برای پشتیبانی بفرستید.

خطای API

کدهای خطای API پشتیبان‌گیری
کدHTTPمعنی و اقدام
BACKUP_SOURCE_NOT_FOUND404منبع پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_SNAPSHOT_NOT_FOUND404نسخه پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_JOB_NOT_FOUND404کار پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_RESTORE_NOT_FOUND404بازگردانی پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_AGENT_NOT_FOUND404عامل پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_KEY_NOT_FOUND404کلید پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_WIDGET_NOT_FOUND404ویجت پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_TOKEN_NOT_FOUND404توکن پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_TARGET_NOT_FOUND404فضای ذخیره سازی پیدا نشدشناسه را بررسی کنید؛ منبعی که مال پروژه کلید نیست هم ۴۰۴ برمی‌گرداند.
BACKUP_SOURCE_LIMIT409به سقف تعداد منابع این پروژه رسیده اید (N)وضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_AGENT_LIMIT409به سقف تعداد عامل های این پروژه رسیده اید (N)وضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_WIDGET_LIMIT409به سقف تعداد ویجت های این پروژه رسیده اید (N)وضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_KEY_LIMIT409به سقف تعداد کلیدهای این پروژه رسیده اید (N)وضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_ENGINE_MODE_UNSUPPORTED400این نوع پایگاه داده در حالت اتصال مستقیم پشتیبانی نمی شود؛ از عامل استفاده کنیدبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_DIRECT_DISABLED409اتصال مستقیم فعلا غیرفعال استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_INTERVAL_TOO_SHORT400فاصله اجرا باید دست کم N دقیقه باشدفاصله را دست‌کم برابر کمترین مقدار مجاز (فیلد min در پاسخ) بگذارید.
BACKUP_CRON_INVALID400عبارت زمان بندی معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_WINDOW_INVALID400بازه زمانی مجاز معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_RETENTION_INVALID400سیاست نگهداری معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_RETENTION_PENDING409یک تغییر سیاست در انتظار اعمال است؛ اول آن را لغو کنیدتغییر در انتظار را در پنل لغو کنید و دوباره بفرستید.
BACKUP_ENCRYPTION_INVALID400برای این حالت رمزنگاری دست کم یک کلید مشتری لازم استبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_RECIPIENT_INVALID400کلید عمومی معتبر نیست (باید با nmkpk1 شروع شود)بدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_RECIPIENT_EXISTS409این کلید قبلا ثبت شده استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_RECIPIENT_IN_USE409این کلید در منابع دیگری استفاده می شودوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_ALREADY_RUNNING409یک اجرا برای این منبع در جریان استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SOURCE_PAUSED409منبع متوقف استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SOURCE_DISABLED409منبع توسط پشتیبانی غیرفعال شده استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SOURCE_DELETING409منبع در حال حذف استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_AGENT_REQUIRED409برای این منبع هنوز عاملی وصل نشده استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_AGENT_OFFLINE409عامل این منبع از … قطع استسرویس عامل را روی سرور خود بررسی کنید (namayek-agent status).
BACKUP_AGENT_INCAPABLE409عامل این کار را پشتیبانی نمی کندوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_AGENT_REVOKED409این عامل باطل شده استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SLUG_TAKEN409این نام کوتاه برای منبع دیگری از این پروژه استفاده شده استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_RANGE_INVALID400نقطه ادامه دانلود معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_TARGET_INVALID400تنظیمات فضای ذخیره سازی معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_WIDGET_DISABLED403ویجت وضعیت پشتیبان فعلا غیرفعال استاین کار برای کلید یا پروژه مجاز نیست؛ تنظیمات «دسترسی API» یا دامنه کلید را بررسی کنید.
BACKUP_JOB_NOT_RETRYABLE409فقط کار پشتیبان گیری ناموفق یا جامانده قابل تکرار استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SNAPSHOT_NOT_AVAILABLE409این نسخه در دسترس نیستوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SNAPSHOT_LOCKED409این نسخه تا … قفل تغییرناپذیر داردوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SNAPSHOT_ON_HOLD409این نسخه توقیف قانونی داردوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SNAPSHOT_PINNED409این نسخه سنجاق شده است؛ اول سنجاق را برداریدوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_SNAPSHOT_QUARANTINED409این نسخه به دلیل خطای سلامت داده قرنطینه است و تا بررسی پشتیبانی برای بازگردانی و دانلود در دسترس نیست؛ از نسخه دیگری استفاده کنیدوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_QUARANTINE_UNVERIFIED409بررسی دوباره این نسخه هنوز موفق نشده است؛ اول بررسی دوباره را اجرا کنید یا آزادسازی اجباری را انتخاب کنیدوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_NOT_SERVER_DECRYPTABLE409این نسخه فقط با کلید شما باز می شود؛ نسخه رمزنگاری شده را دانلود کنیدنسخه رمزنگاری‌شده را دانلود و با کلید خود باز کنید.
BACKUP_RESTORE_TARGET_INVALID400نام مقصد معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_CONFIRM_MISMATCH400عبارت تایید درست وارد نشده استبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_DIRECT_HOST_INVALID400نشانی معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_DIRECT_HOST_BLOCKED400این نشانی به شبکه داخلی اشاره می کندنشانی عمومی پایگاه داده را بدهید یا از عامل نمایک استفاده کنید.
BACKUP_DIRECT_PORT_NOT_ALLOWED400این درگاه مجاز نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_DIRECT_TLS_REQUIRED400اتصال باید رمزنگاری شده (TLS یا SSH) باشدبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_SSH_HOST_KEY_UNCONFIRMED409اثر انگشت کلید سرور SSH را تایید کنیداثر انگشت را با خروجی ssh-keygen -lf روی سرور مقایسه و در پنل تایید کنید.
BACKUP_CONNECTION_UNTESTED409اول اتصال را آزمایش کنیدوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_DOWNLOAD_DISABLED409دانلود غیرفعال استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_DOWNLOAD_LIMIT429دانلودهای همزمان زیاد استکمی بعد دوباره تلاش کنید؛ سرآیند Retry-After را رعایت کنید.
BACKUP_API_ACTION_DISABLED403این کار از طریق API برای این پروژه غیرفعال استاین کار فقط از پنل انجام می‌شود یا باید در «سیاست‌ها › دسترسی API» روشن شود.
BACKUP_STORAGE_UNAVAILABLE503فضای ذخیره سازی موقتا در دسترس نیستموقت است؛ با فاصله فزاینده دوباره تلاش کنید.
BACKUP_WIDGET_ORIGIN_INVALID400دامنه شماره N معتبر نیستبدنه یا پارامتر را مطابق جدول‌های همین مستندات اصلاح کنید.
BACKUP_TARGET_TEST_REQUIRED409برای فعال سازی، آزمایش موفق هر دو نقش لازم استوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_TARGET_IN_USE409این فضای ذخیره سازی نسخه فعال دارد و محل آن تغییر نمی کند؛ برای انتقال، فضای تازه بسازیدوضعیت فعلی اجازه این کار را نمی‌دهد؛ متن خطا مانع را می‌گوید.
BACKUP_DEPENDENCY_UNAVAILABLE503سرویس موقتا در دسترس نیست؛ کمی بعد دوباره تلاش کنیدموقت است؛ با فاصله فزاینده دوباره تلاش کنید.

خطاهای ارتباط عامل

این‌ها پاسخ لبه به عامل‌اند و در گزارش عامل (journalctl -u namayek-agent) دیده می‌شوند؛ عامل خطاهای ۵xx و ۴۲۹ را خودش با فاصله فزاینده دوباره تلاش می‌کند.

کدهای ارتباط عامل
کدHTTPمعنی و اقدام
AGENT_SIGNATURE_INVALID401AGENT_SIGNATURE_INVALIDامضای درخواست عامل نامعتبر است (کلید عامل عوض شده یا فایل وضعیت آسیب دیده).
AGENT_UNKNOWN401AGENT_UNKNOWNاین عامل ثبت نشده است؛ دوباره enroll کنید.
AGENT_REVOKED401AGENT_REVOKEDعامل در پنل ابطال شده است.
CLOCK_SKEW401CLOCK_SKEWساعت سرور عامل بیش از ۵ دقیقه اختلاف دارد؛ NTP را روشن کنید.
REPLAYED_REQUEST401REPLAYED_REQUESTدرخواست تکراری رد شد.
ENROLLMENT_TOKEN_INVALID401ENROLLMENT_TOKEN_INVALIDتوکن ثبت نامعتبر، مصرف‌شده یا منقضی است؛ توکن تازه بسازید.
SOURCE_NOT_ASSIGNED403SOURCE_NOT_ASSIGNEDاین منبع به این عامل واگذار نشده است.
PROJECT_DISABLED403PROJECT_DISABLEDپروژه غیرفعال است.
LEASE_INVALID409LEASE_INVALIDاجاره کار از دست رفته؛ عامل کار را رها می‌کند.
SNAPSHOT_TOO_LARGE413SNAPSHOT_TOO_LARGEحجم نسخه از سقف تنظیمات بیشتر است.
DIGEST_MISMATCH422DIGEST_MISMATCHهش محتوای بارگذاری‌شده با اعلام عامل یکی نیست؛ نسخه پذیرفته نمی‌شود.
STATEMENT_INVALID422STATEMENT_INVALIDامضای نسخه نامعتبر است.
AGENT_TOO_OLD426AGENT_TOO_OLDنسخه عامل کمتر از حداقل مجاز است؛ عامل را به‌روز کنید.
RATE_LIMITED429RATE_LIMITEDعامل با فاصله فزاینده دوباره تلاش می‌کند.
STORAGE_UNAVAILABLE503STORAGE_UNAVAILABLEموقت؛ عامل دوباره تلاش می‌کند.

کد خروج خط فرمان

کدهای خروج namayek-agent
کدنوع / مقدارتوضیح
0okموفق
1INTERNALخطای داخلی
2USAGEدستور یا گزینه نادرست
3TOOL_NOT_FOUNDابزار موتور نصب نیست
4CONNECTION_FAILED / AUTH_FAILEDاتصال یا احراز هویت پایگاه داده
5TOOL_FAILED / TARGET_EXISTS / PERMISSION_DENIED / VERSION_MISMATCH / POLICY_REFUSEDخطای ابزار، مقصد موجود، دسترسی، نسخه یا سیاست محلی
6INTEGRITYدستکاری، کلید نادرست یا فایل ناقص
7TIMEOUTپایان مهلت
8IOخطای دیسک یا شبکه
130CANCELLEDلغو شد

آخرین به‌روزرسانی: