REST API اور curl سے VPS کا انتظام: حالت، پاور، دوبارہ انسٹال، تجدید

API کے ذریعے سرور آرڈر کرنا ایک درخواست کا کام ہے۔ یہ 4 API کالز میں VPS آرڈر کریں میں بیان ہے۔ یہ صفحہ اس کے بعد کی ہر چیز کے بارے میں ہے: وہ روزمرہ کارروائیاں جو آپ ورنہ ڈیش بورڈ میں کلک کر کے کرتے، اسکرپٹ میں پیسٹ کرنے کے قابل curl کمانڈز کی صورت میں۔

نیچے کی ہر کمانڈ ہم نے شائع کرنے سے پہلے اپنی API پر چلائی، اور جوابات واپس آنے والے نتیجے کی مختصر کاپیاں ہیں۔

تیاری

دو variables کمانڈز کو مختصر رکھتے ہیں:

export API=https://api.eqvps.com/api/v1/eqvps
export EQVPS_TOKEN='paste-your-token-here'

ٹوکن POST /auth/register سے یا ڈیش بورڈ میں Settings → API tokens سے آتا ہے۔ اگر مشین دوسرے لوگ بھی استعمال کرتے ہیں تو اسے shell ہسٹری سے باہر رکھیں؛ export EQVPS_TOKEN=$(cat ~/.eqvps_token) سے فائل سے پڑھنا کافی ہے۔

اپنے سرور تلاش کریں

curl -s $API/services -H "Authorization: Bearer $EQVPS_TOKEN"

ہر اندراج کا 47HZ7YF جیسا ایک id ہوتا ہے۔ یہی سروس کوڈ ہے جو باقی تمام کالز لیتی ہیں۔ پھر ایک سرور کی مکمل تصویر:

curl -s $API/services/47HZ7YF -H "Authorization: Bearer $EQVPS_TOKEN"

{ "data": {
    "id": "47HZ7YF", "status": "active", "queued": false,
    "product": { "slug": "nano", "name": "Nano" },
    "specs": { "vcpu": 2, "memory_mb": 1024, "disk_gb": 15 },
    "hostname": "agent-box",
    "vm": { "state": "running", "uptime": 5340 },
    "access": { "method": "ssh", "host": "203.0.113.10", "port": 21521, "user": "root", "nat": true, ... } } }

access بتاتا ہے کہ لاگ اِن کیسے کریں۔ اپنے IPv4 والے پلان پر پورٹ 22 ہے؛ NAT پلان پر یہ آپ کا ذاتی فارورڈ کیا گیا پورٹ ہے۔ یہ کال صرف پڑھتی ہے، اس لیے لوپ میں بار بار پوچھنا محفوظ ہے۔

اگر آپ نے SSH key کے بغیر آرڈر کیا تو root پاس ورڈ ایک بار دکھایا جاتا ہے:

curl -s "$API/services/47HZ7YF?reveal=1" -H "Authorization: Bearer $EQVPS_TOKEN"

جب تک سرور بوٹ ہو رہا ہے، جواب password_pending کہتا ہے اور ایک بار کا ڈسپلے خرچ نہیں ہوتا۔ آدھا منٹ انتظار کر کے دوبارہ پوچھیں۔

پاور: start، stop، reboot

curl -s -X POST $API/services/47HZ7YF/power \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"action": "reboot"}'

action کی قدر start، stop یا reboot ہے۔ جو سرور ابھی فعال نہیں (ابھی بن رہا ہے، یا عدم ادائیگی پر معطل ہے) وہ 409 Service is not active جواب دیتا ہے۔ یہ آپ کے اسکرپٹ کی غلطی نہیں۔ پہلے status دیکھیں۔

میٹرکس

curl -s "$API/services/47HZ7YF/metrics?timeframe=day" -H "Authorization: Bearer $EQVPS_TOKEN"

CPU، میموری، نیٹ ورک اور ڈسک ٹائم سیریز کے طور پر۔ timeframe کی قدر hour (ڈیفالٹ)، day، week یا month ہے۔ ایسے cron جاب کے لیے مفید جو ڈسک مسلسل بڑھنے پر آپ کو اطلاع دے۔ موجودہ بلنگ مدت کے ٹریفک کاؤنٹر رفتار اور ٹریفک چیک کریں میں ہیں۔

سرور کا نام بدلیں

curl -s -X POST $API/services/47HZ7YF/hostname \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"hostname": "web-01"}'

نیا نام guest agent چلتے ہوئے سسٹم کے اندر لاگو کرتا ہے، Linux پر ری بوٹ کی ضرورت نہیں۔ اگر سرور بند ہے، یا آپ نے qemu-guest-agent ہٹا دیا ہے، تو کال 409 agent_unavailable واپس کرتی ہے اور کچھ نہیں بدلتا۔

OS دوبارہ انسٹال کریں

یہ ڈسک مٹا دیتا ہے۔ API آپ سے confirm میں سرور کا موجودہ hostname لکھواتی ہے، تاکہ غلط سروس id والا اسکرپٹ غلط مشین نہ مٹا سکے:

