ساخت و مدیریت سرور مجازی با API

• ۳ دی ۱۴۰۴
• دسته بندی ها: سرور, عمومی

با پیشرفت فناوری و افزایش نیاز به خودکارسازی مدیریت سرورها، استفاده از API سرور مجازی به یک ابزار حیاتی برای توسعه‌دهندگان، مدیران سیستم و کاربران حرفه‌ای تبدیل شده است. مدیریت سرور مجازی با API به شما اجازه می‌دهد تا بدون ورود به پنل کاربری، سرورهای جدید بسازید، منابع را مدیریت نمائید و وضعیت سرورها را لحظه‌ای بررسی کنید.
در این مطلب، ابتدا با مفهوم API و کاربردهای آن آشنا می‌شویم، سپس می‌بینیم این سرویس برای چه افرادی مناسب است و در نهایت امکانات ساخت و مدیریت سرور مجازی با API را در پارسدِو گام‌به‌گام توضیح می‌دهیم.

API چیست و چه کاربردی دارد؟

API یا رابط برنامه‌نویسی نرم‌افزار (Application Programming Interface)، یک روش استاندارد برای برقراری ارتباط مستقیم و خودکار با سرویس‌ها است، بدون آنکه نیازی به ورود دستی به پنل کاربری داشته باشید. API به شما این امکان را می‌دهد تا بسیاری از عملیات مدیریتی را به‌صورت برنامه‌نویسی‌شده و یکپارچه انجام دهید.

با استفاده از API می‌توان:

• سرور مجازی جدید ایجاد و منابع آن را مدیریت نمایید
• سرورها را -بدون دخالت دستی- تمدید یا ارتقا دهید
• وضعیت سرورها را به‌صورت لحظه‌ای مانیتور کنید
• تنظیمات سیستم‌عامل و شبکه را به شکل خودکار اعمال یا تغییر دهید

این سرویس به‌صورت یک وب‌سرویس تحت استاندارد RESTful ارائه می‌شود و تبادل داده‌ها در آن با فرمت JSON انجام می‌گیرد که استفاده و پردازش آن را برای توسعه‌دهندگان ساده و سریع می‌کند.

ساخت و مدیریت سرور مجازی با API برای  چه افرادی مناسب است؟

ساخت و مدیریت سرور مجازی با API در پارسِدو برای کاربرانی طراحی شده است که به اتوماسیون، کنترل دقیق و مدیریت حرفه‌ای سرورها نیاز دارند.

این سرویس به‌ویژه برای گروه‌های زیر کاربردی و ارزشمند است:

• توسعه‌دهندگان و برنامه‌نویسان
  امکان ایجاد، مدیریت و حذف سرورها به‌صورت مستقیم از داخل برنامه‌ها یا اسکریپت‌ها، بدون نیاز به ورود به پنل کاربری
• مدیران سیستم و شبکه
  قابلیت مانیتورینگ، مدیریت منابع و اعمال تغییرات روی چندین سرور به‌صورت هم‌زمان و متمرکز
• شرکت‌ها و تیم‌های IT
  مناسب برای خودکارسازی فرآیندهای خرید، تمدید و ارتقای منابع سرور در مقیاس سازمانی
• کاربران حرفه‌ای VPS و سرویس‌های ابری
  فراهم‌کردن امکان کنترل پویا، دقیق و پیشرفته سرورها متناسب با نیازهای عملیاتی و ترافیکی

در مجموع، API پارسِدو ابزاری ایده‌آل برای افرادی است که می‌خواهند مدیریت سرورها را از حالت دستی خارج کرده و به سطحی هوشمند، سریع و مقیاس‌پذیر ارتقا دهند.

راهنمای احراز هویت در API

برای استفاده از ساخت و مدیریت سرور مجازی با API، انجام صحیح فرآیند احراز هویت (Authentication) الزامی است. تمامی درخواست‌های API تنها در صورتی پردازش می‌شوند که احراز هویت به‌درستی انجام شده باشد. این سازوکار نقش مهمی در افزایش امنیت سرویس و جلوگیری از دسترسی‌های غیرمجاز ایفا می‌کند.

در این بخش، مراحل و نکات کلیدی احراز هویت API در پارسدِو را به صورت شفاف و کاربردی توضیح خواهیم داد.

احراز هویت API چگونه انجام می‌شود؟

احراز هویت در API پارسدِو بر اساس توکن اختصاصی (API Token) انجام می‌شود. این توکن به هر حساب کاربری تعلق دارد و باید در تمامی درخواست‌های API ارسال شود.

