VPSን በREST API እና curl ማስተዳደር፦ ሁኔታ፣ ኃይል፣ እንደገና መጫን፣ ማደስ

በAPI አገልጋይ ማዘዝ አንድ ጥያቄ ብቻ ነው። ይህ በበ4 የAPI ጥሪዎች VPS ማዘዝ ውስጥ ተሸፍኗል። ይህ ገጽ ከዚያ በኋላ ስላለው ሁሉ ነው፦ በሌላ መንገድ በዳሽቦርዱ ጠቅ በማድረግ የሚያከናውኗቸው የዕለት ተዕለት ተግባራት፣ በስክሪፕት ውስጥ ሊለጠፉ የሚችሉ የcurl ትዕዛዞች ሆነው ተጽፈዋል።

ከታች ያለው እያንዳንዱ ትዕዛዝ ከመታተሙ በፊት በAPIያችን ላይ ተሞክሯል፣ ምላሾቹም የተመለሰው ውጤት አጭር ቅጂዎች ናቸው።

ዝግጅት

ሁለት ተለዋዋጮች ትዕዛዞቹን አጭር ያደርጓቸዋል፦

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 ዕቅድ ላይ የእርስዎ የግል የተላለፈ ፖርት ነው። ይህ ጥሪ ብቻ ያነባል፣ ስለዚህ በloop መጠየቁ ደህንነቱ የተጠበቀ ነው።

ያለ SSH ቁልፍ ካዘዙ የ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ው የአገልጋዩን የአሁኑን hostname በconfirm ውስጥ እንዲተይቡ ያስገድድዎታል፣ ስለዚህ የተሳሳተ የአገልግሎት 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 ማጣቀሻን ይመልከቱ። ገና አገልጋይ የለዎትም? ዕቅድ ይምረጡ።