תיעוד REST API של ענן OMC

התחלה מהירה

ה־API של ענן OMC הוא RESTful ועובד עם כל לקוח HTTP בכל שפת תכנות. בצעו אימות עם ה־client ID וה־secret שלכם, ולאחר מכן קראו לכל endpoint.

אימות

צרו את אישורי ה־API שלכם בקונסולת ענן OMC תחת הגדרות → מפתחות API. תקבלו clientId ו־secret.

ניתן לאמת בקשות בשתי דרכים:

אפשרות 1 — אישורים ישירים בכותרות

curl https://console.omc.cloud/service/servers \
  -H "Content-Type: application/json" \
  -H "clientId: YOUR_CLIENT_ID" \
  -H "secret: YOUR_SECRET"

אפשרות 2 — מבוסס טוקן (מומלץ לקריאות חוזרות)

ראשית, החליפו את האישורים בטוקן בעל תוקף של שעה:

curl -X POST https://console.omc.cloud/service/authenticate \
  -H "Content-Type: application/json" \
  -d '{"clientId":"YOUR_CLIENT_ID","secret":"YOUR_SECRET"}'

Endpoints עיקריים

ה־API כולל endpoints לניהול שרתים, חיבור/כיבוי, CPU/RAM/דיסקים, snapshots, חיוב והגדרות.

• ניהול שרתים — יצירה, שיכפול, מידע, סיום
• ניהול חשמל — הפעלה, כיבוי, אתחול
• משאבים — שינוי CPU/RAM/דיסק
• Snapshots — יצירה, שחזור, מחיקה
• חיוב — מעבר בין מודלים חודשיים ולשעה
• ספריית דיסקים — שיכפול וגיבוי

לתיעוד ה־API המלא עם דוגמאות קוד ב־cURL ו־Python: עברו לגרסה האנגלית.

טיפול בשגיאות

ה־API משתמש בקודי סטטוס HTTP סטנדרטיים:

• 200 OK — בקשה הצליחה
• 400 Bad Request — פרמטרים לא תקינים
• 401 Unauthorized — אישורים חסרים או לא תקפים
• 404 Not Found — המשאב לא קיים
• 500 Internal Server Error — שגיאה בצד השרת

רוב הפעולות מחזירות task ID שניתן להשתמש בו למעקב אחר התקדמות. כל הבקשות חייבות להישלח מעל HTTPS.

מוכנים להתחיל לפתח?

צרו את אישורי ה־API שלכם בקונסולת ענן OMC והתחילו באוטומציה תוך דקות.