ویژگی‌های احراز هویت:

• مبتنی بر Token
• سازگار با استاندارد RESTful
• تبادل داده‌ها با فرمت JSON
• محدودسازی دسترسی بر اساس IPهای مجاز

دریافت API Token

برای دریافت API Token، مراحل زیر را دنبال کنید:

1. وارد پنل کاربری پارسدِو شوید
2. به تنظیمات کاربری در منو رفته و روی دکمه مدیریت وب سرویس کلیک کنید.
3. با کلیک روی تولید توکن جدید، یک Token جدید ایجاد نمایید
4. توکن صادرشده را در محل امن نگهداری کنید
5. چک‌باکس فعال سازی وب سرویس را هم فعال نمائید.

توجه: API Token حکم رمز عبور شما را دارد و نباید در اختیار اشخاص یا سرویس‌های غیرمجاز قرار گیرد.

ثبت IP مجاز (بسیار مهم)

به‌منظور افزایش امنیت، پارسدِو تنها به درخواست‌هایی پاسخ می‌دهد که از IPهای ثبت‌شده در پنل کاربری ارسال شده باشند.

نکات مهم:

• ثبت IP سرور الزامی است
• درخواست‌های ارسال‌شده از IPهای ثبت‌نشده پردازش نخواهند شد
• در صورت تغییر IP سرور، باید IP جدید را در پنل به‌روزرسانی کنید
• حتی در صورت صحیح بودن Token، اگر IP ثبت نشده باشد، درخواست با خطای احراز هویت مواجه می‌شود

ارسال Token در درخواست‌ها

در تمامی درخواست‌های API، توکن باید به‌درستی ارسال شود. این کار معمولا از طریق Header درخواست انجام می‌شود.

نمونه ساختار کلی درخواست:

• Method:
  متدهای GET و POST
• Header:

• Body:
  معمولا به صورت پارامترهای JSON

 

کدهای پاسخ مرتبط با احراز هویت

در زمان استفاده از API، ممکن است با کدهای وضعیت زیر مواجه شوید:

• 200: احراز هویت موفق و درخواست با موفقیت انجام شده است
• 401: خطای احراز هویت

دلایل رایج خطای 401:

• Token اشتباه یا نامعتبر است
• Token ارسال نشده است
• IP سرور در پنل ثبت نشده یا نادرست است
• شناسه کاربری شما فعال نباشد (باید پنل کاربری شما رد پارسدِو تایید شده و فعال باشد)

در صورت دریافت خطای 401، موارد زیر را بررسی کنید:

• صحت مقدار Token
• ارسال صحیح Token در Header
• ثبت بودن IP سرور در پنل کاربری
• تایید کدملی، شماره تماس و … در پارسدِو

لینک مستندات احراز هویت

برای مشاهده جزئیات فنی، مثال‌ها و توضیحات کامل‌تر، مستندات رسمی احراز هویت API پارسدِو را مطالعه کنید.

در صورت نیاز به راهنمایی بیشتر یا بررسی خطاهای خاص، تیم پشتیبانی پارسدِو در کنار شماست.

خرید و ساخت سرور مجازی از طریق API

API کلود پارسدِو این امکان را فراهم می‌کند که فرآیند خرید، ایجاد و راه‌اندازی سرور مجازی به‌صورت کاملا خودکار و بدون ورود به پنل کاربری انجام شود. این قابلیت برای اتوماسیون، اسکریپت‌نویسی و مدیریت در مقیاس بالا بسیار کاربردی است.

مرحله ۱: آماده‌سازی درخواست ساخت سرور

برای ایجاد یک سرور جدید، باید یک درخواست POST مطابق مستندات رسمی API پارسدِو ارسال شود. در این درخواست، اطلاعات پایه سرور شامل مشخصات فنی و تنظیمات اولیه تعیین می‌گردد.

پارامترهای اصلی درخواست:

• موقعیت سرور (geo)
• مقدار حافظه به گیگابایت (ram)
• تعداد هسته‌های پردازنده (cpu)
• مقدار حافظه ذخیره‌سازی به گیگابایت (disk)
• تعداد بک‌آپ (backup)

نمونه ساختار کلی بدنه درخواست (JSON):

مرحله ۲: ارسال درخواست و دریافت پاسخ

پس از ارسال موفق درخواست، API پاسخی شامل یک پیام موفقیت به همراه شناسه سفارش بر می‌گرداند که در تصویر بالا هم مشاهده می‌شود.

نمونه پاسخ موفق:

تمدید سرور از طریق API