curl -s -X POST $API/services/47HZ7YF/reinstall \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"os_id": 4, "confirm": "web-01"}'

os_id، GET /products میں آپ کے پلان کی available_os فہرست سے یا سرور کی اپنی تفصیلات سے آتا ہے۔ دوبارہ انسٹال پس منظر میں چلتا ہے؛ status دوبارہ active ہونے تک GET /services/{id} پوچھتے رہیں۔

تجدید اور بیلنس

سرور ہر ماہ آپ کے پری پیڈ بیلنس سے تجدید ہوتے ہیں۔ اس سرور کے لیے لمبی مدت کی قیمت دیکھنے کے لیے:

curl -s $API/services/47HZ7YF/renew-options -H "Authorization: Bearer $EQVPS_TOKEN"

پیشگی ادائیگی کے لیے، مثلاً تین ماہ، ایک کال میں:

curl -s -X POST $API/services/47HZ7YF/renew \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"months": 3}'

months کی قدر 1، 3، 6 یا 12 ہے، اور 12 سالانہ قیمت پر رعایت کے ساتھ لگتا ہے۔ جواب paid_from_balance: true کہتا ہے اور نئی میعاد کی تاریخ دیتا ہے۔ اگر بیلنس رقم پوری نہیں کرتا تو کچھ نہیں کٹتا: آپ کو paid_from_balance: false اور اس انوائس کا checkout_url ملتا ہے۔ بیلنس ٹاپ اپ ہونے کے بعد POST $API/invoices/{invoice_id}/pay وہ انوائس بیلنس سے ادا کرتا ہے؛ اگر اب بھی کم ہو تو ویسا ہی checkout_url واپس کرتا ہے اور کچھ نہیں کاٹتا۔ بیلنس دیکھنا اور ٹاپ اپ کرنا:

curl -s $API/balance -H "Authorization: Bearer $EQVPS_TOKEN"

curl -s -X POST $API/balance/topup \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"amount": 25}'

ٹاپ اپ کے جواب میں checkout_url ہوتا ہے۔ یہ کرپٹو چیک آؤٹ ہے: Base، Ethereum یا Polygon پر USDT، USDC یا ETH۔ ادائیگی on-chain تصدیق ہوتے ہی بیلنس میں شامل ہو جاتی ہے۔ ادائیگی وہ واحد قدم ہے جو اسکرپٹ آپ کے لیے نہیں کر سکتا، جب تک اس کے پاس والیٹ نہ ہو۔

Monero بھی چلتا ہے، مگر صرف ہاتھ سے جانچے گئے بیلنس ٹاپ اپ کے طور پر: آپ XMR بھیجتے ہیں، ٹرانزیکشن id دیتے ہیں، اور ہم تصدیق کے بعد شامل کرتے ہیں۔ دیکھیں Monero سے ادائیگی۔

منسوخ کریں، اور ارادہ بدلیں

محفوظ منسوخی سرور کو ادا شدہ مدت کے اختتام تک چلنے دیتی ہے اور بس اس کی تجدید نہیں کرتی:

curl -s -X POST $API/services/47HZ7YF/cancel \
  -H "Authorization: Bearer $EQVPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"type": "end_of_period", "reason": "moving the project elsewhere"}'

reason لازمی ہے۔ چند الفاظ کافی ہیں۔ تاریخ سے پہلے ارادہ بدل گیا؟

curl -s -X POST $API/services/47HZ7YF/cancel/undo -H "Authorization: Bearer $EQVPS_TOKEN"

"type": "immediate" بھی ہے۔ یہ سرور اور اس کا ڈیٹا فوراً مٹا دیتا ہے، "confirm": "<hostname>" مانگتا ہے اور واپس نہیں لیا جا سکتا۔ جب تک آپ واقعی یہی نہ چاہیں، end_of_period استعمال کریں۔

ٹوکن کو زندہ رکھیں

نئے ٹوکن ڈیفالٹ طور پر ایک سال چلتے ہیں۔ ہر تصدیق شدہ جواب میں X-Token-Expires-At ہیڈر ہوتا ہے، تاکہ اسکرپٹ پہلے سے نوٹ کر سکے۔ ٹوکن کو نئے سے بدلیں:

curl -s -X POST $API/auth/token/refresh -H "Authorization: Bearer $EQVPS_TOKEN"

پرانا ٹوکن فوراً کام کرنا بند کر دیتا ہے، اس لیے کچھ اور کرنے سے پہلے نیا محفوظ کر لیں۔

سنبھالنے کے قابل غلطیاں

یہ اسکرپٹ کے بجائے AI کلائنٹ سے کر رہے ہیں؟ وہی کارروائیاں MCP ٹولز کے طور پر بھی ہیں — دیکھیں AI ایجنٹ MCP کے ذریعے اپنا VPS خود کیسے سنبھالتا ہے اور API حوالہ۔ ابھی سرور نہیں؟ پلان منتخب کریں۔