ממשק ה- API של Zevenet Community Edition v3.1
ZAPI (Zevenet Application Programming Interface) הוא הכלי עבור מנהל המערכת כדי לפקח Zevenet עומס איזון התנהגות.
יש צורך פעיל zapi המשתמש מממשק האינטרנט לפני השימוש בו, מערכת / משתמשים.
לאחר שהמשתמש zapi נוצר, ניתן לשלוח בקשה לכתובת URL, https: // (zevenet_server): 444 / zapi / v3.1 / zapi.cgi / (URI_path), שם zevenet_server הוא ה- IP שבו שירות HTTP מקשיב.
URI_path
מגדיר את האובייקט או הפעולה לפעול. ההתנהגות שלו והפרמטרים שלו יוגדרו בתוך כל חלק של דקדוקציה.
הפעלים המשמשים בממשק API זה יהיו לקבל, POST, PUT or למחוק. בקשת PUT או POST תמיד זקוקה כמעט לפרמטר אם כי אין בכך צורך בפרמטר נדרש.
תעודות
Zevenet תומך cetificates בפורמט PEM להשתמש בהם עם חוות HTTP שלך עם המאזין HTTPS. אם אתה רוצה ללמוד עוד על איך ליצור אישורים pem אנא בקר במאמר הבא: יצירת תעודות ב PEM פורמט
רשום את כל האישורים
רשום את כל האישורים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/certificates
GET /certificates
רשימת כל אישורי CSR ו- PEM בחנות אישורים, אישורים אלה ניתן להשתמש עם חוות HTTPS.
התגובה תהיה אובייקט JSON עם מקש מוגדר params. הערך של זה יהיה מערך של אובייקטים אישור, שכל אחד מהם מכילים את תכונות המפתח להלן.
דוגמה לתגובה:
{
"description" : "List all certificates",
"params" : [
{
"CN" : "Zen Load Balancer",
"creation" : "Jan 12 14:49:03 2011 GMT",
"expiration" : "Jan 9 14:49:03 2021 GMT",
"file" : "zencert.pem",
"issuer" : "Zen Load Balancer",
"type" : "Certificate"
}
]
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
params | אובייקט [] | רשימה של אובייקטים אישור. |
אובייקט אישור
שדה | סוּג | תיאור |
---|---|---|
CN | מחרוזת | שם נפוץ של דומיין. |
יצירה | מחרוזת | תאריך היווצרות. |
תפוגה | מחרוזת | תאריך תפוגה. |
פילה | מחרוזת | שם הקובץ של התעודה, מזהה ייחודי. |
מנפיק | מחרוזת | הרשות המוסמכת חתומה על התעודה. |
סוג | מחרוזת | CSR או אישור. |
הורד אישור
הורד אישור
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/certificates/example.pem
GET /certificates/<file>
הורד אישור המותקן בחנות אישורים, השתמש בשם הקובץ בבקשה לזהות אותו.
התגובה תכלול את הכותרות המצוינות למטה עם מידע על הקובץ. גוף התגובה יהיה תוכן הקובץ.
כותרות תגובה:
HTTP/1.1 200 OK
Date: Thu, 22 Dec 2016 09:27:47 GMT
Content-Disposition: attachment; filename="example.pem"
Content-Type: application/x-download; charset=ISO-8859-1
Content-Length: 2359
מחיקת אישור
מחיקת אישור
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/certificates/example.pem
DELETE /certificates/<file>
מחיקת אישור לפי שם קובץ בחנות אישורים.
דוגמה לתגובה:
{
"description" : "Delete certificate",
"message" : "The Certificate example.pem has been deleted.",
"success" : "true"
}
צור אישור אחריות חברתית
צור אישור אחריות חברתית
דוגמה לבקשה:
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"NewCSR","fqdn":"host.domain.com","division":"IT","organization":"Example Corp.",
"locality":"Madrid","state":"Madrid","country":"ES","mail":"info@domain.com"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/certificates
POST /certificates
צור בקשת חתימה של אישור (קובץ CSR).
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
שם | מחרוזת | שם תעודת הזהות. | נָכוֹן |
fqdn | מחרוזת | שם התחום המלא של השרת שלך. | נָכוֹן |
חלוק | מחרוזת | חלוקת הארגון שלך בטיפול בתעודה. | נָכוֹן |
ארגון | מחרוזת | השם החוקי של הארגון שלך. | נָכוֹן |
יישוב | מחרוזת | העיר שבה נמצא הארגון שלך. | נָכוֹן |
היו | מחרוזת | המדינה / האזור שבהם נמצא הארגון שלך. | נָכוֹן |
מדינה | מחרוזת | קוד ISO בן שתי האותיות עבור הארץ שבה הארגון שלך נמצא במיקום. | נָכוֹן |
דואר | מחרוזת | כתובת דוא"ל המשמשת ליצירת קשר עם הארגון שלך. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Create CSR",
"message" : "Certificate NewCSR created",
"success" : "true"
}
העלה אישור
העלה אישור
דוגמה לבקשה:
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: text/plain'
--tcp-nodelay --data-binary @/local_path/to/example.pem
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/certificates/example.pem
POST /certificates/<file>
העלה אישור PEM עבור חוות HTTP עם המאזין HTTPS.
דורש את הפרמטר --tcp-nodelay
, ו --data-binary
כדי להעלות את הקובץ במצב בינארי.
בקש פרמטרים של URI
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פילה | מחרוזת | שם קובץ אישור להעלאה ולשמירה בחנות אישורים. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Upload PEM certificate",
"message" : "Certificate uploaded",
"success" : "true"
}
רשימת צופן
רשימת צופן
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/ciphers
GET /ciphers
רשום את הצופן הזמין שחוות HTTPS יכולה להשתמש בו.
התגובה תהיה אובייקט JSON עם מקש מוגדר params. הערך של זה יהיה מערך של אובייקטים אישור, שכל אחד מהם מכילים את תכונות המפתח להלן.
דוגמה לתגובה:
{
"description" : "Get the ciphers available",
"params" : [
{
"ciphers" : "all",
"description" : "All"
},
{
"ciphers" : "highsecurity",
"description" : "High security"
},
{
"ciphers" : "customsecurity",
"description" : "Custom security"
}
]
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
params | אובייקט [] | רשימה של אובייקטים אישור. |
אובייקט אישור
שדה | סוּג | תיאור |
---|---|---|
Ciphers | מחרוזת | הוא משמש כמזהה ייחודי. |
תיאור | מחרוזת | שם ידידותי. |
חוות
Zevenet היא מסוגלת לנהל את התנועה בשלוש דרכים שונות, בכל דרך מנוהלת על ידי מודול אחר, איזון עומס שירות מקומי או מודול LSLB ו Datalink Service Load Balancer או מודול DSLB.
כל המודולים לעבוד עם המושג פרופיל משק, פרופיל משק היא קבוצה של פרמטרים מוכן לעשות פעולה ספציפית עם תעבורת הרשת, חשוב להבין מה הוא מסוגל לעשות כל פרופיל החווה על מנת להשיג את התוצאות הטובות ביותר של זאבנט ADC.
- LSLB: מודול זה מסוגל לעבוד עם http ו l4xnat פרופיל חוות. זה עובד כמו proxy הפוך האינטרנט או נתב
- DSLB: מודול זה מסוגל לעבוד עם DataLink חקלאית זה עובד כשער.
רשום את כל החוות
רשום את כל החוות
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms
GET /farms
רשום את כל החוות הזמינות
התגובה תהיה אובייקט JSON עם מקש מוגדר params. הערך של זה יהיה מערך של אובייקטים לחידוש משק, שכל אחד מהם מכיל את תכונות המפתח להלן.
אובייקט החווה
שדה | סוּג | תיאור |
---|---|---|
שם החווה | מחרוזת | שם תיאור החווה. הוא משמש כמזהה ייחודי. |
פרופיל | מחרוזת | סוג הפרופיל, ערכי הפרופיל הזמינים הם: http, https or l4xnat עבור מודול LSLB ו DataLink עבור מודול DSLB |
מצב | מחרוזת | מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה. |
החברים | מחרוזת | Virtual IP שבו החווה מקבלת תנועה |
גווניה | מחרוזת | יציאה וירטואלית שבה החווה מקבלת תנועה, הערכים הזמינים של הנמל הם: מספר יציאה עבור http [s] ו- l4xnat, קבוצת יציאות המופרדת על ידי "," או טווח יציאה המופרד על ידי ":" עבור פרופילי l4xnat, ב- l4xnat שניהם המפריד ניתן להשתמש בערכים ("," ו- ":") באותו שדה. |
דוגמה לתגובה:
{
"description" : "List farms",
"params" : [
{
"farmname" : "httpFarm",
"profile" : "http",
"status" : "up",
"vip" : "192.168.101.146",
"vport" : "81"
}
]
}
מחק משק חקלאי
מחק משק חקלאי
דוגמה לבקשה:
curl --tlsv1 -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP
DELETE /farms/<farmname>
מחק חווה באמצעות שם החווה שלו identfier.
דוגמה לתגובה:
{
"description" : "Delete farm FarmHTTP",
"message" : "The Farm FarmHTTP has been deleted.",
"success" : "true"
}
הגדר פעולה בחווה
הגדר פעולה בחווה
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"stop"}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/FarmTCP/actions
PUT /farms/<farmname>/actions
החל פעולה על חווה, עיין בטבלה פרמטרים בקשה לפעולות.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
פעולה | מחרוזת | הגדר את הפעולה הרצויה. הפעולות הן: להפסיק, החווה תיעצר. התחלה, החווה תתחיל ו הפעלה מחדש, החווה תיעצר ותתחיל באופן אוטומטי. |
דוגמה לתגובה:
{
"description" : "Set a new action in FarmHTTP",
"params" : [
{
"action" : "stop"
}
]
}
פרמטרים של תגובה
אם אין בעיות בתצורה, zapi יחזיר את הפעולה המבוקשת.
חוות HTTP
פרופיל HTTP הוא שכבה מתקדמת 7 איזון עומס (או יישום Application Controller) עם מאפיינים מיוחדים proxy. פרופיל זה מציע כמה תכונות כמו HTTPS שכבת 7 איזון עומסים. פרופיל זה מיועד לשירותי אינטרנט (שרתי יישומי אינטרנט כלולים) וכל פרוטוקולי היישום המבוססים על פרוטוקולי HTTP ו- HTTPS כמו WebDav, RDP over HTTP, ICA over HTTP וכו '. כדי להגדיר פרופיל משק זה, כתובת IP וירטואלית יציאת TCP וירטואלית תידרש.
אחזר את החווה לפי שם
אחזר את החווה לפי שם
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/httpFarm
GET /farms/<farmname>
הצג את כל תצורת החווה.
דוגמה לתגובה:
{
"description" : "List farm httpFarm",
"params" : {
"certlist" : [
{
"file" : "zencert.pem",
"id" : 1
}
],
"cipherc" : "ALL",
"ciphers" : "all",
"contimeout" : 20,
"disable_sslv2" : "true",
"disable_sslv3" : "false",
"disable_tlsv1" : "false",
"disable_tlsv1_1" : "true",
"disable_tlsv1_2" : "false",
"error414" : "Request URI is too long.",
"error500" : "An internal server error occurred. Please try again later.",
"error501" : "This method may not be used.",
"error503" : "The service is not available. Please try again later.",
"httpverb" : "MSRPCext",
"listener" : "https",
"reqtimeout" : 30,
"restimeout" : 45,
"resurrectime" : 10,
"rewritelocation" : "enabled",
"status" : "up",
"vip" : "192.168.100.211",
"vport" : 200
},
"services" : [
{
"backends" : [],
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "service3",
"leastresp" : "false",
"persistence" : "",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "",
"ttl" : 0,
"urlp" : "",
"vhost" : ""
},
{
"backends" : [
{
"id" : 0,
"ip" : "192.168.0.168",
"port" : 80,
"status" : "up",
"timeout" : null,
"weight" : null
}
],
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "tcp_check",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "srv",
"leastresp" : "false",
"persistence" : "",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "",
"ttl" : 0,
"urlp" : "",
"vhost" : ""
},
]
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפורמט שלהלן.
אובייקט משק חקלאי:
שדה | סוּג | תיאור |
---|---|---|
params | חפץ | פרמטרים של תצורה חקלאית. |
שירותים | אובייקט [] | מערך עם כל השירותים שנוצרו בחווה זו ואת התצורה שלה. |
אובייקט פרמטרים עבור חוות HTTP:
שדה | סוּג | תיאור |
---|---|---|
certlist | אובייקט [] | רק בפרופיל https. אישור מופעל בחווה, בפורמט pem, מותר להוסיף רק תעודת אחד pem לאותה החווה. המאזין עם ערך https נדרש. כל תעודת פם בחנות אישורים ניתן להשתמש כאן. |
cipherc | מחרוזת | רק במאזין https. זוהי רשימה מותאמת אישית של צופן שיתקבל על ידי חיבור SSL, שהוא מחרוזת באותו פורמט כמו בצופן OpenSSL. זה atribute משמש רק כאשר Ciphers שדה יש ערך sutomsecurity. |
Ciphers | מחרוזת | רק מאזין עם ערך https. משמש כדי לבנות רשימה של צופן המקובל על ידי חיבורי SSL כדי להקשיח את חיבור SSL. האפשרויות הן: את כל, כל הצופן יתקבל; אבטחה גבוהה, רק צפנים לביטחון גבוה יתקבלו; או - מכס, רק ciphers טעון ב cipherc שדה יתקבל. |
ת | מספר | כמה זמן החווה הולך לחכות חיבור TCP כדי backend בתוך שניות. |
disable_sslv2 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן את הקישורים באמצעות פרוטוקול אבטחה SSL עם גרסה 2 אסור; או שקר אם פרוטוקול SSLv2 מותר. |
disable_sslv3 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן את הקישורים באמצעות פרוטוקול אבטחה SSL עם גרסה 3 אסור; או שקר אם פרוטוקול SSLv3 מותר. |
disable_tlsv1 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1 אסורים; או שקר אם פרוטוקול TLSv1 מותר. |
disable_tlsv1_1 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1.1 אסורים; או שקר אם פרוטוקול TLSv1.1 מותר. |
disable_tlsv1_2 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1.2 אסורים; או שקר אם פרוטוקול TLSv1.2 מותר. |
error414 | מחרוזת | הודעה מותאמת אישית עבור תגובה לקוד השגיאה של 414 HTTP. |
error500 | מחרוזת | הודעה מותאמת אישית עבור תגובה לקוד השגיאה של 500 HTTP. |
error501 | מחרוזת | הודעה מותאמת אישית עבור תגובה לקוד השגיאה של 501 HTTP. |
error503 | מחרוזת | הודעה מותאמת אישית עבור תגובה לקוד השגיאה של 503 HTTP. |
http | מחרוזת | שדה זה מציין את הפעולות שיהיו מותרות בבקשות הלקוח של HTTP. הערכים הזמינים הם: סטנדרטי, בקשות naccepted http קבל, פוסט, HEAD. extendedHTTP, קיבל בקשות http הקודמת בתוספת PUT, DELETE. תקן, קיבל בקשות HTTP הקודם בתוספת LOCK, UNLOCK, PROPPATCH, חיפוש, MKCOL, MOVE, COPY, אפשרויות, TRACE, MKACTIVITY, CHECKOUT, MERGE, MSextWebDAV קיבל בקשות HTTP קודמות ועוד הירשם, בטל רישום, ציין, BPROPFIND, BPROPPATCH, POLL, BMOV, BCOPY, BDELETE, CONNECT או MSRPCext, קיבל בקשות HTTP קודמות ו- RPC_IN_DATA, RPC_OUT_DATA. שים לב כי ערכים אלה הם רגישים למקרה. |
מאזין | מחרוזת | המאזין מגדיר כיצד החווה הולך לשחק עם הבקשות של הלקוחות. האפשרויות הן: http עבור פרוטוקול לא מאובטח או https עבור פרוטוקול מאובטח. |
זמן | מספר | כמה זמן החווה הולך לחכות לבקשת הלקוח בתוך שניות. |
restimeout | מספר | כמה זמן החווה הולך לחכות תגובה מן backends בתוך שניות. |
לתחייה | מספר | התקופה לצאת שרת אמיתי נפל, לאחר תקופה זו איזון עומס בודק אם השרת האמיתי הוא חי, בתוך שניות. |
שכתוב מחדש | מחרוזת | אם היא מופעלת, החווה נאלצת לשנות את מיקום המיקום ותוכן המיקום: כותרות בתגובות ללקוחות עם המארח הווירטואלי. האפשרויות הן: מופעל, מופעל נכה, אינו פעיל או מאופשר- backends רק את כתובת backend מושווה. |
מצב | מחרוזת | מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
גווניה | מספר | נמל של החווה, שבו השירות וירטואלי מקשיב. |
אובייקט Certlist:
שדה | סוּג | תיאור |
---|---|---|
פילה | מחרוזת | שם האישור, הפניות לאישור בחנות אישורים. |
id | מספר | מזהה תעודה. |
אובייקט שירותים עבור חוות HTTP:
שדה | סוּג | תיאור |
---|---|---|
backends | אובייקט [] | Backends שהוגדרו בשירות. |
fgenabled | מחרוזת | הפעל את השימוש באפוטרופוס החווה. נָכוֹן אפוטרופוס החווה מופעלת ובודקת מצב backends, שקר אפוטרופוס החווה מושבת ולא בודק מצב backenders. בפרופילי HTTP, check_tcp מבוצע כברירת מחדל גם אם האפוטרופוס של החווה מושבת. |
fglog | מחרוזת | הפעל את השימוש ביומנים באפוטרופוס של החווה. נָכוֹן מאופשר, שקר, מושבת. fgenabled נדרש. |
fgscript | מחרוזת | הפקודה אשר אפוטרופוס החווה ישתמש לבדיקת בריאות backends. נָכוֹן מאופשר, שקר, מושבת. fgenabled נדרש. |
לבדוק | מספר | אפוטרופוס החווה יבדוק בכל 'שניות' בדיקות את מצב הבריאות. fgenabled נדרש. |
https | מחרוזת | פרמטר זה מציין לחווה כי שרתי backend שהוגדרו בשירות הנוכחי משתמשים בשפה HTTPS ולאחר מכן הנתונים יהיו מוצפנים לפני שנשלחו. נָכוֹן, פרופיל שולח את התנועה בפרוטוקול HTTPS כדי backends, שקר, פרופיל שולח את התנועה בפרוטוקול HTTP כדי backends. |
id | מחרוזת | שם השירות, לא ניתן לשנות אותו לאחר יצירת השירות. |
leastresp | מחרוזת | זה מאפשר את שיטת האיזון לפחות להגיב. נָכוֹן frecuently פרופיל בודק אשר backend לוקח פחות זמן להגיב על מנת לשלוח קשרים נוספים זה, שקר הפרופיל לא בודק איזה backend לוקח פחות זמן להגיב. |
התמדה | מחרוזת | פרמטר זה מגדיר כיצד שירות HTTP ינהל את הפעלת הלקוח. האפשרויות הן: "" מחרוזת ריקה, לא נעשה שום פעולה, IP את ההתמדה הפגישה נעשית בבסיס של IP הלקוח, בסיסי את ההתמדה מושב נעשה בבסיס BASIC כותרות, כתובת האתר הפגישה התמדה נעשית בבסיס שדה ב- URI, פארם הפגישה התמדה נעשית בבסיס ערך בסוף URI, עוגייה את ההתמדה הפגישה נעשית בבסיס של שם קובץ cookie, זה עוגיה יש ליצור על ידי backends, ו HEADER, את ההתמדה מושב נעשה בבסיס של שם הכותרת. |
הפניה | מחרוזת | זה מתנהג כמו backend מיוחד, כמו בקשת הלקוח הוא ענה על ידי הפנייה מחדש לכתובת חדשה באופן אוטומטי. אם הוגדרה כתובת אתר להפניה מחדש, הבקשה לא תועבר אל ה- backend, במקום זאת, כתובת אתר להפניה מחדש תגיב ללקוח. |
redirecttype | מחרוזת | כיצד ניתוב מחדש, שתי אפשרויות: ברירת מחדל, כתובת האתר נלקחת כמארחת מוחלטת ונתיב להפניה מחדש, לצרף, נתיב הבקשה המקורי או URI יצורפו למארח ולנתיב שציינת עם אפשרות ברירת המחדל. אם הפניה השדה אינו מוגדר, שדה זה יהיה מחרוזת ריקה. |
sessionid | מחרוזת | זה זמין אם התמדה השדה הוא URL, COOKIE או HEADER, ערך הפרמטר יחפש על ידי החווה בכותרת http וינהל את הפעלת הלקוח. |
Ttl | מספר | רק בהתמדה. ערך זה מציין את זמן החיים המרבי עבור הפעלת לקוח לא פעילה (גיל הפעלה מרבי) בשניות. |
Urlp | מחרוזת | מאפשר לקבוע שירות אינטרנט לגבי כתובת האתר שהלקוח מבקש באמצעות תבנית כתובת אתר ספציפית שתבדוק באופן סינטקטי. ביטוי רגיל PCRE נתמך. |
ווסט | מחרוזת | הוא מציין את המצב שנקבע על ידי שם התחום באמצעות אותה כתובת IP וירטואלית ויציאה שהוגדרו על ידי חוות HTTP. ביטוי רגיל PCRE נתמך. |
אובייקט Backend עבור חוות HTTP:
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה לאחור בתוך השירות הנתון. |
ip | מחרוזת | ה- IP של Backend שבו פועל השירות האמיתי. |
נמל | מספר | הנמל של Backend שבו פועל השירות האמיתי. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות. אם מערכת null תשתמש בפרמטר הגלובלי Backends Backout. |
מִשׁקָל | מספר | זה ערך המשקל של השרת האמיתי הנוכחי, גב גב בעל ערך משקל גבוה יותר יקבל יותר חיבורים. ערך ברירת המחדל null, לא משקל מיוחד המשמש עבור backend זה. |
יצירת חוות חדשה
יצירת חוות חדשה
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"newHTTPfarm", "profile":"http", "vip":"192.168.100.23",
"vport":80}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms
POST /farms
צור חוות HTTP חדשה.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
שם החווה | מחרוזת | שם תיאור החווה. הוא משמש כמזהה ייחודי. | נָכוֹן |
פרופיל | מחרוזת | הפרופיל של החווה שנוצרה. עבור חוות ה- http הוא http. | נָכוֹן |
החברים | מחרוזת | IP של החווה, שבו השירות הווירטואלי הולך לרוץ. כתובת ה- IP שצוינה חייבת להיות מוגדרת במערכת ו- UP | נָכוֹן |
גווניה | מספר | נמל של החווה, שבו השירות הווירטואלי הולך להקשיב. אותו נמל וירטואלי וכתובת IP וירטואלית אינם חייבים להיות בשימוש על ידי חוות אחרת. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Creating farm 'newHTTPfarm'",
"params" : {
"farmname" : "newHTTPfarm",
"profile" : "http",
"vip" : "192.168.100.23",
"vport" : 80
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי משק חקלאי
שינוי משק חקלאי
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"contimeout":22,"newfarmname":"FarmHTTP2","vip":"178.62.126.152","vport":88,"ignore_100_continue":"true",
"restimeout":47,"resurrectime":12,"reqtimeout":32,"rewritelocation":"enabled","httpverb":"standardHTTP",
"error414":"Message error 414","error500":"Message error 500","error501":"Message error 501",
"error503":"Message error 503","listener":"https","ciphers":"customsecurity","disable_sslv2":"true",
"disable_sslv3":"false","disable_tlsv1":"false","disable_tlsv1_1":"true","disable_tlsv1_2":"false",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP
PUT /farms/<farmname>
שינוי פרמטרים גלובליים לחוות HTTP נתונה.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ת | מספר | כמה זמן את החווה הולך לחכות חיבור backend בתוך שניות. |
restimeout | מספר | כמה זמן החווה הולך לחכות תגובה מן backends בתוך שניות. |
לתחייה | מספר | ערך זה בשניות הוא פרק הזמן להוציא backended backend ובודק אם הוא חי. |
זמן | מספר | כמה זמן החווה הולך לחכות לבקשת הלקוח בתוך שניות. |
disable_sslv2 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן את הקישורים באמצעות פרוטוקול אבטחה SSL עם גרסה 2 אסור; או שקר אם פרוטוקול SSLv2 מותר. |
disable_sslv3 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן את הקישורים באמצעות פרוטוקול אבטחה SSL עם גרסה 3 אסור; או שקר אם פרוטוקול SSLv3 מותר. |
disable_tlsv1 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1 אסורים; או שקר אם פרוטוקול TLSv1 מותר. |
disable_tlsv1_1 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1.1 אסורים; או שקר אם פרוטוקול TLSv1.1 מותר. |
disable_tlsv1_2 | מחרוזת | רק במאזין https. אם לשדה זה יש את הערך נָכוֹן החיבורים באמצעות פרוטוקול אבטחה TLS עם גרסה 1.2 אסורים; או שקר אם |
שכתוב מחדש | מחרוזת | אם היא מופעלת, החווה נאלצת לשנות את מיקום המיקום ותוכן המיקום: כותרות בתגובות ללקוחות עם המארח הווירטואלי. האפשרויות הן: מופעל, מופעל נכה, אינו פעיל או מאופשר- backends רק את כתובת backend מושווה. |
http | מחרוזת | שדה זה מציין את הפעולות שיהיו מותרות בבקשות הלקוח של HTTP. הערכים הזמינים הם: סטנדרטי, בקשות naccepted http קבל, פוסט, HEAD. extendedHTTP, קיבל בקשות http הקודמת בתוספת PUT, DELETE. תקן, קיבל בקשות HTTP הקודם בתוספת LOCK, UNLOCK, PROPPATCH, חיפוש, MKCOL, MOVE, COPY, אפשרויות, TRACE, MKACTIVITY, CHECKOUT, MERGE, MSextWebDAV קיבל בקשות HTTP קודמות ועוד הירשם, בטל רישום, ציין, BPROPFIND, BPROPPATCH, POLL, BMOV, BCOPY, BDELETE, CONNECT או MSRPCext, קיבל בקשות HTTP קודמות ו- RPC_IN_DATA, RPC_OUT_DATA. שים לב כי ערכים אלה הם רגישים למקרה. |
error414 | מחרוזת | הודעת שגיאה מותאמת אישית 414. |
error500 | מחרוזת | הודעת שגיאה מותאמת אישית 500. |
error501 | מחרוזת | הודעת שגיאה מותאמת אישית 501. |
error503 | מחרוזת | הודעת שגיאה מותאמת אישית 503. |
מאזין | מחרוזת | המאזין מגדיר כיצד החווה הולך לשחק עם הבקשות של הלקוחות. האפשרויות הן: http עבור פרוטוקול לא מאובטח או https עבור פרוטוקול מאובטח. |
Ciphers | מחרוזת | רק מאזין עם ערך https. משמש כדי לבנות רשימה של צופן המקובל על ידי חיבורי SSL כדי להקשיח את חיבור SSL. האפשרויות הן: את כל, כל הצופן יתקבל; אבטחה גבוהה, רק צפנים לביטחון גבוה יתקבלו; או - מכס, רק ciphers טעון ב cipherc שדה יתקבל. |
cipherc | מחרוזת | רק במאזין https. זוהי רשימה מותאמת אישית של צופן שיתקבל על ידי חיבור SSL, שהוא מחרוזת באותו פורמט כמו בצופן OpenSSL. זה atribute משמש רק כאשר Ciphers שדה יש ערך sutomsecurity. |
newfarmname | מחרוזת | שם החווה החדשה. חייבים להפסיק את החווה. |
גווניה | מספר | נמל של החווה, שבו השירות וירטואלי מקשיב. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב, IP זה חייב להיות מוגדר ומעלה במערכת. |
דוגמה לתגובה:
{
"description" : "Modify farm FarmHTTP",
"params" : {
"cipherc" : "TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*",
"ciphers" : "customsecurity",
"contimeout" : 22,
"disable_sslv2" : "true",
"disable_sslv3" : "false",
"disable_tlsv1" : "false",
"disable_tlsv1_1" : "true",
"disable_tlsv1_2" : "false",
"error414" : "Message error 414",
"error500" : "Message error 500",
"error501" : "Message error 501",
"error503" : "Message error 503",
"httpverb" : "standardHTTP",
"listener" : "https",
"newfarmname" : "FarmHTTP",
"reqtimeout" : 32,
"restimeout" : 47,
"resurrectime" : 12,
"rewritelocation" : "enabled",
"vip" : "178.62.126.152",
"vport" : 88
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
הוסף אישור
הוסף אישור
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"file":"example.pem"}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/httpFarm/certificates
POST /farms/<farmname>/certificates
שנה את אישור ה- PEM של חוות HTTP עם מאזין HTTPS. התעודה המשומשת חייבת להיות מועלית כבר במערכת, ראה אישורים> רשום את כל האישורים עבור רשימת האישורים הזמינים.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פילה | מחרוזת | שם קובץ אישור, בעבר יש להעלות את האישור במערכת. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Add certificate",
"message" : "The certificate example.pem has been added to the farm httpFarm, you need restart the farm to apply",
"success" : "true",
"status": "needed restart"
}
HTTP - שירותים
השירותים בתוך חוות פרופיל HTTP מספק שיטת מיתוג תוכן כדי לספק מספר שירותי אינטרנט עם מאפיינים שונים, backends או אפילו שיטות התמדה, באמצעות כמה תנאים דטרמיניסטי בשימוש על ידי הליבה החווה על מנת להתאים את השירות הנכון עבור כל בקשה ללקוח. הגדרת שירות זו תשמש את החווה על מנת לקבוע את שרתי backend שיכולים לספק את התגובה ללקוח.
אובייקט שירות פנים ישנם שני סוגים של ערכים: הקשורים שירות הקשורים farmguardian.
Farmguardian משמש לניטור מתקדמות המדינה backends ו אישית לחלוטין עבור scripts משלך עבור השירות הנוכחי. כאשר בעיה מזוהה על ידי חקלאי משבית באופן אוטומטי את השרת האמיתי ויהיה מסומן כרשימה שחורה.
אחזר שירות לפי מזהה
אחזר שירות לפי מזהה
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/cookiefarm/services/serv
GET /farms/<farmname>/services/<id>
הצג את כל התצורה לגבי שירות מסוים.
דוגמה לתגובה:
{
"description" : "Get services of a farm",
"services" : {
"backends" : [
{
"id" : 0,
"ip" : "192.168.100.254",
"port" : 80,
"status" : "up",
"timeout" : 20,
"weight" : null
},
{
"id" : 0,
"ip" : "192.168.100.254",
"port" : 80,
"status" : "up",
"timeout" : null,
"weight" : null
}
],
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "check_tcp -H HOST -p PORT",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "serv",
"leastresp" : "false",
"persistence" : "COOKIE",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "JSESSIONID",
"ttl" : 18,
"urlp" : "(?i)^/music$",
"vhost" : ""
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפורמט שלהלן.
אובייקט שירותים עבור חוות HTTP:
שדה | סוּג | תיאור |
---|---|---|
backends | אובייקט [] | Backends שהוגדרו בשירות. |
fgenabled | מחרוזת | הפעל את השימוש באפוטרופוס החווה. נָכוֹן אפוטרופוס החווה מופעלת ובודקת מצב backends, שקר אפוטרופוס החווה מושבת ולא בודק מצב backenders. בפרופילי HTTP, check_tcp מבוצע כברירת מחדל גם אם האפוטרופוס של החווה מושבת. |
fglog | מחרוזת | הפעל את השימוש ביומנים באפוטרופוס של החווה. נָכוֹן מאופשר, שקר, מושבת. fgenabled נדרש. |
fgscript | מחרוזת | הפקודה אשר אפוטרופוס החווה ישתמש לבדיקת בריאות backends. נָכוֹן מאופשר, שקר, מושבת. fgenabled נדרש. |
לבדוק | מספר | אפוטרופוס החווה יבדוק בכל 'שניות' בדיקות את מצב הבריאות. fgenabled נדרש. |
https | מחרוזת | פרמטר זה מציין לחווה כי שרתי backend שהוגדרו בשירות הנוכחי משתמשים בשפה HTTPS ולאחר מכן הנתונים יהיו מוצפנים לפני שנשלחו. נָכוֹן, פרופיל שולח את התנועה בפרוטוקול HTTPS כדי backends, שקר, פרופיל שולח את התנועה בפרוטוקול HTTP כדי backends. |
id | מחרוזת | שם השירות, לא ניתן לשנות אותו לאחר יצירת השירות. |
leastresp | מחרוזת | זה מאפשר את שיטת האיזון לפחות להגיב. נָכוֹן frecuently פרופיל בודק אשר backend לוקח פחות זמן להגיב על מנת לשלוח קשרים נוספים זה, שקר הפרופיל לא בודק איזה backend לוקח פחות זמן להגיב. |
התמדה | מחרוזת | פרמטר זה מגדיר כיצד שירות HTTP ינהל את הפעלת הלקוח. האפשרויות הן: "" מחרוזת ריקה, לא נעשה שום פעולה, IP את ההתמדה הפגישה נעשית בבסיס של IP הלקוח, בסיסי את ההתמדה מושב נעשה בבסיס BASIC כותרות, כתובת האתר הפגישה התמדה נעשית בבסיס שדה ב- URI, פארם הפגישה התמדה נעשית בבסיס ערך בסוף URI, עוגייה את ההתמדה הפגישה נעשית בבסיס של שם קובץ cookie, זה עוגיה יש ליצור על ידי backends, ו HEADER, את ההתמדה מושב נעשה בבסיס של שם הכותרת. |
הפניה | מחרוזת | זה מתנהג כמו backend מיוחד, כמו בקשת הלקוח הוא ענה על ידי הפנייה מחדש לכתובת חדשה באופן אוטומטי. אם הוגדרה כתובת אתר להפניה מחדש, הבקשה לא תועבר אל ה- backend, במקום זאת, כתובת אתר להפניה מחדש תגיב ללקוח. |
redirecttype | מחרוזת | כיצד ניתוב מחדש, שתי אפשרויות: ברירת מחדל, כתובת האתר נלקחת כמארחת מוחלטת ונתיב להפניה מחדש, לצרף, נתיב הבקשה המקורי או URI יצורפו למארח ולנתיב שציינת עם אפשרות ברירת המחדל. אם הפניה השדה אינו מוגדר, שדה זה יהיה מחרוזת ריקה. |
sessionid | מחרוזת | זה זמין אם התמדה השדה הוא URL, COOKIE או HEADER, ערך הפרמטר יחפש על ידי החווה בכותרת http וינהל את הפעלת הלקוח. |
Ttl | מספר | רק בהתמדה. ערך זה מציין את זמן החיים המרבי עבור הפעלת לקוח לא פעילה (גיל הפעלה מרבי) בשניות. |
Urlp | מחרוזת | מאפשר לקבוע שירות אינטרנט לגבי כתובת האתר שהלקוח מבקש באמצעות תבנית כתובת אתר ספציפית שתבדוק באופן סינטקטי. ביטוי רגיל PCRE נתמך. |
ווסט | מחרוזת | הוא מציין את המצב שנקבע על ידי שם התחום באמצעות אותה כתובת IP וירטואלית ויציאה שהוגדרו על ידי חוות HTTP. ביטוי רגיל PCRE נתמך. |
אובייקט Backend עבור חוות HTTP:
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה לאחור בתוך השירות הנתון. |
ip | מחרוזת | ה- IP של Backend שבו פועל השירות האמיתי. |
נמל | מספר | הנמל של Backend שבו פועל השירות האמיתי. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות. אם מערכת null תשתמש בפרמטר הגלובלי Backends Backout. |
מִשׁקָל | מספר | זה ערך המשקל של השרת האמיתי הנוכחי, גב גב בעל ערך משקל גבוה יותר יקבל יותר חיבורים. ערך ברירת המחדל null, לא משקל מיוחד המשמש עבור backend זה. |
צור שירות חדש
צור שירות חדש
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"newserv"}' https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP/services
POST /farms/<farmname>/services
יצירת שירות בפרופיל HTTP נתון בחווה. החווה זקוקה לפעולת הפעלה מחדש כדי להחיל שינוי זה.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
id | מחרוזת | שם שירות המשמש כמזהה ייחודי. רק ערכים אלפאנומריים מותרים. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "New service newserv",
"params" : {
"id" : "newserv"
},
"status" : "needed restart"
}
שינוי שירות
שינוי שירות
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"vhost":"www.mywebserver.com","urlp":"^/myapp1$","persistence":"URL",
"redirect":"http://zenloadbalancer.com","ttl":125,"sessionid":"sid","leastresp":"true",
"httpsb":"true"}' https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP/services/sev2
PUT /farms/<farmname>/services/<id>
שינוי הפרמטרים של שירות בפרופיל HTTP. id הוא מזהה השירות הייחודי שישונה.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ווסט | מחרוזת | מציין את המצב שנקבע על-ידי שם התחום באמצעות אותו כתובת IP וירטואלית ויציאה שהוגדרו על-ידי חוות פרופיל של HTTP. ביטוי רגיל PCRE נתמך. |
Urlp | מחרוזת | מאפשר לקבוע שירות אינטרנט לגבי כתובת האתר שהלקוח מבקש באמצעות תבנית כתובת אתר ספציפית שתבדוק באופן סינטקטי. ביטוי רגיל PCRE נתמך. |
הפניה | מחרוזת | זה עובד כמו backend מיוחד, בקשת הלקוח הוא ענה על ידי הפנייה מחדש כתובת אתר חדשה באופן אוטומטי. |
redirecttype | מחרוזת | כיצד תבוצע הפנייה מחדש, שתי אפשרויות: ברירת מחדל, כתובת האתר נלקחת כמארחת מוחלטת ונתיב להפניה מחדש, לצרף, נתיב הבקשה המקורי או URI יצורפו למארח ולנתיב שציינת הפניה שדה. התנהגות זו תחול רק אם הפניה אינו ערך ריק. |
התמדה | מחרוזת | פרמטר זה מגדיר כיצד שירות HTTP ינהל את הפעלת הלקוח. האפשרויות הן: "" מחרוזת ריקה, לא נעשה שום פעולה, IP את ההתמדה הפגישה נעשית בבסיס של IP הלקוח, בסיסי את ההתמדה מושב נעשה בבסיס BASIC כותרות, כתובת האתר הפגישה התמדה נעשית בבסיס שדה ב- URI, פארם מושב ההתמדה נעשה בבסיס ערך המופרד על ידי ";" בסוף ה- URI, עוגייה את ההתמדה הפגישה נעשית בבסיס של שם קובץ cookie, זה עוגיה יש ליצור על ידי backends, ו HEADER, את ההתמדה מושב נעשה בבסיס של שם הכותרת. |
Ttl | מספר | רק בהתמדה. הזמן המרבי של החיים עבור הפעלת לקוח לא פעיל (גיל הפעלה מירבי) בשניות. |
sessionid | מחרוזת | זה זמין אם התמדה שדה כתובת האתר, עוגייה or HEADER, ערך הפרמטר יחפש על ידי הפרופיל בכותרת http וינהל את הפעלת הלקוח. |
leastresp | מחרוזת | זה מאפשר את שיטת האיזון לפחות להגיב. נָכוֹן, באופן חופשי את הפרופיל בודק אשר backend לוקח פחות זמן להגיב על מנת לשלוח קשרים נוספים זה, שקר, הפרופיל לא בודק איזה backend לוקח פחות זמן להגיב. |
https | מחרוזת | זה מציין לחווה כי שרתי backends שהוגדרו בשירות הנוכחי משתמשים בשפה HTTPS ולאחר מכן הנתונים יהיה מוצפן לפני להישלח. נָכוֹן, פרופיל שולח את התנועה בפרוטוקול HTTPS כדי backends, שקר, פרופיל שולח את התנועה בפרוטוקול HTTP כדי backends. |
דוגמה לתגובה:
{
"description" : "Modify service newsrv in farm newHTTPfarm",
"info" : "There're changes that need to be applied, stop and start farm to apply them!",
"params" : {
"backends" : [],
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"httpsb" : "true",
"id" : "newsrv",
"leastresp" : "true",
"persistence" : "",
"redirect" : "http://zenloadbalancer.com",
"redirecttype" : "default",
"sessionid" : "sid",
"ttl" : 125,
"urlp" : "^/myapp1$",
"vhost" : "www.mywebserver.com"
},
"status" : "needed restart"
}
פרמטרי תגובה
התגובה תהיה json עם פרמטרים המבוקש עודכן מצב שדה עם יש צורך מחדש ערך. יש לבצע פעולת הפעלה מחדש כדי להחיל את השינויים.
שינוי אפוטרופוס החווה
שינוי אפוטרופוס החווה
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"check_tcp","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP/fg
Farmguardian משמש לניטור מתקדמות המדינה backends ו אישית לחלוטין עבור scripts משלך עבור השירות הנוכחי. כאשר בעיה מזוהה על ידי חקלאי משבית באופן אוטומטי את השרת האמיתי ויהיה מסומן כרשימה שחורה.
PUT /farms/<farmname>/fg
שינוי הפרמטרים של אפוטרופוס החווה בפרופיל HTTP נתון.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
לבדוק | מספר | האפוטרופוס החקלאי יבדוק את מצב הבריאות האחורי בכל שניות 'לוח בדיקה'. | |
fgscript | מחרוזת | הפקודה אשר אפוטרופוס החווה יפעל לבדיקת מצב בריאותי backends | |
fgenabled | מחרוזת | הוא מאפשר אפוטרופוס החווה בשירות המצוין. נָכוֹן משק אפריקאי הולך לשמש לבדיקת מצב backenders, שקר אפוטרופוס החווה הולך להיות מושבת | |
fglog | מחרוזת | הפעל את השימוש ביומנים באפוטרופוס של החווה. נָכוֹן אפוטרופוס החווה עומד להיכנס כל פעולה, שקר אפוטרופוס החווה לא הולך להיכנס כל פעולה, מומלץ להפעיל fglog רק לפתרון בעיות. | |
שרות | מחרוזת | שם השירות משמש כמזהה ייחודי. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Modify farm FarmHTTP",
"params" : {
"fgenabled" : "true",
"fglog" : "true",
"fgscript" : "checktcp",
"fgtimecheck" : 5,
"service" : "service1"
}
}
מחיקת שירות
מחיקת שירות
דוגמה לבקשה:
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP/services/service1
DELETE /farms/<farmname>/services/<id>
מחק שירות מסוים של פרופיל http. id הוא המזהה הייחודי לשירות שיימחק.
דוגמה לתגובה:
{
"description" : "Delete service service1 in farm FarmHTTP",
"message" : "The service service1 in farm FarmHTTP has been deleted.",
"success" : "true",
"status": "needed restart"
}
HTTP - שירותים - Backends
רשימת backends
רשימת backends
דוגמה לבקשה:
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/httpfarm/services/service1/backends
GET /farms/<farmname>/services/<id>/backends
קבל את רשימת backends בשירות. id הוא המזהה הייחודי לשירות.
דוגמה לתגובה:
{
"description" : "List service backends",
"params" : [
{
"id" : 0,
"ip" : "192.168.0.10",
"port" : 88,
"status" : "up",
"timeout" : 12,
"weight" : 1
},
{
"id" : 1,
"ip" : "192.168.102.245",
"port" : 80,
"status" : "up",
"timeout" : 22,
"weight" : 2
}
]
}
פרמטרי תגובה
שיחה זו מחזירה מערך אובייקט backend עם הפרמטרים השוררים.
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה ייחודי עבור backend בשירות. מזהה זה נוצר על ידי המערכת. |
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. |
נמל | מספר | הנמל של Backend שבו השירות מאזין. |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות. |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
צור Backend חדש
צור Backend חדש
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.102.244","port":80, "weight":2,"timeout":2}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/httpfarm/services/newsrv/backends
POST /farms/<farmname>/services/<id>/backends
צור Backend חדש בפרופיל HTTP נתון. id הוא המזהה הייחודי לשירות.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. | נָכוֹן |
נמל | מספר | הנמל של Backend שבו השירות מאזין. | נָכוֹן |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת. | |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. |
דוגמה לתגובה:
{
"description" : "New service backend",
"message" : "Added backend to service succesfully",
"params" : {
"id" : 0,
"ip" : "192.168.102.244",
"port" : 80,
"timeout" : 2,
"weight" : 2
},
"status" : "needed restart"
}
פרמטרי תגובה
התגובה תהיה json עם פרמטרים המבוקש עודכן מצב שדה עם יש צורך מחדש אם החווה חייבת להיות מופעלת מחדש. יש לבצע פעולת הפעלה מחדש כדי להחיל את השינויים.
שינוי Backend
שינוי Backend
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.0.10","port":88,"timeout":12,"service":"sev2", "weight":1}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP/service/service1/backends/1
PUT /farms/<farmname>/service/<id>/backends/<id>
שינוי הפרמטרים של backend בשירות של פרופיל HTTP.
ראשון id הוא מזהה השירות הייחודי, הבא id הוא מזהה ייחודי backend.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. |
נמל | מספר | הנמל של Backend שבו השירות מאזין. |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות. |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. |
דוגמה לתגובה:
{
"description" : "Modify service backend",
"info" : "There're changes that need to be applied, stop and start farm to apply them!",
"message" : "Backend modified",
"params" : {
"ip" : "192.168.0.10",
"port" : 88,
"timeout" : 12,
"weight" : 1
},
"status" : "needed restart"
}
פרמטרי תגובה
התגובה תהיה json עם פרמטרים המבוקש עודכן מצב שדה עם יש צורך מחדש אם החווה חייבת להיות מופעלת מחדש. יש לבצע פעולת הפעלה מחדש כדי להחיל את השינויים.
אחורה בתחזוקה
אחורה בתחזוקה
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"maintenance","mode":"cut"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/httpfarm/services/newsrv/backends/0/maintenance
PUT /farms/<farmname>/services/<id>/backends/<id>/maintenance
הגדר פעולה מסוימת בגב של חומת HTTP, הפעולות הזמינות מתוארות בהמשך.
ראשון id הוא מזהה השירות הייחודי, הבא id הוא מזהה ייחודי backend.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פעולה | מחרוזת | הגדר את הפעולה הרצויה. הפעולות הן: up backend הוא מוכן לקבל בקשות הלקוח, תחזוקה backend אינו מוכן לקבל בקשות לקוח, פעולה זו שימושית עבור עצירת שרת backend מבלי להשפיע על הלקוחות. | נָכוֹן |
מצב | מחרוזת | בחר מצב תחזוקה. האפשרויות הזמינות הן: לנקז, ה- backend אינו מקבל חיבורים חדשים, אך הוא ימשיך לטפל בחיבורים הנוכחיים; אוֹ לחתוך, הקשרים הנוכחיים ייסגרו. | אם שדה זה לא צוין, מצב ברירת המחדל יהיה לנקז. |
דוגמה לתגובה:
{
"description" : "Set service backend status",
"params" : {
"action" : "maintenance",
"mode" : "cut"
}
}
מחק backend
מחק backend
דוגמה לבקשה:
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/newfarmHTTP/services/service1/backends/4
DELETE /farms/<farmname>/services/<id>/backends/<id>
מחיקת backend נתון בשירות של פרופיל HTTP.
ראשון id הוא מזהה השירות הייחודי, הבא id הוא מזהה ייחודי backend.
דוגמה לתגובה:
{
"description" : "Delete service backend",
"message" : "Backend removed",
"success" : "true"
}
L4xNAT חוות
החווה פרופיל L4xAT מאפשר ליצור חוות L4 עם ביצועים גבוהים מאוד חיבורים בו זמנית הרבה יותר מאשר ליבות איזון עומסים בשכבה 7 כמו פרופילים החווה HTTP. זה שיפור ביצועים 4 שכבת counteracts את הטיפול תוכן מתקדם כי פרופילי שכבת 7 יכול לנהל.
בנוסף, חוות L4xNAT יכולים לקשור טווח של יציאות, לא רק יציאה וירטואלית אחת, כפי שהיא משמשת עם פרופילי 7 שכבה אחרים. כדי שתוכל לבחור טווח של יציאות וירטואליות או יציאה וירטואלית ספציפית בחוות L4xNAT, חובה לבחור סוג פרוטוקול. במקרה אחר, החווה תהיה הקשבה על כל היציאות של ה- IP וירטואלי (מסומן עם תו ''). לאחר בחירת פרוטוקול TCP או UDP, הוא יהיה זמין כדי לציין יציאה, מספר יציאות בין ',', טווחי היציאות בין ':' או כל היציאות עם ''. שילוב של כולם יהיה תקף גם כן.
אחזר את החווה לפי שם
אחזר את החווה לפי שם
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm
GET /farms/<farmname>
הצג את כל תצורת החווה.
תגובה BODY:
{
"backends" : [
{
"id" : 0,
"ip" : "192.168.55.40",
"max_conns" : 0,
"port" : "88",
"priority" : 2,
"status" : "undefined",
"weight" : 1
},
{
"id" : 1,
"ip" : "192.168.55.41",
"max_conns" : 0,
"port" : "88",
"priority" : 3,
"status" : "undefined",
"weight" : 2
}
],
"description" : "List farm l4farm",
"params" : {
"algorithm" : "weight",
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"listener" : "l4xnat",
"nattype" : "nat",
"persistence" : "",
"protocol" : "tcp",
"status" : "down",
"ttl" : 120,
"vip" : "192.168.100.241",
"vport" : "88"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפורמט שלהלן.
אובייקט משק חקלאי:
שדה | סוּג | תיאור |
---|---|---|
params | חפץ | פרמטרים של תצורה חקלאית. |
backends | אובייקט [] | כל השרתים האמיתיים שנוצרו בחווה זו ואת התצורה שלה. |
אובייקט פרמטרים עבור חוות L4xNAT:
שדה | סוּג | תיאור |
---|---|---|
אַלגוֹרִיתְם | מחרוזת | סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: postier חיבור תמיד לשרת חיבור לפחות, מִשׁקָל חיבור שיגור ליניארי לפי משקל, פריו קשרים תמיד לפריו הכי זמין. |
מאזין | מחרוזת | מאזין מגדיר כיצד החווה הולכת לשחק עם הבקשות מהלקוחות. שדה מידע, לא ניתן לשנותו. |
nattype | מחרוזת | איך שכבת איזון שכבת 4 הליבה הולך לפעול. האפשרויות הן: נת המכונה גם מצב sNAT, backend מגיב לאיזון עומס על מנת לשלוח את התגובה ללקוח, dnat backend יגיב ישירות ללקוח, איזון עומס צריך להיות מוגדר כשער בשרת backend. |
התמדה | מחרוזת | אותה כתובת IP תחובר לאותו שרת. האפשרויות הן: "" ערך ריק, התמדה מושבתת, ip ההתמדה מופעלת דרך, מקור ה- IP משמש מזהה ייחודי במפגש. |
פרוטוקול | מחרוזת | פרוטוקול להיות מאוזן בשכבה 4. האפשרויות הן: את כל הפרופיל יהיה לטעון איזון כל פרוטוקול L4, TCP האיזון עומס רק איזון פרוטוקול TCP L4, UDP האיזון עומס רק לאזן את הפרוטוקול UDP L4, לגימה איזון עומס רק לאזן SIP או פרוטוקול VoIP L7, FTP איזון עומס רק לאזן את פרוטוקול L7 FTP, tftp איזון העומס יאזן רק את פרוטוקול TFTP L7. |
מצב | מחרוזת | מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה. |
Ttl | מספר | ערך שדה זה מציין את מספר השניות שההקפדה בין מקור הלקוח לבין ה- backend מוקצית, תוך שניות. ההתמדה צריכה להיות מוגדרת. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
גווניה | מחרוזת | נמל של החווה, שבו השירות וירטואלי מקשיב. נמל ייחודי ניתן especified, נמל טווח יכול להיות especified עם מפריד : ואת מספר יציאות ניתן especified עם מפריד ,. |
fgenabled | מחרוזת | מאפשר שימוש באפוטרופוס החווה. נָכוֹן אפוטרופוס החווה מאופשר, שקר אפוטרופוס החווה מושבת. |
fglog | מחרוזת | מאפשר שימוש ביומנים באפוטרופוס החווה. fgenabled חייב להיות מופעל. |
fgscript | מחרוזת | הפקודה אשר אפוטרופוס החווה יבדוק. פקודות זמינות אלה נמצאות בנתיב libexec. fgenabled חייב להיות מופעל. |
לבדוק | מספר | האפוטרופוס החקלאי יבדוק כל שניות 'בדיקת לוח זמנים'. fgenabled חייב להיות מופעל. |
אובייקט Backend עבור חוות L4xNAT:
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה כדי לזהות את backend בחווה. |
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. |
max_conns | מספר | זהו המספר המרבי של חיבור מקביל עבור ה- backend. אם לשדה זה יש את הערך 0, ה- backend לא הגדיר מגבלת חיבור כלשהי. |
נמל | מספר | הנמל של Backend שבו השירות מאזין. מקבלים ערך ריק והוא ישתמש באותה תצורה מאשר יציאות וירטואליות. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
עדיפות | מספר | זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר. |
מִשׁקָל | מספר | זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. |
יצירת חוות חדשה
יצירת חוות חדשה
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"profile":"l4xnat", "vip":"192.168.100.241", "vport":"88","farmname":"newl4farm"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms
POST /farms
צור חוות L4xNAT חדשה.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
שם החווה | מחרוזת | שם החווה, מזהה ייחודי. | נָכוֹן |
פרופיל | מחרוזת | הפרופיל של החווה שנוצרה. עבור חוות L4xNAT הוא l4xnat, הודעת מידע, לא ניתן לשנות ערך זה | נָכוֹן |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. | נָכוֹן |
גווניה | מחרוזת | נמל של החווה, שבו השירות וירטואלי מקשיב. L4xNAT חוות לאפשר multport מופרדים על ידי , או יציאה טווח מופרדים על ידי :. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Creating farm 'newl4farm'",
"params" : {
"farmname" : "newl4farm",
"interface" : "eth0",
"profile" : "l4xnat",
"vip" : "192.168.100.241",
"vport" : "88"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי משק חקלאי
שינוי משק חקלאי
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"algorithm":"weight","persistence":"","newfarmname":"l4farm", "protocol":"tcp",
"nattype":"nat","ttl":125,"vip":"178.62.126.152","vport":"81"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/newfarml4
PUT /farms/<farmname>
שנה את התצורה של חוות L4xNAT.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
newfarmname | מחרוזת | שם החווה החדשה. את החווה חייבים לעצור את זה. |
אַלגוֹרִיתְם | מחרוזת | סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: postier חיבור תמיד לשרת חיבור לפחות, מִשׁקָל חיבור שיגור ליניארי לפי משקל, פריו קשרים תמיד לפריו הכי זמין. |
nattype | מחרוזת | איך שכבת איזון שכבת 4 הליבה הולך לפעול. האפשרויות הן: נת המכונה גם מצב sNAT, backend מגיב לאיזון עומס על מנת לשלוח את התגובה ללקוח, dnat backend יגיב ישירות ללקוח, איזון עומס צריך להיות מוגדר כשער בשרת backend. |
התמדה | מחרוזת | אותה כתובת IP תחובר לאותו שרת. האפשרויות הן: "" ערך ריק, התמדה מושבתת, ip ההתמדה מופעלת דרך, מקור ה- IP משמש מזהה ייחודי במפגש. |
פרוטוקול | מחרוזת | פרוטוקול להיות מאוזן בשכבה 4. האפשרויות הן: את כל הפרופיל יהיה לטעון איזון כל פרוטוקול L4, TCP האיזון עומס רק איזון פרוטוקול TCP L4, UDP האיזון עומס רק לאזן את הפרוטוקול UDP L4, לגימה איזון עומס רק לאזן SIP או פרוטוקול VoIP L7, FTP איזון עומס רק לאזן את פרוטוקול L7 FTP, tftp איזון העומס יאזן רק את פרוטוקול TFTP L7. |
Ttl | מספר | ערך שדה זה מציין את מספר השניות שההקפדה בין מקור הלקוח לבין ה- backend מוקצית, תוך שניות. ההתמדה צריכה להיות מוגדרת. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
גווניה | מחרוזת | נמל של החווה, שבו השירות וירטואלי מקשיב. נמל ייחודי ניתן especified, נמל טווח יכול להיות especified עם מפריד : ואת מספר יציאות ניתן especified עם מפריד ,. |
דוגמה לתגובה:
{
"description" : "Modify farm l4farm",
"params" : {
"algorithm" : "weight",
"nattype" : "nat",
"newfarmname" : "l4farm",
"persistence" : "",
"protocol" : "tcp",
"ttl" : 125,
"vip" : "178.62.126.152",
"vport" : "81"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי אפוטרופוס החווה
שינוי אפוטרופוס החווה
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"Command of Farm Guardian","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/fg
Farmguardian משמש לניטור מתקדמות המדינה backends ו אישית לחלוטין עבור scripts משלך עבור השירות הנוכחי. כאשר בעיה מזוהה על ידי חקלאי משבית באופן אוטומטי את השרת האמיתי ויהיה מסומן כרשימה שחורה.
PUT /farms/<farmname>/fg
שינוי הפרמטרים של האפוטרופוס החווה בשירות L4xNAT.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
fgenabled | מחרוזת | מאפשר שימוש באפוטרופוס החווה. נָכוֹן אפוטרופוס החווה מאופשר, שקר אפוטרופוס החווה מושבת. |
fglog | מחרוזת | מאפשר שימוש ביומנים באפוטרופוס החווה. fgenabled חייב להיות מופעל. |
fgscript | מחרוזת | הפקודה אשר אפוטרופוס החווה יבדוק. פקודות זמינות אלה נמצאות בנתיב libexec. fgenabled חייב להיות מופעל. |
לבדוק | מספר | האפוטרופוס החקלאי יבדוק כל שניות 'בדיקת לוח זמנים'. fgenabled חייב להיות מופעל. |
דוגמה לתגובה:
{
"description" : "Modify farm guardian",
"message" : "Success, some parameters have been changed in farm guardian in farm l4farm.",
"params" : {
"fgenabled" : "true",
"fglog" : "true",
"fgscript" : "check_tcp",
"fgtimecheck" : 5
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
L4xNAT - Backends
רשימת backends
רשימת backends
דוגמה לבקשה:
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/backends
GET /farms/<farmname>/backends
קבל את רשימת backends בשירות.
דוגמה לתגובה:
{
"description" : "List backends",
"params" : [
{
"id" : 0,
"ip" : "192.5.1.1",
"max_conns" : 400,
"port" : 787,
"priority" : 1,
"status" : "up",
"weight" : 1
},
{
"id" : 1,
"ip" : "192.5.1.3",
"max_conns" : 200,
"port" : 787,
"priority" : 2,
"status" : "up",
"weight" : 1
},
]
}
פרמטרי תגובה
שיחה זו מחזירה מערך אובייקט backend עם הפרמטרים השוררים.
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה כדי לזהות את backend בחווה. |
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. |
נמל | מספר | הנמל של Backend שבו השירות מאזין. מקבלים ערך ריק והוא ישתמש באותה תצורה מאשר יציאות וירטואליות. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
max_conns | מספר | זהו המספר המרבי של חיבור מקביל עבור ה- backend. אם לשדה זה יש את הערך 0, ה- backend לא הגדיר מגבלת חיבור כלשהי. |
עדיפות | מספר | זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר. |
מִשׁקָל | מספר | זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. |
צור Backend חדש
צור Backend חדש
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.100","port":8080,"max_conns":400}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/backends
POST /farms/<farmname>/backends
צור Backend חדש בחווה L4xNAT.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. | נָכוֹן |
נמל | מספר | הנמל של Backend שבו השירות מאזין. מקבלים ערך ריק והוא ישתמש באותה תצורה מאשר יציאות וירטואליות. | |
max_conns | מספר | זהו המספר המרבי של חיבור מקביל עבור ה- backend. אם לשדה זה יש את הערך 0, ה- backend לא הגדיר מגבלת חיבור כלשהי. | |
עדיפות | מספר | זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר. ערך ברירת המחדל הוא 1. | |
מִשׁקָל | מספר | זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. ערך ברירת המחדל הוא 1. |
דוגמה לתגובה:
{
"description" : "New farm backend",
"message" : "Backend added",
"params" : {
"id" : 5,
"ip" : "192.168.5.100",
"port" : 8080,
"max_conns" : 400,
"priority" : null,
"weight" : null
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי Backend
שינוי Backend
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.40","port":8080,"max_conns":220,"priority":4,"weight":7}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/backends/2
PUT /farms/<farmname>/backends/<id>
שינוי הפרמטרים של backend בשירות של חוות L4xNAT. id הוא מזהה ייחודי backend.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | ה- IP של Backend שבו השירות האמיתי מאזין. |
נמל | מספר | הנמל של Backend שבו השירות מאזין. מקבלים ערך ריק והוא ישתמש באותה תצורה מאשר יציאות וירטואליות. |
max_conns | מספר | זהו המספר המרבי של חיבור מקביל עבור ה- backend. אם לשדה זה יש את הערך 0, ה- backend לא הגדיר מגבלת חיבור כלשהי. |
עדיפות | מספר | זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר. |
מִשׁקָל | מספר | זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. |
דוגמה לתגובה:
{
"description" : "Modify backend",
"message" : "Backend modified",
"params" : {
"ip" : "192.168.5.40",
"port" : 8080,
"max_conns" : 220,
"priority" : 4,
"weight" : 7
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
אחורה בתחזוקה
אחורה בתחזוקה
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"maintenance","mode":"cut"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/backends/1/maintenance
PUT /farms/<farmname>/backends/<id>/maintenance
הגדרת פעולה מסוימת backend של L4xNAT החווה. id הוא מזהה ייחודי backend.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פעולה | מחרוזת | הגדר את הפעולה הרצויה. הפעולות הן: up backend הוא מוכן לקבל בקשות הלקוח, תחזוקה backend אינו מוכן לקבל בקשות לקוח, פעולה זו שימושית עבור עצירת שרת backend מבלי להשפיע על הלקוחות. | נָכוֹן |
מצב | מחרוזת | בחר מצב תחזוקה. האפשרויות הזמינות הן: לנקז, ה- backend אינו מקבל חיבורים חדשים, אך הוא ימשיך לטפל בחיבורים הנוכחיים; אוֹ לחתוך, הקשרים הנוכחיים ייסגרו. | אם שדה זה לא צוין, מצב ברירת המחדל יהיה לנקז. |
דוגמה לתגובה:
{
"description" : "Set backend status",
"params" : {
"action" : "maintenance",
"mode" : "cut"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
מחק backend
מחק backend
דוגמה לבקשה:
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/l4farm/backends/4
DELETE /farms/<farmname>/backends/<id>
מחיקת backend נתון בשירות של חוות L4xNAT.
id הוא מזהה ייחודי backend.
דוגמה לתגובה:
{
"description" : "Delete backend",
"message" : "Backend removed",
"success" : "true"
}
Datalink חוות
פרופיל החווה datalink מאפשר ליצור חוות מבוסס מסלולים שבו backends הם נתבים uplink או שערים. זה סוג של פרופיל החווה מוכן לשתף כמה Uplink WAN נתב כניסות באמצעות איזון עומס כמו multipllexor ערוץ uplink (קלט 1 וכמה יציאות קו נתב). לכן, חוות datalink יכול לשמש קישורים תקשורת גבוהה זמין בנוסף יכול לשמש רוחב פס להגדיל שהצטרף כמות רוחב הפס בין נתבים backends קישורים.
אחזר את החווה לפי שם
אחזר את החווה לפי שם
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/dlink
GET /farms/<farmname>
הצג את כל תצורת החווה.
דוגמה לתגובה:
{
"backends" : [
{
"id" : 0,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"status" : "undefined",
"weight" : 2
},
{
"id" : 1,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"status" : "undefined",
"weight" : 1
}
],
"description" : "List farm dlink",
"params" : {
"algorithm" : "weight",
"status" : "down",
"vip" : "192.168.100.199"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפורמט שלהלן.
אובייקט משק חקלאי:
שדה | סוּג | תיאור |
---|---|---|
params | חפץ | פרמטרים של תצורה חקלאית. |
backends | אובייקט [] | שרתים אמיתיים שנוצרו בחווה זו ובתצורה שלה. |
אובייקט פרמטרים עבור חוות datalink:
שדה | סוּג | תיאור |
---|---|---|
אַלגוֹרִיתְם | מחרוזת | סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: מִשׁקָל, האיזון מפיץ בין כל backends זמין נתון backends תשלום נוסף עם משקל גבוה יותר ב להפיץ או פריו, אשר שולח את כל החיבורים אל backend עם ערך קטין של עדיפות. |
מצב | מחרוזת | מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא מעלה את כל backends הם בלתי מושגת; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; up, החווה היא מעלה את כל backends הם עובדים בהצלחה. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
אובייקט backend עבור חוות datalink:
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה ייחודי עבור backend בחווה. |
ip | מחרוזת | IP של backend, שבו השירות האמיתי הוא מקשיב. |
ממשק | מחרוזת | זהו ממשק הרשת המקומית שבו backend מחובר. |
עדיפות | מספר | זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הוא ישמש כאשר אַלגוֹרִיתְם שדה הוא תצורה כמו פריו ועדיפות נמוכה תהיה העדפה |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; לא מוגדר, מצב backend לא נבדק. |
מִשׁקָל | מספר | זהו ערך המשקל עבור השרת האמיתי הנוכחי. זה ישמש מתי אַלגוֹרִיתְם שדה הוא תצורה כמו משקל. |
יצירת חוות חדשה
יצירת חוות חדשה
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"dlink", "vip":"192.168.100.241", "profile":"datalink" }'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms
POST /farms
צור חוות datalink חדשה.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
שם החווה | מחרוזת | שם החווה, מזהה ייחודי. | נָכוֹן |
פרופיל | מחרוזת | הפרופיל של החווה שנוצרה. עבור חוות datalink הוא DataLink | נָכוֹן |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Creating farm 'dlink'",
"params" : {
"farmname" : "dlink",
"interface" : "eth0",
"profile" : "datalink",
"vip" : "192.168.100.241"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי משק חקלאי
שינוי משק חקלאי
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"newfarmname":"dlink2", "vip":"192.168.100.199","algorithm":"weight"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/dlink
PUT /farms/<farmname>
שינוי התצורה של חוות datalink.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
newfarmname | מחרוזת | שם החווה החדש. יש לעצור את החווה. |
אַלגוֹרִיתְם | מחרוזת | סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: מִשׁקָל, האיזון מפיץ בין כל backends זמין נתון backends תשלום נוסף עם משקל גבוה יותר ב להפיץ או פריו, אשר שולח את כל החיבורים אל backend עם ערך קטין של עדיפות. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
דוגמה לתגובה:
{
"description" : "Modify farm dlink",
"params" : {
"algorithm" : "weight",
"vip" : "192.168.100.199",
"newfarmname" : "dlink2"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
Datalink - Backends
Backends בחוות datalink הם השערים דרך ניתוב השירות. השירות יהיה multiplexor בין השערים, וחלקם אינו זמין, השירות משתמש אחרים (ים).
רשימת backends
רשימת backends
דוגמה לבקשה:
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/dlink/backends
GET /farms/<farmname>/backends
קבל את רשימת backends בשירות.
דוגמה לתגובה:
[
{
"id" : 6,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"status" : "undefined",
"weight" : 2
},
{
"id" : 7,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"status" : "undefined",
"weight" : 1
}
]
פרמטרי תגובה
שיחה זו מחזירה מערך אובייקט backend עם הפרמטרים השוררים.
שדה | סוּג | תיאור |
---|---|---|
id | מספר | מזהה ייחודי עבור backend בחווה. מזהה זה נוצר על ידי המערכת. |
ממשק | מחרוזת | זהו ממשק הרשת המקומית שבו backend מחובר. |
ip | מחרוזת | IP של backend, שבו השירות האמיתי הוא מקשיב. |
עדיפות | מספר | זהו ערך העדיפות עבור ה- backend הנוכחי. הוא ישמש כאשר אַלגוֹרִיתְם שדה הוא תצורה כמו פריו ועדיפות נמוכה תהיה העדפה. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; לא מוגדר, מצב backend לא נבדק. |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. זה ישמש מתי אַלגוֹרִיתְם שדה הוא תצורה כמו משקל. |
צור Backend חדש
צור Backend חדש
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.10","interface":"eth0","priority":2,"weight":2}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/dlink/backends
POST /farms/<farmname>/backends
יצירת backend חדש בחוות datalink נתון.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
ip | מחרוזת | IP של backend, שבו השירות האמיתי הוא מקשיב. | נָכוֹן |
ממשק | מחרוזת | זהו ממשק הרשת המקומית שבו backend מחובר. | נָכוֹן |
עדיפות | מספר | זה ערך העדיפות עבור השרת האמיתי הנוכחי. זה יהיה בשימוש כאשר אַלגוֹרִיתְם שדה הוא תצורה כמו פריו ועדיפות נמוכה תהיה העדפה. ערך ברירת המחדל הוא 1. | |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. זה ישמש מתי אַלגוֹרִיתְם שדה הוא תצורה כמו משקל. ערך ברירת המחדל הוא 1. |
דוגמה לתגובה:
{
"description" : "New farm backend",
"message" : "Backend added",
"params" : {
"id" : 6,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"weight" : 2
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי Backend
שינוי Backend
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.102.50","interface":"eth0", "weight":1,"timeout":1}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/datalink/backends/2
PUT /farms/<farmname>/backends/<id>
שינוי הפרמטרים של backend בשירות של חוות datalink. id הוא מזהה ייחודי backend.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
מחרוזת | ip | IP של backend, שבו השירות האמיתי הוא מקשיב. |
ממשק | מחרוזת | זהו ממשק הרשת המקומית שבו backend מחובר. |
פסק זמן | מספר | זה פסק זמן backend להגיב על בקשה מסוימת. |
מִשׁקָל | מספר | זה ערך המשקל עבור ה- backend הנוכחי. |
דוגמה לתגובה:
{
"description" : "Modify backend",
"message" : "Backend modified",
"params" : {
"interface" : "eth0",
"ip" : "192.168.102.50",
"timeout" : 1,
"weight" : 1
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
מחק backend
מחק backend
דוגמה לבקשה:
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/dlink/backends/4
DELETE /farms/<farmname>/backends/<id>
מחק backend נתון בשירות של חוות datalink. id הוא מזהה ייחודי backend.
דוגמה לתגובה:
{
"description" : "Delete backend",
"message" : "Backend removed",
"success" : "true"
}
רשת
Zevenet יכול לעבוד עם סוגים שונים של ממשקי רשת.
בסעיף זה ניתן לרשום, ליצור, להגדיר, למחוק ולהגדיר פעולה ב- NIC, VLAN וממשקים וירטואליים.
nic: או כרטיס ממשק רשת, זהו רכיב חומרה של המחשב ואת סוג זה של ממשק הוא הבסיס עבור סוג של ממשקים הבאים ניתן להגדיר ומנוהל בזובנט.
vlan: או כרטיס LAN וירטואלי הוא סוג או ממשק רשת המספקים שירותי פילוח רשת. יותר vlan אחד ניתן ליצור באמצעות ממשק nic.
וירטואלי: זה סוג של ממשק ניתן ליצור מעל כל סוג של ממשק המתואר לעיל. סוג זה של ממשק צריך לשמש עבור חוות והוא נדרש כי ממשק וירטואלי מוגדר באותה רשת משנה מאשר ההורה.
רשימת כל הממשקים
רשימת כל הממשקים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic
GET /interfaces
קבל רשימה של ממשקים במערכת עם התצורה שלהם.
דוגמה לתגובה:
{
"description" : "List interfaces",
"interfaces" : [
{
"gateway" : "192.168.100.5",
"has_vlan" : "true",
"ip" : "192.168.100.241",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "nic"
},
{
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"status" : "down",
"type" : "vlan"
},
{
"gateway" : "",
"ip" : "192.168.100.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virt",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "virtual"
},
{
"gateway" : "192.168.100.5",
"has_vlan" : "false",
"ip" : "192.168.100.102",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "nic"
}
]
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם מערך אובייקט ממשק.
אובייקט ממשק:
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. IP חייב להיות באותו קטע רשת מאשר ממשק האב בממשק וירטואלי. |
has_vlan | מחרוזת | שדה זה מראה אם ממשק זה הוא הורה לממשק VLAN. שדה זה מיועד רק עבור ממשקי NIC. |
מסכת רשת | מחרוזת | Netmask של הממשק. ערך זה לא יכול להיות שונה בממשקים וירטואליים, הוא עובר בירושה מן inteface האב. |
שער כניסה | מחרוזת | שער של הממשק. ערך זה לא יכול להיות שונה בממשקים וירטואליים, הוא עובר בירושה מן inteface האב. |
מק | מחרוזת | MAC של הממשק. ערך זה עובר בירושה מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. |
מצב | מחרוזת | הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות. |
סוג | מחרוזת | הממשקים השונים הם: nic, vlan or וירטואלי. |
אחזר שער ברירת מחדל
אחזר שער ברירת מחדל
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/interfaces/gateway
GET /interfaces/gateway
שער ברירת המחדל הוא הצומת שבה נשלח כל תעבורת היעד שאינה ניתנת להשגה מקומית מכל ממשק בממשק העומס.
קבל את הפרמטרים של ממשק שער ברירת המחדל.
דוגמה לתגובה:
{
"description" : "Default gateway",
"params" : {
"address" : "192.168.100.5",
"interface" : "eth0"
}
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
כתובת | מחרוזת | זהו ה- IP של השער. |
ממשק | מחרוזת | שם הממשק עבור השער. |
שינוי שער ברירת המחדל
שינוי שער ברירת המחדל
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"interface":"eth0","address":"192.168.100.5"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces
PUT /interfaces/gateway
שינוי התצורה של ממשק השער.
דוגמה לתגובה:
{
"description" : "Modify default gateway",
"message" : "The default gateway has been changed successfully",
"success" : "true"
}
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
כתובת | מחרוזת | זהו ה- IP של השער. |
ממשק | מחרוזת | שם הממשק עבור השער. |
מחק את תצורת השער
DELETE /interfaces/gateway
מחק את התצורה של תצורת ברירת המחדל של שער השער.
אזהרה: אם השער הוא disconfigured, Zevenet הוא לא הולך להיות נגיש מתוך קטע רשת חיצוני.
מחק את תצורת השער
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/gateway
הודעת תגובה
אם השער אינו מוגדר מאותו קטע רשת, הודעה זו תופיע, אחרת החיבור יפסיד.
דוגמה לתגובה:
{
"description" : "Remove default gateway",
"message" : "The default gateway has been deleted successfully",
"params" : {
"address" : null,
"interface" : null
}
}
רשת - ממשקי NIC
ממשקי NIC הם הממשקים הפיזיים המחוברים לאיזון העומס שלך ב- Zevenet.
המערכת מזהה ממשקים חדשים באופן אוטומטי לאחר שהם מחוברים.
באמצעות ממשקי NIC כהורים, סוג אחר של ממשקים עם מאפיינים שונים ניתן ליצור. הממשקים הזמינים הם: VLAN ו וירטואלי.
רשימת ממשקי NIC
GET /interfaces/nic
קבל את כל הפרמטרים של ממשקי NIC.
רשימת ממשקי NIC
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic
דוגמה לתגובה:
{
"description" : "List NIC interfaces",
"interfaces" : [
{
"gateway" : "192.168.100.5",
"has_vlan" : "true",
"ip" : "192.168.100.241",
"is_slave" : "false",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0",
"netmask" : "255.255.255.0",
"status" : "up"
},
{
"gateway" : "192.168.100.5",
"has_vlan" : "false",
"ip" : "192.168.100.102",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up"
}
]
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם מערך של אובייקטי ממשק NIC.
אובייקט ממשק NIC:
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. |
has_vlan | מחרוזת | שדה זה מראה אם ממשק זה הוא הורה לממשק VLAN. שדה זה מיועד רק עבור ממשקי NIC. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות לפלח רשת אחר. |
מק | מחרוזת | קישור שכבת מזהה ייחודי. זה לא ניתן לשינוי. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי לממשק. |
מצב | מחרוזת | הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות. |
אחזור ממשק NIC
אחזור ממשק NIC
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic/eth1
GET /interfaces/nic/<name>
קבל את כל הפרמטרים של ממשק NIC. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Show NIC interface",
"interface" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up"
}
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות לפלח רשת אחר. |
מק | מחרוזת | קישור שכבת מזהה ייחודי. זה לא ניתן לשינוי. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי לממשק. |
מצב | מחרוזת | הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות. |
שינוי ממשק NIC
שינוי ממשק NIC
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.102","netmask":"255.255.255.0","gateway":"192.168.100.5"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic/eth1
PUT /interfaces/nic/<name>
שינוי הפרמטרים של ממשק NIC. שם הוא מזהה ייחודי של ממשק.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. |
דוגמה לתגובה:
{
"description" : "Configure nic interface",
"params" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"netmask" : "255.255.255.0"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
מחיקת תצורת NIC
מחיקת תצורת NIC
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic/eth3
DELETE /interfaces/nic/<name>
מחק את התצורה עבור ממשק NIC. לאחר פעולה זו, הממשק יהיה חסר תועלת, ומוכן להיות מוגדר שוב. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Delete nic interface",
"message" : "The configuration for the network interface eth3 has been deleted.",
"success" : "true"
}
הגדר פעולה ממשק NIC
הגדר פעולה ממשק NIC
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/nic/eth1/actions
POST /interfaces/nic/<name>/actions
החל פעולה על ממשק NIC. שיחה זו מאפשרת להפעיל או להשבית ממשק רשת.
שם הוא מזהה ייחודי של ממשק.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פעולה | מחרוזת | פעולה כדי להחיל על הממשק. הערכים הזמינים הם: up, לאפשר לממשק ולהכין אותו לשימוש; מטה, להשבית את הממשק כדי לא לקבל או לא לשלוח מנות. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Action on nic interface",
"params" : {
"action" : "up"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
רשת - ממשקי VLAN
ממשק VLAN מאפשר ממשק NIC עובד ברשת אחרת, כך IP, שער כניסה ו מסכת רשת שדות יכולים להיות שונים של ממשק האב. ממשק VLAN יורש את כתובת ה- MAC מממשק האב שלו.
השדה ממשקי VLAN שם יופיע עם תו נקודה. "" שישמש ליצירת תג מזהה עבור ממשק VLAN.
רשימת ממשקי VLAN
רשימת ממשקי VLAN
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan
GET /interfaces/vlan
קבל את כל הפרמטרים של ממשקי VLAN.
דוגמה לתגובה:
{
"description" : "List VLAN interfaces",
"interfaces" : [
{
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "down"
}
]
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם מערך אובייקט ממשק VLAN.
הפרמטרים של VLAN הם:
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. זה יכול להיות שונה ל- IP inteface ה- IP. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. |
מק | מחרוזת | MAC של הממשק. ערך זה עובר בירושה מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי שם ממשק אב, תו נקודה "." ומספר עבור ממשק רשת vlan או תג vlan. |
הורה | מחרוזת | זהו ממשק המשמש ליצירת זה. |
מצב | מחרוזת | הערכים יכולים להיות up הממשק יכול לקבל מנות, מטה הממשק אינו יכול לקבל מנות. |
לאחזר ממשק VLAN
לאחזר ממשק VLAN
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan/eth0.1
GET /interfaces/vlan/<name>
קבל את כל הפרמטרים של ממשק VLAN. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Show VLAN interface",
"interface" : {
"gateway" : "192.168.131.1",
"ip" : "192.168.131.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"status" : "up"
}
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. |
מק | מחרוזת | MAC של הממשק. ערך זה עובר בירושה מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי שם ממשק אב, תו נקודה "." ומספר לממשק רשת vlan. |
מצב | מחרוזת | הערכים יכולים להיות up הממשק יכול לקבל מנות, מטה הממשק אינו יכול לקבל מנות. |
צור ממשק VLAN
צור ממשק VLAN
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.120.120","netmask":"255.255.255.0","gateway":"192.168.120.1", "name":"eth0.1"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan
POST /interfaces/vlan
יצירת ממשק VLAN מממשק NIC. ממשק VLAN החדש יחלק MAC, אם כי הפרמטרים הבאים של הרשת חייבים להיות שונים: ip, והפעולות הבאות עשויות להשתנות: שער כניסה, מסכת רשת.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
ip | מחרוזת | IP של הממשק. זה חייב להיות שונה ל- IP inteface ה- IP. | נָכוֹן |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. | נָכוֹן |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. | נָכוֹן |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי שם ממשק אב, תו נקודה "." ומספר לממשק רשת vlan. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Add a vlan interface",
"params" : {
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : null,
"name" : "eth0.1",
"netmask" : "255.255.255.0"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי ממשק VLAN
שינוי ממשק VLAN
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155","netmask":"255.255.255.0","gateway":"192.168.131.1"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan/eth0.1
PUT /interfaces/vlan/<name>
שינוי הפרמטרים של ממשק VLAN. שם הוא מזהה ייחודי של ממשק.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. זה יכול להיות שונה ל- IP inteface ה- IP. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. |
דוגמה לתגובה:
{
"description" : "Modify VLAN interface",
"params" : {
"gateway" : "192.168.131.1",
"ip" : "192.168.131.155",
"netmask" : "255.255.255.0"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
מחק ממשק VLAN
מחק ממשק VLAN
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan/eth0.1
DELETE /interfaces/vlan/<name>
מחק ממשק VLAN. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Delete VLAN interface",
"message" : "The VLAN interface eth0.1 has been deleted.",
"success" : "true"
}
הגדרת פעולה ממשק VLAN
הגדרת פעולה ממשק VLAN
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/vlan/eth0.1/actions
POST /interfaces/vlan/<name>/actions
החל פעולה על ממשק VLAN. שיחה זו מאפשרת להפעיל או להשבית ממשק רשת.
שם הוא שם ייחודי מזהה.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פעולה | מחרוזת | פעולה כדי להחיל על הממשק. הערכים הזמינים הם: up, לאפשר לממשק ולהכין אותו לשימוש; מטה, להשבית את הממשק כדי לא לקבל או לא לשלוח מנות. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Action on vlan interface",
"params" : {
"action" : "down"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
רשת - ממשקים וירטואליים
ממשקי רשת מאפשרים למשתמשים ממשק רשת אחר באותו פלח רשת מאשר האב, כך שממשקים וירטואליים תמיד יורשים את תצורת הרשת מהורה. הפרמטר השונה יהיה ip. ממשק וירטואלי ניתן ליצור מ NIC או VLAN. יצירת ממשק וירטואלי חדש תופיע בשדה עם תו קולון ":" אשר ישמש ליצירת זיהוי עבור הממשק הווירטואלי.
רשימת ממשקים וירטואליים
רשימת ממשקים וירטואליים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual
GET /interfaces/virtual
קבל את כל הפרמטרים של ממשקים וירטואליים.
דוגמה לתגובה:
{
"description" : "List virtual interfaces",
"interfaces" : [
{
"gateway" : "",
"ip" : "192.168.100.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virt",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "up"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "down"
}
]
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. הוא יורש מממשק האב. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. הוא יורש מממשק האב. |
מק | מחרוזת | MAC של הממשק. הוא יורש מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי ממשק אב, תו נקודתיים ":" והשם עבור ממשק הרשת הווירטואלית, תווים אלפאנומריים מותרים. |
הורה | מחרוזת | זהו ממשק המשמש ליצירת זה. |
מצב | מחרוזת | הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות. |
לאחזר ממשק וירטואלי
לאחזר ממשק וירטואלי
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual/eth0:virtiface
GET /interfaces/virtual/<name>
קבל את כל הפרמטרים של ממשק וירטואלי. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Show virtual interface",
"interface" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0",
"status" : "down"
}
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. הוא יורש מממשק האב. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות של פלח רשת אחר. הוא יורש מממשק האב. |
מק | מחרוזת | MAC של הממשק. הוא יורש מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי ממשק אב, תו נקודתיים ":" ומחרוזת אלפא-נומרית עבור ממשק הרשת הווירטואלית. |
מצב | מחרוזת | הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות. |
יצירת ממשק וירטואלי
יצירת ממשק וירטואלי
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.41", "name":"eth0:virtiface"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual
POST /interfaces/virtual
יצירת ממשק וירטואלי.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
ip | מחרוזת | IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב. | נָכוֹן |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי ממשק אב, תו נקודתיים ":" ומחרוזת אלפא-נומרית עבור ממשק הרשת הווירטואלית. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Add a virtual interface",
"params" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0"
}
}
פרמטרים של תגובה
התגובה תהיה json עם תצורת הממשק. ראה דוגמה לתגובה לקבלת מידע נוסף.
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב. |
מסכת רשת | מחרוזת | הגדר את קטע הרשת שבו פועל הממשק. הוא יורש מממשק האב. |
שער כניסה | מחרוזת | IP שימש לשלוח מנות לפלח רשת אחר. הוא יורש מממשק האב. |
מק | מחרוזת | MAC של הממשק. הוא יורש מממשק האב. |
שם | מחרוזת | שם הממשק. הוא משמש כמזהה ייחודי. שם זה הוא שרשרת שנוצרה על ידי ממשק אב, תו נקודתיים ":" ומחרוזת אלפא-מספרים עבור ממשק הרשת הווירטואלית. |
שינוי ממשק וירטואלי
שינוי ממשק וירטואלי
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual/eth0:virtiface
PUT /interfaces/virtual/<name>
שינוי הפרמטרים של ממשק וירטואלי. שם הוא מזהה ייחודי של ממשק.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
ip | מחרוזת | IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב. |
דוגמה לתגובה:
{
"description" : "Modify virtual interface",
"params" : {
"ip" : "192.168.100.10"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
מחיקת ממשק וירטואלי
מחיקת ממשק וירטואלי
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual/eth0:virtiface
DELETE /interfaces/virtual/<name>
מחק ממשקים וירטואליים. שם הוא מזהה ייחודי של ממשק.
דוגמה לתגובה:
{
"description" : "Delete virtual interface",
"message" : "The virtual interface eth0:virtiface has been deleted.",
"success" : "true"
}
הגדרת פעולה ממשק וירטואלי
הגדרת פעולה ממשק וירטואלי
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/interfaces/virtual/eth0:virtiface/actions
POST /interfaces/virtual/<name>/actions
החל פעולה על ממשק וירטואלי. שיחה זו מאפשרת להפעיל או להשבית ממשק רשת.
שם הוא מזהה ייחודי של ממשק.
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
פעולה | מחרוזת | פעולה כדי להחיל על הממשק. הערכים הזמינים הם: up, לאפשר לממשק ולהכין אותו לשימוש; מטה, להשבית את הממשק כדי לא לקבל או לא לשלוח מנות. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "Action on virtual interface",
"params" : {
"action" : "down"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
ניטור - סטטיסטיקה
הצג מידע אודות מערכת ומשקים. מידע זה יהיה שימושי כדי לפקח על מצב איזון עומס Zevenet.
הצג נתונים סטטיסטיים של המערכת
הצג נתונים סטטיסטיים של המערכת
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/stats
GET /stats
קבל נתונים סטטיסטיים גלובליים של המערכת.
דוגמה לתגובה:
{
"description" : "System stats",
"params" : {
"cpu" : {
"cores" : 2,
"idle" : 94.42,
"iowait" : 0,
"irq" : 0,
"nice" : 0,
"softirq" : 0,
"sys" : 2.54,
"usage" : 5.58,
"user" : 3.05
},
"date" : "Fri Jan 27 11:40:32 2017",
"hostname" : "api3",
"load" : {
"Last_1" : 1.17,
"Last_15" : 0.36,
"Last_5" : 0.6
},
"memory" : {
"Buffers" : 21.68,
"Cached" : 147.95,
"MemFree" : 348.06,
"MemTotal" : 2005.01,
"MemUsed" : 1656.95,
"SwapCached" : 2.67,
"SwapFree" : 614.38,
"SwapTotal" : 672,
"SwapUsed" : 57.62
},
"network" : {
"eth0 in in" : 2702.29,
"eth0 out out" : 50701.95,
"eth0.1 in in" : 0,
"eth0.1 out out" : 0,
"eth1 in in" : 234.72,
"eth1 out out" : 0,
}
}
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
מעבד | חפץ | נתונים סטטיסטיים של המעבד. |
נתונים | מחרוזת | תאריך מערכת. |
המארח | מחרוזת | שם המארח. |
לִטעוֹן | חפץ | נתונים סטטיסטיים של עומס הליבה. |
זיכרון | חפץ | נתונים סטטיסטיים של זיכרון משומש. |
רשת | חפץ | נתונים סטטיסטיים של תעבורת הרשת. |
אובייקט CPU:
שדה | סוּג | תיאור |
---|---|---|
ליבות | מספר | מספר הליבות במעבד. |
להתבטל | מספר | CPU לא להשתמש על ידי כל תוכנית. |
כן | מספר | מעבד המשמש בתהליך קלט או פלט. |
Irq | מספר | מעבד המשמש interropcions חומרה. |
נחמד | מספר | עדיפות תזמון CPU. |
רך | מספר | CPU המשמשים interrrupcions תוכנה. |
sys | מספר | CPU המשמש את המערכת. |
שימוש | מספר | סה"כ מעבד משומש. |
המשתמש | מספר | CPU המשמש את המשתמש. |
טען אובייקט:
שדה | סוּג | תיאור |
---|---|---|
Last_1 | מספר | טען מערכת porcentage ברגע האחרון. |
Last_5 | מספר | טען מערכת porcentage לפני 5 דקות. |
Last_15 | מספר | טען מערכת porcentage לפני חמש עשרה דקות. |
אובייקט זיכרון.
שדה | סוּג | תיאור |
---|---|---|
חוצצים | מספר | זהו הזיכרון המשמש את המאגרים. סכום זה מצוין ב- Mb. |
שמור במטמון | מספר | זה הזיכרון הכולל במטמון על ידי המערכת. סכום זה מצוין ב- Mb. |
ממפיס | מספר | זה הזיכרון הפנוי הכולל שלא שמור במטמון על ידי המערכת. סכום זה מצוין ב- Mb. |
MemTotal | מספר | זה זיכרון RAM הכולל על המערכת. סכום זה מצוין ב- Mb. |
נמחק | מספר | זה הזיכרון המשמש את המערכת. סכום זה מצוין ב- Mb. |
SwapCached | מספר | זה זיכרון המטמון הכולל שמור. |
SwapFree | מספר | זה הזיכרון הפנוי הכולל שלא שמור במטמון על ידי המערכת. סכום זה מצוין ב- Mb. |
SwapTotal | מספר | זה סה"כ זיכרון החלפה שמור. |
הוחלף | מספר | זה להחליף את הזיכרון בשימוש על ידי המערכת, על מערכות אופטימלי צריך להיות 0. |
אובייקט רשת:
שדה | סוּג | תיאור |
---|---|---|
בתוך בתוך | מספר | הזן תנועה עבור זה ממשק. |
לצאת החוצה | מספר | תנועה פלט עבור זה ממשק. |
הצג נתונים סטטיסטיים ברשת
הצג נתונים סטטיסטיים ברשת
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/stats/system/network
GET /stats/system/network
קבל סיכום של סך קלט ותשומת פלט דרך ממשק רשת.
דוגמה לתגובה:
{
"description" : "Network interfaces usage",
"params" : {
"date" : "Fri Jan 27 11:58:05 2017",
"hostname" : "api3",
"interfaces" : [
{
"in" : "2703.88",
"interface" : "eth0",
"out" : "50917.65"
},
{
"in" : "815.69",
"interface" : "eth0.1",
"out" : "4300.38"
}
]
}
}
פרמטרים של תגובה
התגובה תהיה JSON עם מפתח params אשר ערך הוא אובייקט עם המפתחות followeing:
שדה | סוּג | תיאור |
---|---|---|
נתונים | מחרוזת | תאריך מערכת. |
המארח | מחרוזת | שם המארח. |
ממשקים | אובייקט [] | נתונים סטטיסטיים של תעבורת הרשת. |
ממשקי אובייקט
שדה | סוּג | תיאור |
---|---|---|
in | מחרוזת | סה"כ תעבורת קלט ב- MB. |
ממשק | מחרוזת | שם הממשק. |
הַחוּצָה | מחרוזת | סך כל התפוקה. |
הצג נתונים סטטיסטיים של חוות
הצג נתונים סטטיסטיים של חוות
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/stats/farms
GET /stats/farms
קבל סיכום של חיבורים ותצורה עבור כל החוות במערכת.
דוגמה לתגובה:
{
"description" : "List all farms stats",
"farms" : [
{
"established" : 0,
"farmname" : "testHttps",
"pending" : 0,
"profile" : "https",
"status" : "up",
"vip" : "192.168.101.20",
"vport" : "120"
},
{
"established" : 0,
"farmname" : "httpFarm",
"pending" : 0,
"profile" : "http",
"status" : "up",
"vip" : "192.168.10.31",
"vport" : "8080"
},
{
"established" : 0,
"farmname" : "testDL",
"pending" : 0,
"profile" : "datalink",
"status" : "up",
"vip" : "192.168.102.72",
"vport" : "eth1"
},
{
"established" : 0,
"farmname" : "testL4",
"pending" : 0,
"profile" : "l4xnat",
"status" : "up",
"vip" : "192.168.10.31",
"vport" : "30"
}
]
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
נוסד | מספר | סך כל הקשרים הקיימים. |
שם החווה | מחרוזת | שם החווה, מזהה ייחודי. |
תלוי ועומד | מספר | מספר החיבורים הממתינים. |
פרופיל | מחרוזת | סוג החווה. הערכים האפשריים הם: DataLink, l4xnat, http or https. כל פרופיל מוגדר בקטע שלו. |
מצב | מחרוזת | מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה. |
החברים | מחרוזת | IP של החווה, שבו השירות וירטואלי מקשיב. |
גווניה | מחרוזת | נמל של החווה, שבו השירות וירטואלי מקשיב. |
הצג נתונים סטטיסטיים בחווה
הצג נתונים סטטיסטיים בחווה
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/stats/farms/httpFarm
GET /stats/farms/<farmname>
מציג את מצב החווה הנוכחי, מצב backend שלהם וחיבורים. כל חוות תהיה תגובה עם אובייקט אחר, בהתאם לפרופיל.
דוגמת תגובה עבור חוות HTTP:
{
"backends" : [
{
"established" : 0,
"id" : 0,
"ip" : "192.168.0.168",
"pending" : 0,
"port" : 80,
"service" : "srv1",
"status" : "up"
}
],
"description" : "List farm stats",
"sessions" : [
{
"client" : "0",
"id" : "0",
"service" : "srv1",
"session" : "192.168.0.186"
}
]
}
פרמטרי תגובה בחוות HTTP
שדה | סוּג | תיאור |
---|---|---|
backends | אובייקט [] | הצג מידע על backends. |
הפעלות | אובייקט [] | הצג מידע על פעילויות באתר. |
אובייקט Backend
שדה | סוּג | תיאור |
---|---|---|
נוסד | מספר | סך כל החיבורים שנקבעו. |
id | מספר | מזהה ייחודי של Backend. |
ip | מחרוזת | IP שבו השירות האמיתי מקשיב. |
תלוי ועומד | מספר | מספר החיבורים הממתינים. |
נמל | מספר | נמל שבו השירות האמיתי מקשיב. |
שרות | מחרוזת | שם השירות משמש כמזהה ייחודי. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
אובייקט מושב
שדה | סוּג | תיאור |
---|---|---|
לקוחות | מחרוזת | מזהה ייחודי של לקוח. |
id | מחרוזת | מזהה ייחודי של Backend שהוקצה ללקוח. |
שרות | מחרוזת | מזהה ייחודי של שירות שהוקצה ללקוח. |
מושב | מחרוזת | מזהה ייחודי של פעילות באתר. ערך זה תלוי בסוג ההתמדה. |
דוגמת תגובה עבור חוות L4xNAT:
{
"backends" : [
{
"established" : 5,
"id" : 1,
"ip" : "192.168.5.40",
"pending" : 0,
"port" : "8080",
"status" : "maintenance"
},
{
"established" : null,
"id" : 3,
"ip" : "192.5.1.1",
"pending" : 0,
"port" : "787",
"status" : "down"
},
{
"established" : null,
"id" : 5,
"ip" : "192.168.5.100",
"pending" : 0,
"port" : "8080",
"status" : "up"
}
],
"description" : "List farm stats"
}
פרמטרי תגובה בחוות L4xNAT
התגובה תהיה JSON עם מפתח backends ואת הערך מערך אובייקט עם הפרמטרים הבאים.
אובייקט Backend:
שדה | סוּג | תיאור |
---|---|---|
נוסד | מספר | סך כל הקשרים הקיימים. |
id | מספר | מזהה ייחודי של Backend. |
ip | מחרוזת | IP שבו השירות האמיתי מקשיב. |
תלוי ועומד | מספר | מספר החיבורים הממתינים. |
נמל | מספר | נמל שבו השירות האמיתי מקשיב. |
מצב | מחרוזת | מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק. |
פרמטרי תגובה בחוות datalink
הנתונים הסטטיסטיים של Datalink אינם זמינים בפועל.
ניטור - גרפים
סעיף זה שימושי כדי לפקח על המערכת הפנימית איזון עומס כדי לזהות בעיות באמצעות הפרמטרים של השימוש ב- CPU, זיכרון החלפה, זיכרון RAM, כל ממשקי Nework מוגדר, לטעון אחסון דיסק קשיח.
כמו כן, תוכל לגשת להיסטוריה השבועית, העשירה והשנתית.
גרפים עם מידע הם הגיבו בפורמט base64.
רשימת תרשימים זמינים
רשימת תרשימים זמינים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs
GET /graphs
הצג אובייקט עם כל הגרפים הזמינים במערכת. זה מראה את הבקשה אפשרית שניתן לעשות.
דוגמה לתגובה:
{
"description" : "These are the possible graphs, you`ll be able to access to the daily, weekly, monthly or yearly graph",
"farms" : [
"l4farm",
"newfarm",
"nwl4farm",
"httpweb"
],
"interfaces" : [
"eth0.1",
"eth1",
"eth0"
],
"system" : [
"cpu",
"load",
"ram",
"swap",
{
"disk" : [
"root/",
"root/boot",
"root/usr/local/zenloadbalancer/config",
"root/var/log"
]
}
]
}
פרמטרים של תגובה
התגובה תהיה JSON שלושה סוגים של גרפים, חוות, ממשקים ו מערכת.
שדה | סוּג | תיאור |
---|---|---|
חוות | מחרוזת [] | רשימת חוות חקלאיות availables. |
ממשקים | מחרוזת [] | רשימה של ממשקים גרפים availables. |
מערכת | אובייקט [] | רשימה של גרפים מערכת availables. במערך יש אובייקט עם מערך שבו הוא מציין נקודות דיסק דיסק. |
אובייקט מערכת:
אובייקט מערכת מכיל רשימת מערך הקשורה למערכת, ואובייקט דיסק עם הפורמט הבא.
שדה | סוּג | תיאור |
---|---|---|
דיסק | מחרוזת [] | הערכים של מערך זה הם כולם קיימים נקודות במערכת, לכל אחד יש גרפים זמינים. |
הצג תרשימים
הצג תרשימים
בקש דוגמה לחווה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/farms/httpweb
בקש דוגמה עבור ממשק:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/interfaces/eth0
בקש דוגמה לדיסק:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/system/disk/root/boot
GET /graphs/<graph>
הערכים הזמינים עבור גרף הם:
ערך | תיאור |
---|---|
farms/<farmname> |
שם החווה, מזהה ייחודי לחווה. |
interfaces/<interface> |
ממשק, מזהה ייחודי של ממשק. |
system/<system> |
מערכת, גרפים אפשריים של המערכת הם: מעבד, לִטעוֹן, RAM or להחליף. |
system/disk/<mount point> |
נקודת הר, הוא ערך של דיסק אובייקט, הוחזר בשיחת 'GET / graphs'. |
דוגמה לתגובה:
{
"description" : "Get cpu graphs",
"graphs" : [
{
"frequency" : "daily",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "weekly",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "monthly",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "yearly",
"graph" : "PNG IN BASE 64"
}
]
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
תדר | מחרוזת | תקופת הזמן המשמשת ליצירת התרשים. הערכים האפשריים הם: יומי, שבועי, אחת לחודש or שְׁנָתִי. |
גרפים | מחרוזת | גרף בפורמט 64 בסיס. |
הצג תרשים תדירות
הצג תרשים תדירות
בקש דוגמה לחווה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/farms/httpweb/daily
בקש דוגמה עבור ממשק:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/interfaces/eth0/monthly
בקש דוגמה לדיסק:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/graphs/system/disk/root/boot/yearly
GET /graphs/<graph>/<frequency>
הערכים הזמינים עבור גרף הם:
ערך | תיאור |
---|---|
farms/<farmname> |
שם החווה, מזהה ייחודי לחווה. |
interfaces/<interface> |
ממשק, מזהה ייחודי של ממשק. |
system/<system> |
מערכת, גרפים אפשריים של המערכת הם: מעבד, לִטעוֹן, RAM or להחליף. |
system/disk/<mount point> |
נקודת הר, הוא ערך של דיסק אובייקט, הוחזר בשיחת 'GET / graphs'. |
הערכים הזמינים עבור תדר הם:
שדה | סוּג | תיאור |
---|---|---|
תדר | מחרוזת | תקופת הזמן המשמשת ליצירת התרשים. הערכים האפשריים הם: יומי, שבועי, אחת לחודש or שְׁנָתִי. |
דוגמה לתגובה:
{
"description" : "Get farm graphs",
"graph" : "PNG IN BASE 64"
}
פרמטרים של תגובה
שדה | סוּג | תיאור |
---|---|---|
גרפים | מחרוזת | גרף בפורמט 64 בסיס. |
מערכת
אפשרויות מערכת מציעים לך את האפשרות של התאמה אישית של השירותים הפועלים באיזון ואת הפרמטרים הגלובליים.
הצג גרסה
הצג גרסה
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/version
GET /system/version
הצג מידע על גרסת המוצר.
דוגמה לתגובה:
{
"description" : "Get version",
"params" : {
"appliance_version" : "ZVA 4100, hypervisor: xen",
"hostname" : "DEV5",
"kernel_version" : "3.16.7-ckt20",
"system_date" : "Thu Feb 2 10:34:27 2017",
"zevenet_version" : "5.0"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
גרסה | מחרוזת | גרסה. הצג גם hypervisor אם הוא מכונה וירטואלית. |
המארח | מחרוזת | שם מארח. |
kernel_version | מחרוזת | גרסת לינוקס לינוקס - -. |
תאריך מערכת | מחרוזת | תאריך מערכת. |
zevenet_version | מחרוזת | מהדורת קהילת זבנט. |
הצג DNS
הצג DNS
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/dns
GET /system/dns
הצג את תצורת שירות DNS.
דוגמה לתגובה:
{
"description" : "Get dns",
"params" : {
"primary" : "8.8.8.8",
"secondary" : null
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
יְסוֹדִי | מחרוזת | DNS ראשי מוגדר במערכת. |
משני | מחרוזת | DNS משני מוגדר במערכת. |
שינוי DNS
שינוי DNS
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"primary":"8.8.4.4","secondary":"8.8.8.8"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/dns
POST /system/dns
שינוי תצורת שירות DNS.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
יְסוֹדִי | מחרוזת | DNS ראשי מוגדר במערכת. |
משני | מחרוזת | DNS משני מוגדר במערכת. |
דוגמה לתגובה:
{
"description" : "Post dns",
"params" : {
"primary" : "8.8.4.4",
"secondary" : "8.8.8.8"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
הצג SNMP
הצג SNMP
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/snmp
GET /system/snmp
הצג את תצורת השירות SNMP.
דוגמה לתגובה:
{
"description" : "Get snmp",
"params" : {
"community" : "public",
"ip" : "*",
"port" : "161",
"scope" : "0.0.0.0/0",
"status" : "false"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
קהילה | מחרוזת | שם קהילה. משתמשים בקהילה לקריאה בלבד. |
ip | מחרוזת | ממשק IP שבו פועל שירות SNMP. זה בטוח לשמור את כל הממשקים מופעלת באמצעות דמות *. |
נמל | מחרוזת | יציאה שבה פועל שירות SNMP. |
היקף | מחרוזת | IP או רשת משנה עם גישה (IP / bit). כתובות IP מורשות כדי לקבל שירות SNMPD, במקרה שאתה רוצה לאפשר גישה רק IP אחד בבקשה להשתמש קצת "/ 32". |
מצב | מחרוזת | מצב שירות SNMP. הערכים האפשריים הם: נָכוֹן, השירות פועל; או שקר, השירות מופסק. |
שינוי SNMP
שינוי SNMP
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.241","port":"170","scope":"0.0.0.0/0","status":"true","community":"public"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/snmp
POST /system/snmp
שנה את תצורת השירות SNMP.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
קהילה | מחרוזת | שם קהילה. משתמשים בקהילה לקריאה בלבד. |
ip | מחרוזת | ממשק IP שבו פועל שירות SNMP. זה בטוח לשמור את כל הממשקים מופעלת באמצעות דמות *. |
נמל | מחרוזת | יציאה שבה פועל שירות SNMP. |
היקף | מחרוזת | IP או רשת משנה עם גישה (IP / bit). כתובות IP מורשות כדי לקבל שירות SNMPD, במקרה שאתה רוצה לאפשר גישה רק IP אחד בבקשה להשתמש קצת "/ 32". |
מצב | מחרוזת | מצב שירות SNMP. הערכים האפשריים הם: נָכוֹן, השירות פועל; או שקר, השירות מופסק. |
דוגמה לתגובה:
{
"description" : "Post snmp",
"params" : {
"community" : "public",
"ip" : "192.168.100.241",
"port" : "170",
"scope" : "0.0.0.0/0",
"status" : "true"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
אחזר רישיון
אחזר רישיון
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/license/txt
GET /system/license/<format>
הצג את הרישיון של Zevenet בפורמט. זמין פוּרמָט הערכים הם html or txt.
הצג NTP
הצג NTP
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/ntp
GET /system/ntp
הצג את תצורת שירות NTP.
דוגמה לתגובה:
{
"description" : "Get ntp",
"params" : {
"server" : "pool.ntp.org"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
שרת | מחרוזת | שרת שבו לקוח NTP עושה את הבקשות. |
שינוי NTP
שינוי NTP
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"server":"pool.ntp.org"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/ntp
POST /system/ntp
שינוי תצורת שירות NTP.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
שרת | מחרוזת | שרת שבו לקוח NTP עושה את הבקשות. |
דוגמה לתגובה:
{
"description" : "Post ntp",
"params" : "pool.ntp.org"
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
רשום את כל המשתמשים
רשום את כל המשתמשים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/users
GET /system/users
רשום את המשתמשים הזמינים במערכת.
דוגמה לתגובה:
{
"description" : "Get users",
"params" : [
{
"status" : "true",
"user" : "root"
},
{
"status" : "true",
"user" : "zapi"
}
]
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם מערך של הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
מצב | מחרוזת | סטטוס משתמש. הערכים האפשריים הם: נָכוֹן, המשתמש מופעל; או שלא שקר, המשתמש מושבת. |
המשתמש | מחרוזת | שם משתמש. |
אחזר משתמש zapi
אחזר משתמש zapi
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/users/zapi
GET /system/users/zapi
הצג את תצורת המשתמש zapi. פרמטרים אלה נחוצים לצורך גישה לשירותי זבנט באמצעות זאפי.
דוגמה לתגובה:
{
"description" : "Zapi user configuration.",
"params" : {
"key" : "root",
"status" : "true"
}
}
פרמטרים של תגובה
התגובה תהיה אובייקט JSON עם מערך של הפרמטרים הבאים.
שדה | סוּג | תיאור |
---|---|---|
מפתח | מחרוזת | מפתח כדי לאמת ב zapi. זה הפרמטר ZAPI_KEY המשמש שיחות ל zapi. |
מצב | מחרוזת | Zapi מצב המשתמש. אם הערך שלה הוא נָכוֹן, ניתן להשתמש zapi; או שלא שקר, zapi הוא disactivated ולא ניתן לשלוח את הבקשה. |
שינוי תצורת משתמש zapi
שינוי תצורת משתמש zapi
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"key":"newzapikey","status":"enable","newpassword":"password1234"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/users/zapi
POST /system/users/zapi
שנה את תצורת המשתמש zapi. פרמטרים אלה נחוצים לצורך גישה לשירותי זבנט באמצעות זאפי.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
מפתח | מחרוזת | מפתח כדי לאמת ב zapi. זה הפרמטר ZAPI_KEY המשמש שיחות ל zapi. |
סיסמה חדשה | מחרוזת | סיסמה חדשה עבור המשתמש zapi. |
מצב | מחרוזת | Zapi מצב המשתמש. הערכים האפשריים הם: לאפשר כדי לאפשר למשתמש zapi או להשבית להשבית משתמש zapi - -. אם המשתמש zapi מושבת, לא תוכל לשלוח בקשות. |
דוגמה לתגובה:
{
"description" : "Zapi user settings.",
"message" : "Settings was changed successful.",
"params" : {
"key" : "newzapikey",
"newpassword" : "password1234",
"status" : "enable"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
שינוי סיסמת השורש
שינוי סיסמת השורש
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
{"password":"admin","newpassword":"alwaysisbetterastrongpass"}
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/users/root
POST /system/users/root
שנה את סיסמת הבסיס. משתמש זה משמש לגישה לשירותי zevenet דרך GUI
פרמטרים של בקשה
שדה | סוּג | תיאור | דרוש |
---|---|---|---|
סיסמא | מחרוזת | סיסמת משתמש שורש נוכחי. | נָכוֹן |
סיסמה חדשה | מחרוזת | סיסמה חדשה עבור משתמש root. | נָכוֹן |
דוגמה לתגובה:
{
"description" : "User settings.",
"message" : "Settings was changed succesful.",
"params" : {
"newpassword" : "alwaysisbetterastrongpass",
"password" : "admin"
}
}
פרמטרים של תגובה
התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.
רשימת קובצי יומן
רשימת קובצי יומן
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/logs
GET /system/logs
רשום את קובצי היומן הזמינים.
דוגמה לתגובה:
{
"description" : "Get logs",
"params" : [
{
"date" : "Mon Jan 30 06:25:02 2017",
"file" : "syslog.4.gz"
},
{
"date" : "Tue Jan 31 06:25:03 2017",
"file" : "syslog.3.gz"
},
{
"date" : "Wed Feb 1 06:25:04 2017",
"file" : "syslog.2.gz"
},
{
"date" : "Thu Feb 2 06:25:03 2017",
"file" : "syslog.1"
},
{
"date" : "Sun Jan 29 06:25:03 2017",
"file" : "syslog.5.gz"
},
{
"date" : "Fri Feb 3 04:28:56 2017",
"file" : "syslog"
}
]
}
פרמטרים של תגובה
התגובה תהיה JSON עם מערך של קובץ יומן. הפרמטרים של כל אובייקט הם:
שדה | סוּג | תיאור |
---|---|---|
נתונים | מחרוזת | תאריך השינוי האחרון בקובץ. |
פילה | מחרוזת | שם קובץ של קובצי יומן. הוא משמש כמזהה יומן ייחודי. |
הצג שורות של קובצי יומן
הצג שורות של קובצי יומן
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/logs/kern.log/lines/2
GET /system/logs/<file>/lines/<lines>
רשום מספר שורות של קובץ יומן. פרמטר URI פילה הוא קובץ היומן מקריאה. קווים הוא מספר שורות להראות הסופי.
דוגמה לתגובה:
{
"description" : "Show a log file",
"log" : [
"Aug 28 09:44:00 maq2 kernel: [258451.740173] Netfilter messages via NETLINK v0.30.\n",
"Aug 28 09:44:00 maq2 kernel: [258451.775666] ctnetlink v0.93: registering with nfnetlink.\n"
]
}
פרמטרים של תגובה
התגובה תהיה JSON עם מערך של קובץ יומן. המפתח הוא יומן וערכו הוא מערך עם מספר השורות המבוקשות.
הורד קובץ יומן
הורדת קובצי יומן
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/logs/syslog.2.gz > log.gz
GET /system/logs/<file>
הורד קובץ יומן של קובצי יומן avayable המפורטים בעת בקשת GET.
פילה הוא מזהה הקובץ היומן הייחודי.
מערכת - גיבויים
בעזרת אפשרות הגיבוי תוכל לשמור את תצורת המערכת הנוכחית ולהוריד אותה.
בסעיף זה, תוכל ליצור, לשחזר, להעלות ולהוריד קבצי גיבוי.
רשימת גיבויים
רשימת גיבויים
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup
GET /system/backup
דוגמה לתגובה:
{
"description" : "Get backups",
"params" : [
{
"date" : "Fri Feb 3 06:01:04 2017",
"name" : "newbackup"
},
{
"date" : "Fri Feb 3 05:50:48 2017",
"name" : "firstConf"
}
]
}
פרמטרים של תגובה
התגובה תהיה JSON עם מערך של גיבויים. הפרמטרים של כל אלמנט מערך הם:
שדה | סוּג | תיאור |
---|---|---|
נתונים | מחרוזת | תאריך השינוי האחרון. |
שם | מחרוזת | זהו שם הקובץ המשמש כמזהה ייחודי. סיומת הקובץ היא .tar.gz . |
צור גיבוי
צור גיבוי
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"firstConf"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup
POST /system/backup
צור גיבוי תצורת מערכת של התצורה הנוכחית.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
שם | מחרוזת | זהו שם הקובץ המשמש כמזהה ייחודי. סיומת הקובץ היא .tar.gz . |
דוגמה לתגובה:
{
"description" : "Create a backups",
"message" : "Backup firstConf was created successful.",
"params" : "firstConf"
}
הורד גיבוי
הורד גיבוי
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup/firstConf > ~/zevenetConf.tar.gz
קובץ הגיבוי הוא בפורמט TAR GZ.
GET /system/backup/<name>
הורד גיבוי של תצורת המערכת. שם הוא מזהה הגיבוי הייחודי.
העלה גיבוי
העלה גיבוי
דוגמה לבקשה:
curl -k -X PUT -H 'Content-Type: text/plain'
--data-binary @/opt/1mar.tar.gz -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup/newbackup
PUT /system/backup/<name>
טען גיבוי מקומי מאוחסן ל- Zevenet. שם הוא מזהה הגיבוי הייחודי אשר יאוחסן בזובנט.
פרמטרים של בקשה
יש צורך להשתמש ב - data-binary כדי להעלות גיבוי.
דוגמה לתגובה:
{
"description" : "Upload a backup",
"message" : "Backup newbackup was created successful.",
"params" : "newbackup"
}
מחק גיבוי
מחק גיבוי
דוגמה לבקשה:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup/firstConf
DELETE /system/backup/<name>
מחיקת קובץ גיבוי ממערכת Zevenet. שם הוא מזהה הגיבוי הייחודי.
דוגמה לתגובה:
{
"description" : "Delete backup firstConf'",
"message" : "The list firstConf has been deleted successful.",
"success" : "true"
}
החל גיבוי
החל גיבוי
דוגמה לבקשה:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"apply"}'
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/backup/firstConf/actions
POST /system/backup/<name>/actions
שחזור התצורה מקובץ גיבוי. שם הוא מזהה הגיבוי הייחודי.
פרמטרים של בקשה
שדה | סוּג | תיאור |
---|---|---|
פעולה | מחרוזת | כדי לשחזר את תצורת הגיבוי, הערך חייב להיות להגיש מועמדות. |
דוגמה לתגובה:
{
"description" : "Apply a backup to the system",
"params" : {
"action" : "apply"
}
}
הורד תומך
הורד תומך
דוגמה לבקשה:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/supportsave > supportsave.tar.gz
GET /system/supportsave
קבל תמונת מצב מערכת עם כל התצורה והתהליך הפועלים במערכת. זה תומך יש צורך למצוא בעיות או תמיכה.