API پارسدِو امکان تمدید خودکار سرورهای فعال را هم فراهم می‌کند. برای این کار، کافی است شناسه سرور و دوره تمدید را ارسال نمایید.

نمونه بدنه درخواست تمدید:

این قابلیت برای شرکت‌ها و تیم‌هایی که تعداد زیادی سرور دارند، نقش مهمی در جلوگیری از انقضای ناخواسته سرویس‌ها ایفا می‌کند.

ارتقای منابع سرور مجازی

در صورت نیاز به منابع بیشتر، می‌توانید از طریق API، ارتقای سخت‌افزاری سرور را بدون توقف طولانی انجام دهید. این ارتقا می‌تواند شامل افزایش RAM، CPU یا فضای ذخیره‌سازی باشد.

نمونه ساختار درخواست ارتقا:

لیست سرورها

این سرویس به شما اجازه می‌دهد لیست تمامی سرورهای خود در پارسدِو را دریافت کنید. این قابلیت امکان مدیریت متمرکز سرورها و بررسی سریع اطلاعات پایه مانند آی‌پی، وضعیت و موقعیت فیزیکی را فراهم می‌کند.

درخواست دریافت لیست سرورها

برای دریافت لیست فیلتر شده هم می‌توانید پارامترهای دلخواه را به URL اضافه کنید.

پارامترهای اختیاری:

• ip – فیلتر بر اساس آی‌پی سرور
• geo – فیلتر بر اساس موقعیت فیزیکی سرور

نمونه پاسخ API

API پاسخ خود را به‌صورت یک آرایه (Array) از سرورها بازمی‌گرداند:

پارامترهای مهم در پاسخ:

• id شناسه منحصر به فرد سرور
• ip – آی‌پی سرور
• geo – موقعیت فیزیکی سرور
• expire date – زمان پایان سرویس

اطلاعات سرور

این سرویس به شما اجازه می‌دهد اطلاعات کامل یک سرور خاص را از پارسدِو دریافت کنید. این داده‌ها شامل مشخصات شبکه، سخت‌افزار، سیستم‌عامل و وضعیت فعلی سرور است و برای مدیریت حرفه‌ای و اتوماسیون سرورها بسیار کاربردی می‌باشد.

درخواست دریافت اطلاعات سرور

پارامترهای مورد نیاز:

• id شناسه منحصر به فرد سرور

توجه: شناسه (id) سرور را می‌توانید از لیست سرورها دریافت کنید.

نمونه پاسخ API

API پاسخ خود را به صورت یک شیء JSON برمی‌گرداند که شامل اطلاعات جامع سرور است:

پارامترهای کلیدی پاسخ:

• id – شناسه سرور
• ip – آی‌پی سرور
• geo – موقعیت سرور
• status – وضعیت سرور
• os – سیستم عامل
• ipv6 – شناسه ipv6
• port – پورت
• user – نام کاربری
• mac – آدرس MAC
• ram – حافظه
• cpu – پردازنده
• disk – فضای ذخیره‌سازی
• backup – بکاپ
• traffic_usage – ترافیک مصرف شده
• rescue_disk – دیسک نجات
• expire_date – تاریخ انقضای سرور

وضعیت سرور

با این سرویس می‌توانید وضعیت سرور خود را مدیریت نموده، سرور را روشن یا خاموش  و در صورت نیاز ریبوت کنید. این قابلیت امکان کنترل سریع و بدون نیاز به ورود به پنل یا SSH را فراهم می‌کند.

درخواست تغییر وضعیت سرور

نمونه بدنه درخواست (Body):

پارامترهای درخواست:

• id – شناسه منحصر به فرد سرور
• action – نوع عملیاتی که می‌خواهید انجام دهید: on برای روشن، off برای خاموش و reboot برای ریبوت

نکته: شناسه سرور (id) را می‌توانید از لیست سرورها یا API دریافت اطلاعات سرور به دست آورید.

نمونه پاسخ API

API یک پیام ساده برای تایید دریافت درخواست بازمی‌گرداند:

پارامترهای پاسخ:

• message – پیام سیستم برای تایید ثبت درخواست

درخواست اتصال VNC به سرور

این سرویس به شما امکان می‌دهد به‌صورت مستقیم و تحت وب به سرور خود متصل شوید و کنترل کنسول سرور را در اختیار بگیرید. با استفاده از VNC، می‌توانید بدون نیاز به SSH یا دسترسی فیزیکی، اقدامات مدیریتی و عیب‌یابی را انجام دهید.

درخواست VNC

نمونه بدنه درخواست (Body):

پارامترهای درخواست:

