پرش به مطلب اصلی

آزمایش اتصال بیرونی

POST 
/api/v1/IOService/ExternalFs/Test

به سرور بیرونی وصل می‌شود و ورود را آزمایش می‌کند. اگر کلید میزبان هنوز ثبت نشده باشد، کلیدی را که سرور ارائه کرده برمی‌گرداند تا کاربر آن را تأیید کند.

دسترسی: کاربر واردشده با Authorization و x-container (مقدار container که GET /api/v1/services/current برمی‌گرداند). اتصال‌ها و انتقال‌ها فقط برای همان کاربر دیده می‌شوند.

بدنه‌ی درخواست: connection: یا { "id": "..." } برای اتصال ذخیره‌شده، یا provider و config و secrets برای اتصالی که ذخیره نشده است.

پاسخ: 200 با { ok, hostKey }؛ hostKey.trusted نشان می‌دهد کلید میزبان تأییدشده است یا نه.

خطاها: 502 با AUTH_FAILED یا UNREACHABLE وقتی ورود یا رسیدن به سرور بیرونی ناموفق است؛ 409 با HOST_KEY_UNTRUSTED یا HOST_KEY_MISMATCH (و برای FTPS، CERTIFICATE_UNTRUSTED یا CERTIFICATE_MISMATCH) وقتی کلید میزبان یا گواهی تأیید نشده است؛ 403 با EGRESS_BLOCKED وقتی نشانی مقصد مجاز نیست؛ 429 با RATE_LIMITED بیش از ۳۰ درخواست در دقیقه (قابل تنظیم روی سرور).

نکته: این قابلیت باید روی سرور روشن باشد (در غیر این صورت 404 با کد NOT_FOUND) و برای این کاربر هم فعال شده باشد (در غیر این صورت 403 با کد NOT_ENABLED). خطاها به شکل { error, code, detail } برمی‌گردند. اگر مجوز این گره قابلیت external.connect را اجازه ندهد، پاسخ 402 با کد LICENCE_RESTRICTED است.

درخواست​

پاسخ‌ها​

OK