• id – شناسه منحصر به فرد سرور

نکته: شناسه سرور (id) را می‌توانید از لیست سرورها یا API دریافت اطلاعات سرور به دست آورید.

نمونه پاسخ API

API اطلاعات اتصال VNC را به صورت JSON بازمی‌گرداند:

پارامترهای پاسخ:

• hostname – آدرس میزبان VNC
• port – پورت اتصال
• password – رمز عبور برای اتصال

نحوه اتصال به کنسول VNC

برای اتصال، مقادیر دریافتی (hostname، port و password) را در فرم زیر قرار دهید تا کاربر بتواند به کنسول تحت وب متصل شود:

نکته: در کد بالا examplevnc.parsdev.com، PortNumber و YorPassword را با مقادیری که از پارسدِو دریافت می‌کنید جایگزین نمائید.

تغییر سیستم عامل سرور

با این سرویس می‌توانید سیستم عامل سرور خود را تغییر داده و نسخه‌ای که نیاز پروژه شماست را نصب کنید. این قابلیت به شما امکان می‌دهد بدون نیاز به ورود مستقیم به سرور، محیط نرم‌افزاری را مطابق نیازتان تنظیم کنید.

درخواست تغییر سیستم عامل

نمونه بدنه درخواست (Body):

پارامترهای درخواست:

• id – شناسه سرور
• os – شناسه سیستم عامل مورد نظر

نمونه پاسخ API

پس از ارسال درخواست، API رمز عبور جدید یا اطلاعات دسترسی را بازمی‌گرداند:

پارامترهای پاسخ:

• password – رمز عبور سیستم عامل جدید

برای پروژه‌های مهم خود به دنبال سرور مطمئن هستید؟ خرید سرور مجازی با IP ثابت و سرعت بالا در پارسدو، گزینه‌ای ایده‌آل است.

سایر امکانات مدیریت سرور با API

API سرور مجازی پارسدِو مجموعه‌ای از قابلیت‌های پیشرفته را برای کنترل کامل و حرفه‌ای سرورها فراهم می‌کند. علاوه بر خرید، راه‌اندازی و مدیریت وضعیت، می‌توانید به راحتی موارد زیر را مدیریت کنید:

• تغییر رمز عبور و SSH Key

امکان تغییر رمز عبور دسترسی به سرور و مدیریت کلیدهای SSH بدون نیاز به ورود مستقیم به سرور

• مدیریت اسنپ‌شات‌ها

ایجاد، بازگردانی، حذف و دریافت لیست اسنپ‌شات‌ها برای محافظت از وضعیت فعلی سرور و بازیابی سریع در صورت نیاز

• مدیریت بکاپ‌ها

دریافت لیست بکاپ‌ها، ایجاد نسخه پشتیبان جدید، بازگردانی و حذف بکاپ‌ به سادگی از طریق API

• دیسک نجات (Rescue Disk)

فعال یا غیرفعال کردن دیسک‌های نجات در سرور که این عملیات باعث ریبوت سرور می‌شود.

• گراف منابع سرور

دریافت اطلاعات مصرف منابع سرور شامل CPU، RAM، فضای ذخیره‌سازی و ترافیک، برای مانیتورینگ و تحلیل عملکرد سرور

نکات مهم استفاده

• تمامی عملیات بالا از طریق Endpointهای اختصاصی API قابل انجام است و پاسخ‌ها معمولا به صورت JSON ارائه می‌شوند.
• برای امنیت، ارسال توکن احراز هویت و IP ثبت شده الزامی است.
• بسیاری از عملیات شامل اعمال تغییرات مستقیم روی سرور هستند، بنابراین رعایت دقت در ارسال پارامترها و بررسی پاسخ‌ها اهمیت بالایی دارد.

جمع‌بندی

در نهایت، استفاده از API سرور مجازی پارسدِو به شما امکان می‌دهد کنترل کاملی بر تمام جنبه‌های مدیریت سرور خود داشته باشید، از خرید و راه‌اندازی گرفته تا مانیتورینگ، بکاپ‌گیری، بازیابی و تغییرات سیستم‌عامل یا دسترسی‌ها

با بهره‌گیری از این امکانات، می‌توانید فرآیندهای تکراری و زمان‌بر را خودکار کرده، ریسک خطاها را کاهش داده و مدیریت سرور را به صورت سریع، امن و حرفه‌ای انجام دهید. این رویکرد نه تنها بهره‌وری شما را افزایش می‌دهد، بلکه تجربه کاربری بهتری برای پروژه‌ها و سرویس‌های میزبانی فراهم خواهد کرد.