Zebet API v4.0 הפניה

ZAPI (Zevenet Application Programming Interface) הוא הכלי עבור מנהל המערכת כדי לפקח Zevenet עומס איזון התנהגות.

יש צורך פעיל zapi המשתמש מממשק האינטרנט לפני השימוש בו, מערכת / משתמשים.

לאחר שהמשתמש zapi נוצר, ניתן לשלוח בקשה לכתובת URL, https: // (zevenet_server): 444 / zapi / v4.0 / zapi.cgi / (URI_path), שם zevenet_server הוא ה- IP שבו שירות HTTP מקשיב.

URI_path מגדיר את האובייקט או הפעולה לפעול. ההתנהגות שלו והפרמטרים שלו יוגדרו בתוך כל חלק של דקדוקציה.

הפעלים המשמשים בממשק API זה יהיו לקבל, POST, PUT or למחוק. בקשת PUT או POST תמיד צריכה כמעט פרמטר אם כי זה לא צריך שום פרמטר נדרש.

תעודות

Zevenet תומך cetificates בפורמט PEM להשתמש בהם עם 444 / zapi / v4.0 / zapi.cgi חוות HTTP עם המאזין HTTPS. אם אתה רוצה ללמוד עוד על איך ליצור אישורים pem אנא בקר במאמר הבא: יצירת תעודות ב PEM פורמט

רשום את כל האישורים

רשום את כל האישורים

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/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/v4.0/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/v4.0/zapi.cgi/certificates

POST /certificates

צור בקשת חתימה של אישור (קובץ CSR).

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
שם	מחרוזת	שם תעודת הזהות.	נָכוֹן
fqdn	מחרוזת	שם התחום המלא של שרת 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן
חלוק	מחרוזת	חלוקת 444 / zapi / v4.0 / zapi.cgi ארגון טיפול האישור.	נָכוֹן
ארגון	מחרוזת	השם החוקי של ארגון 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן
יישוב	מחרוזת	העיר שבה נמצא ארגון 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן
היו	מחרוזת	המדינה / אזור שבו נמצא 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן
מדינה	מחרוזת	קוד ISO בן שתי האותיות עבור המדינה שבה נמצא ארגון 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן
דואר	מחרוזת	כתובת דוא"ל המשמשת ליצירת קשר עם ארגון 444 / zapi / v4.0 / zapi.cgi.	נָכוֹן

דוגמה לתגובה:

{
   "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/v4.0/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/v4.0/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	מחרוזת	הוא משמש כמזהה ייחודי.
תיאור	מחרוזת	שם ידידותי.

תעודות SSL של Letsencrypt

Zevenet תומך ביצירת אישורי Letsencrypt וחידושם. התעודה לבסוף היא תעודת ZEVENET PEM שניתן להשתמש בה עם חוות HTTPS. . אם אתה רוצה ללמוד עוד על איך ליצור פם תעודות, אנא בקרו במאמר הבא: יצירת תעודות ב PEM פורמט

הצג את תצורת Letsencrypt

הצג את תצורת Letsencrypt

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz/config

zcli certificate-le-config list

GET /certificates/letsencryptz/config

הצג את תצורת Letsencrypt.

דוגמה לתגובה:

התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.

{
   "description" : "Get LetsEncrypt Config",
   "params" : {
      "email" : "test_le@zevenet.com"
   }
}

פרמטרים של תגובה

שדה	סוּג	תיאור
אמייל	מחרוזת	דוא"ל עבור Letsencrypt

שנה את תצורת Letsencrypt

שנה את תצורת Letsencrypt

דוגמה לבקשה:

curl -k -X PUT -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"email":"test_le@zevenet.com"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz/config

zcli certificates-le-config set -email test_le@zevenet.com

PUT /certificates/letsencryptz/config

שנה את תצורת Letsencrypt.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
אמייל	מחרוזת	דואר אלקטרוני לשימוש כאיש קשר ב- Letsencrypt	נָכוֹן

דוגמה לתגובה:

התגובה תהיה אובייקט JSON עם הפרמטרים הבאים.

{
   "description" : "Modify LetsEncrypt Config",
   "message" : "The Letsencrypt Config has been updated successfully.",
   "params" : {
      "email" : "test_le@zevenet.com"
   },
   "success" : "true"
}

פרמטרים של תגובה

שדה	סוּג	תיאור
אמייל	מחרוזת	דוא"ל עבור Letsencrypt

רשום את כל אישורי Letsencrypt

רשום את כל אישורי Letsencrypt

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz

zcli certificate-le list 

GET /certificates/letsencryptz

רשום את כל אישורי Letsencrypt שנוצרו.

דוגמה לתגובה:

התגובה תהיה אובייקט JSON עם מקש מוגדר params. הערך של זה יהיה מערך של אובייקטי אישור letsencrypt, שכל אחד מהם מכיל את תכונות המפתח שלהלן.

{
   "description" : "List LetsEncrypt certificates",
   "params" : [
      {
         "CN" : "*.wildcard.test.zevenet.com",
         "creation" : "May 31 05:51:49 2021 GMT",
         "domains" : [
            "*.wildcard.test.zevenet.com"
         ],
         "expiration" : "Aug 29 05:51:49 2021 GMT",
         "file" : "/usr/local/zevenet/config/letsencrypt/acme/*.wildcard.test.zevenet.com/fullchain.cer",
         "issuer" : "US,(STAGING) Let's Encrypt,(STAGING) Artificial Apricot R3",
         "status" : "valid",
         "type" : "LE Certificate",
         "wildcard" : "true"
      },
      {
         "CN" : "*.test1.wildcard.test.zevenet.io",
         "creation" : "",
         "dnstxt" : [
            {
               "domain" : "*.test1.wildcard.test.zevenet.io",
               "txt" : "QpbOLzMrJapoQmcbrA5_dr6ciwLzNF-y3z5XR5i-I2c"
            }
         ],
         "domains" : [
            "*.test1.wildcard.test.zevenet.io"
         ],
         "expiration" : "",
         "file" : null,
         "issuer" : "",
         "status" : "not issued",
         "type" : "LE Certificate",
         "wildcard" : "true"
      }

   ]
}

פרמטרים של תגובה

שדה	סוּג	תיאור
params	אובייקט []	רשימת אובייקטים אישורים.

אובייקט אישור

שדה	סוּג	תיאור
CN	מחרוזת	שם נפוץ של דומיין.
יצירה	מחרוזת	תאריך היווצרות.
תחומים	מחרוזת []	רשימת הדומיינים שהאישור תקף עבורם.
תפוגה	מחרוזת	תאריך תפוגה.
dnstxt	אובייקט []	רשימה של רשומות DNS TXT עבור כל תחום לאימות אם האישור עדיין לא הונפק.
פילה	מחרוזת	זהו שם הקובץ של האישור, תעודת הזהות הייחודית.
מנפיק	מחרוזת	הרשות המוסמכת חתומה על התעודה.
מצב	מחרוזת	מצב התעודה.תקף,האישור תקף.עומד לפוג, האישור עומד לפוג.לא בתוקף, פג תוקף האישור.לא בעייתי, האישור עומד להנפקה.לא ידוע, האישור אינו תקף.
סוג	מחרוזת	תעודת LE.
כלליים	מחרוזת	נָכוֹן, האישור מיועד לדומיינים של תווים כלליים. שקר, האישור מיועד לדומיינים שאינם תווים כלליים לחיפוש.

אובייקט dnstxt

שדה	סוּג	תיאור
תחום	מחרוזת	שם דומיין
txt	מחרוזת	רשומת DNS txt של LetsEncrypt חייבת לאמת. רשומת ה-DNS TXT תהיה נגישה באמצעות _acme-challenge.domain.

בואו להצפין SSL ללא אישורי תווים כלליים

Let'sEncrypt no אישורי תווים כלליים הם אישורים תקפים רק ללא דומיינים עם תווים כלליים.

צור אישור חדש של Let'sEncrypt No Wildcard

צור אישור חדש של Let's Encrypt No Wildcard

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"lefarm","domains":["test.zevenet.com"],"test":"true","wildcard":"false"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz

zcli certificate-le create -wildcard false 

POST /certificates/letsencryptz

צור תעודה חדשה של Let's Encrypt.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
שם החווה	מחרוזת	שם החווה שבו מוגדר שירות זמני "Let's Encryptz".	נכון אם param vip לא נשלח.
החברים	מחרוזת	IP של המערכת, שבה מוגדרת חווה זמנית "Let's Encryptz".	נכון אם Param farmname לא נשלח.
תחומים	מחרוזת []	רשימת הדומיינים שהאישור תקף עבורם.	נָכוֹן
כלליים	מחרוזת	נָכוֹן, האישור מיועד לדומיינים של תווים כלליים. שקר, האישור מיועד לדומיינים שאינם תווים כלליים לחיפוש.	נָכוֹן
מבחן	מחרוזת	נָכוֹן, האישור מונפק על ידי LetsEncrypt Staging Server. שקר, האישור מונפק על ידי LetsEncrypt Server והוא יהיה תקף עבור סביבת ייצור.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Create Let's Encrypt certificate",
   "params" : {
      "CN" : "test.zevenet.com",
      "creation" : "May 31 11:05:30 2021 GMT",
      "domains" : [
         "test.zevenet.io"
      ],
      "expiration" : "Aug 29 11:05:30 2021 GMT",
      "file" : "/usr/local/zevenet/config/letsencrypt/live/test.zevenet.com/fullchain.pem",
      "issuer" : "US,(STAGING) Let's Encrypt,(STAGING) Artificial Apricot R3",
      "status" : "valid",
      "type" : "LE Certificate",
      "wildcard" : "false"
   }
}

פרמטרים של תגובה

שדה	סוּג	תיאור
params	אובייקט []	רשימת אובייקטים אישורים.

אובייקט אישור

שדה	סוּג	תיאור
CN	מחרוזת	שם נפוץ של דומיין.
יצירה	מחרוזת	תאריך היווצרות.
תחומים	מחרוזת []	רשימת הדומיינים שהאישור תקף עבורם.
תפוגה	מחרוזת	תאריך תפוגה.
פילה	מחרוזת	זהו שם הקובץ של האישור, תעודת הזהות הייחודית.
מנפיק	מחרוזת	הרשות המוסמכת חתומה על התעודה.
מצב	מחרוזת	מצב התעודה.תקף,האישור תקף.עומד לפוג, האישור עומד לפוג.לא בתוקף, פג תוקף האישור.לא בעייתי, האישור עומד להנפקה.לא ידוע, האישור אינו תקף.
סוג	מחרוזת	תעודת LE.
כלליים	מחרוזת	נָכוֹן, האישור מיועד לדומיינים של תווים כלליים. שקר, האישור מיועד לדומיינים שאינם תווים כלליים לחיפוש.

הגדר פעולה ב-Let's Encrypt no Wildcard Certificate

הגדר פעולה ב-Let's Encrypt No Wildcard Certificate

דוגמה לבקשה:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"renew","vip":"192.168.101.44","force_renewal":"true","restart":"true"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz/example.domain.com/actions

zcli certificate-le renew example.domain.com ( not implemented )

POST /certificates/letsencryptz/<domain>/actions

הגדר פעולה באישור Let's Encrypt ללא תווים כלליים, ראה את טבלת הפרמטרים של בקשה לפעולות.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
פעולה	מחרוזת	הפעולה לביצוע: האפשרויות הן: לחדש, התעודה תחודש.
שם החווה	מחרוזת	שם החווה שבו מוגדר שירות זמני "Let's Encryptz" לחידוש האישור.	נכון אם param vip לא נשלח.
החברים	מחרוזת	IP של המערכת, שבה מוגדרת חוות זמנית "Let's Encryptz" לחידוש האישור.	נכון אם Param farmname לא נשלח.
כוח_חידוש	מחרוזת	נָכוֹן, לאלץ את חידוש האישור גם אם לא פג תוקפו, שקר, האישור יחודש אם הוא אמור להתחדש (פחות מ-30 יום לפוג).
הפעלה מחדש	מחרוזת	נָכוֹן, כל החוות המשתמשות בתעודה יופעלו מחדש. שקר, לא יופעלו מחדש חוות המשתמשות בתעודה.

דוגמה לתגובה:

{
   "description" : "Let's Encrypt certificate actions",
   "params" : {
      "CN" : "test.zevenet.com",
      "creation" : "May 31 11:35:08 2021 GMT",
      "domains" : [
         "test.zevenet.com"
      ],
      "expiration" : "Aug 29 11:35:08 2021 GMT",
      "file" : "/usr/local/zevenet/config/letsencrypt/live/test.zevenet.com/fullchain.pem",
      "issuer" : "US,(STAGING) Let's Encrypt,(STAGING) Artificial Apricot R3",
      "status" : "valid",
      "type" : "LE Certificate",
      "wildcard" : "false"
   },
   "warning" : "The following farms were been restarted: testl7farm"
}

פרמטרים של תגובה

אם חוות ה- are הופעלו מחדש, ה אזהרה שדה יתאר את זה.

שדה	סוּג	תיאור
params	אובייקט []	רשימת אובייקטים אישורים.

אובייקט אישור

שדה	סוּג	תיאור
CN	מחרוזת	שם נפוץ של דומיין.
יצירה	מחרוזת	תאריך היווצרות.
תחומים	מחרוזת []	רשימת הדומיינים שהאישור תקף עבורם.
תפוגה	מחרוזת	תאריך תפוגה.
פילה	מחרוזת	זהו שם הקובץ של האישור, תעודת הזהות הייחודית.
מנפיק	מחרוזת	הרשות המוסמכת חתומה על התעודה.
מצב	מחרוזת	מצב התעודה.תקף,האישור תקף.עומד לפוג, האישור עומד לפוג.לא בתוקף, פג תוקף האישור.לא בעייתי, האישור עומד להנפקה.לא ידוע, האישור אינו תקף.
סוג	מחרוזת	תעודת LE.
כלליים	מחרוזת	נָכוֹן, האישור מיועד לדומיינים של תווים כלליים. שקר, האישור מיועד לדומיינים שאינם תווים כלליים לחיפוש.

מחק תעודת ללא תו כללי Let's Encrypt Certificate

מחק תעודת ללא תו כללי Let's Encrypt Certificate

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/certificates/letsencryptz/example.domain.com

zcli certificate-le delete example.domain.com

DELETE /certificates/letsencryptz/<domain>

מחק אישור Let's Encrypt לפי דומיין.

דוגמה לתגובה:

{
   "description" : "Delete Let's Encrypt certificate",
   "message" : "Let's Encrypt Certificate example.domain.com has been deleted.",
   "success" : "true"
}

חוות

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/v4.0/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/v4.0/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/v4.0/zapi.cgi/farms/FarmTCP/actions

PUT /farms/<farmname>/actions

החל פעולה על חווה, עיין בטבלה פרמטרים בקשה לפעולות.

פרמטרים של בקשה

שדה	סוּג	תיאור
פעולה	מחרוזת	הגדר את הפעולה הרצויה. הפעולות הן: להפסיק, החווה תיעצר. התחלה, החווה תתחיל ו הפעלה מחדש, החווה תיעצר ותתחיל באופן אוטומטי.

דוגמה לתגובה:

{
  "description" : "Set a new action in FarmHTTP",
  "params" : [
     {
        "action" : "stop"
     }
  ]
}

פרמטרים של תגובה

אם אין בעיות בתצורה, zapi יחזיר את הפעולה המבוקשת.

חוות HTTP

פרופיל HTTP הוא איזון עומסים מתקדם בשכבה 7 (או בקר אספקת יישומים) עם מאפיינים מיוחדים של פרוקסי. פרופיל זה מציע כמה תכונות כמו איזון עומסים בשכבה 7 של HTTPS. פרופיל זה מיועד לשירותי אינטרנט (כולל שרתי יישומי אינטרנט) ולכל פרוטוקולי היישומים המבוססים על פרוטוקולי 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/v4.0/zapi.cgi/farms/httpFarm

GET /farms/<farmname>

הצג את כל תצורת החווה.

דוגמה לתגובה:

{
   "description" : "List farm httpFarm",
   "params" : {
      "certlist" : [
         {
            "file" : "zencert.pem",
            "id" : 1
         }
      ],
      "addheader" : [
         {
            "header" : "load-balancer: true",
            "id" : 0
         }
      ],
      "addresponseheader" : [
         {
            "header" : "Session: true",
            "id" : 0
         }
      ],
      "headremove" : [
         {
            "id" : 0,
            "pattern" : "^client"
         }
      ],
      "removeresponseheader" : [
         {
            "id" : 0,
            "pattern" : "Host"
         }
      ],
      "ignore_100_continue" : "true",
      "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" : [],
         "farmguardian" : "check_tcp",
         "httpsb" : "false",
         "id" : "service3",
         "leastresp" : "false",
         "redirect" : "http://192.168.101.254/index.html",
         "redirecttype" : "default",
         "sessionid" : "",
         "ttl" : 0,
         "urlp" : "",
         "vhost" : "",
         "pinnedconnection" : 0,
         "routingpolicy" : "ROUND_ROBIN"
      },
      {
         "backends" : [
            {
               "id" : 0,
               "ip" : "192.168.0.168",
               "port" : 80,
               "status" : "up",
               "timeout" : null,
               "weight" : null
            }
         ],
         "farmguardian" : null,
         "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. הערכים הזמינים הם: סטנדרטי, קיבל בקשות http GET, פוסט, 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 של החווה, שבו השירות וירטואלי מקשיב.
גווניה	מספר	נמל של החווה, שבו השירות וירטואלי מקשיב.

יומני | מחרוזת | החווה מתעדת את המעקב אחר חיבורי ה-HTTP. אם לפרמטר זה יש את הערך נָכוֹן, היומנים מופעלים; אם יש לו את הערך שקר, יומנים מושבתים. ignore_100_continue | מחרוזת | אם לשדה זה יש את הערך true תתעלם מכותרת HTTP 100 continue; אם הערך הוא false, כותרת המשך 100 תעובד (מגרסה 4.0.2). addheader | אובייקט[] | זוהי רשימה של אובייקטים עם הכותרות להוספה לבקשת הלקוח (מגרסה 4.0.2). addresponseheader | אובייקט[] | זוהי רשימה של אובייקטים עם הכותרות להוספה לתגובת הקצה האחורי (מגרסה 4.0.2). headremove | אובייקט[] | זוהי רשימה של ביטויים רגולריים להסרת כותרות מבקשות הלקוח. הכותרות שהוסרו לא יגיעו לקצה האחורי (מגרסה 4.0.2). removeresponseheader | אובייקט[] | זוהי רשימה של ביטויים רגולריים להסרת כותרות מהתגובה האחורית. הכותרות שהוסרו לא יגיעו ללקוח (מגרסה 4.0.2). חיבור מוצמד (מגרסה 4.0.2) | מספר | ציין אם ברצוננו להצמיד את כל החיבורים, (ברירת מחדל: 0, לא מוצמד). אם Pinnedconnection מוגדר ל-1, zproxy מעביר ישירות את כל הנתונים ללא ניתוח או עריכה. מדיניות ניתוב (מגרסה 4.0.2) | מחרוזת | ציין את מדיניות הניתוב. כל האלגוריתמים משוקללים עם כל המשקולות המוגדרות בכל קצה אחורי. ישנן ארבע אפשרויות: רובין העגול השתמש באלגוריתם הרובין כמדיניות ניתוב (ברירת מחדל). LEAST_CONNECTIONS בחר את הקצה האחורי עם הכי פחות חיבורים שנוצרו תוך שימוש כפרופורציה של המשקולות שנקבעו. זמן תגובה בחר את הקצה האחורי עם זמן התגובה הנמוך ביותר תוך שימוש בפרופורציה של המשקולות שנקבעו. PENDING_CONNECTIONS בחר את הקצה האחורי עם החיבורים הממתינים לפחות תוך שימוש בפרופורציה של המשקולות שנקבעו. כותב מחדש (מגרסה 4.0.2) | אובייקט[] | הוא בודק דפוס כדי לקבל מחרוזות מ-URL ולהחליף אותן. ניתן להוסיף מספר הנחיות RewriteUrl. כולם יוחלו ברצף על כתובת האתר הנכנסת אלא אם הוגדר הדגל האחרון שיסיים את שלב השכתוב של כתובת האתר.

אובייקט Certlist:

שדה	סוּג	תיאור
פילה	מחרוזת	שם האישור, הפניות לאישור בחנות אישורים.
id	מספר	מזהה תעודה.

אובייקט שירותים עבור חוות HTTP:

שדה	סוּג	תיאור
backends	אובייקט []	Backends שהוגדרו בשירות.
חקלאי	מחרוזת	זהו שם FarmGuardian כי הוא בודק את מצב backend. FarmGuardian יהיה פועל בעוד החווה נמצאת במעמד.
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 זה. הערכים האפשריים הם מ 1 ל 9.
connect_limit (מ 4.0.2)	מספר	(רק כאשר הדור החדש של פרוקסי עובד) המספר המרבי של חיבורים שנוצרו לכל backend. עם ערך 0, לא תהיה הגבלה ב-backend. הלקוח יקבל שגיאת 503 אם אין קצה אחורי זמין.

יצירת חוות חדשה

יצירת חוות חדשה

דוגמה לבקשה:

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/v4.0/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,
"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://<zevenet_server>:444/zapi/v4.0/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. הערכים הזמינים הם: סטנדרטי, קיבל בקשות http GET, פוסט, 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/v4.0/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"
}

הוסף כותרת מותאמת אישית לבקשה

הוסף כותרת מותאמת אישית לבקשה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"loadbalancer: true"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addheader

zcli farm-add-request-header MyHttpFarm -header "loadbalancer: true"

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/addheader

החווה תוסיף את הכותרת אל backend.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	זה מחרוזת עם הכותרת כי יישלחו backend.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Add addheader directive.",
   "message" : "Added a new item to the addheader list",
   "status" : "needed restart",
   "success" : "true"
}

שנה והוספה של כותרת מותאמת אישית לכלל הבקשה

שנה והוספה של כותרת מותאמת אישית לכלל הבקשה

דוגמה לבקשה:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"loadbalancer: true"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addheader/id

zcli farm-add-request-header MyHttpFarm -header "loadbalancer: true"

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/addheader/<id>

החווה תוסיף את הכותרת אל backend.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	זה מחרוזת עם הכותרת כי יישלחו backend.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify an addheader directive.",
   "message" : "Modified an item from the addheader list",
   "success" : "true"
}

מחק כותרת מותאמת אישית מהבקשה

מחק כותרת מותאמת אישית מהבקשה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addheader/0

zcli farm-add-request-header remove MyHttpFarm 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/addheader/<index>

מדד הוא האינדקס של מערך Addheader למחיקה.

דוגמה לתגובה:

{
   "description" : "Delete addheader directive.",
   "message" : "The addheader 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

הוסף כלל להסרת כותרות מהבקשה

הוסף כלל להסרת כותרות מהבקשה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"pattern":"^client:"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/headremove

zcli farm-remove-request-header add MyHttpFarm -pattern "^client:"

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/headremove

הסר כותרות מסוימות מהבקשות הנכנסות. כל המופעים של הכותרת שצוינה יוסרו.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
דפוס	מחרוזת	זה מחרוזת עם regexp לחפש בקשות הלקוח. אם כותרת כלשהי תואמת בתבנית, הכותרת תוסר	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Add headremove directive.",
   "message" : "Added a new item to the headremove list",
   "status" : "needed restart",
   "success" : "true"
}

שנה הסרת כותרות מכלל הבקשה

שנה הסרת כותרות מכלל הבקשה

דוגמה לבקשה:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"pattern":"^client:"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/headremove/id

zcli farm-remove-request-header add MyHttpFarm -pattern "^client:"

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/headremove/<id>

הסר כותרות מסוימות מהבקשות הנכנסות. כל המופעים של הכותרת שצוינה יוסרו.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
דפוס	מחרוזת	זה מחרוזת עם regexp לחפש בקשות הלקוח. אם כותרת כלשהי תואמת בתבנית, הכותרת תוסר	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify an headremove directive.",
   "message" : "Modified an item from the headremove list",
   "success" : "true"
}

מחק כלל להסרת כותרות מהבקשה

מחק כלל להסרת כותרות מהבקשה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/headremove/0

zcli farm-remove-request-header remove MyHttpFarm 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/headremove/<index>

מדד הוא האינדקס של מערך headremove למחיקה.

דוגמה לתגובה:

{
   "description" : "Delete headremove directive.",
   "message" : "The headremove 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

הוסף כותרת מותאמת אישית לתגובה

הוסף כותרת מותאמת אישית לתגובה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"loadbalancer: true"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addresponseheader

zcli farm-add-response-header add MyHttpFarm -header loadbalancer:true

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/addresponseheader

החווה תוסיף את הכותרת לתגובת ה- backend.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	זה מחרוזת עם הכותרת כי יישלחו backend.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Add a header to the backend repsonse.",
   "message" : "Added a new header to the backend response",
   "status" : "needed restart",
   "success" : "true"
}

שנה והוספה של כותרת מותאמת אישית לכלל התגובה

שנה והוספה של כותרת מותאמת אישית לכלל התגובה

דוגמה לבקשה:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"loadbalancer: true"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addresponseheader/id

zcli farm-add-response-header add MyHttpFarm -header loadbalancer:true

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/addresponseheader/<id>

החווה תוסיף את הכותרת לתגובת ה- backend.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	זה מחרוזת עם הכותרת כי יישלחו backend.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify an addresponseheader directive.",
   "message" : "Modified an item from the addresponseheader list",
   "success" : "true"
}

מחק כותרת מותאמת אישית מהתגובה

מחק כותרת מותאמת אישית מהתגובה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/addresponseheader/0

zcli farm-add-response-header remove torta 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/addresponseheader/<index>

מדד הוא האינדקס של מערך addresponseheader למחיקה.

דוגמה לתגובה:

{
   "description" : "Delete a header previously added to the backend response.",
   "message" : "The header 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

הוסף כלל להסרת כותרות מתגובה

הוסף כלל להסרת כותרות מתגובה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"pattern":"^client:"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/removeresponseheader

zcli farm-remove-response-header add MyHttpFarm -pattern "^client:"

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/removeresponseheader

הסר כותרות מסוימות מהבקשות הנכנסות. כל המופעים של הכותרת שצוינה יוסרו.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
דפוס	מחרוזת	זה מחרוזת עם regexp לחפש בקשות הלקוח. אם כותרת כלשהי תואמת בתבנית, הכותרת תוסר	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Remove a header from the backend response.",
   "message" : "Added a patter to remove reponse headers",
   "status" : "needed restart",
   "success" : "true"
}

שנה כלל הסר כותרות מהתגובה

שנה כלל הסר כותרות מהתגובה

דוגמה לבקשה:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"pattern":"^client:"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/removeresponseheader/id

zcli farm-remove-response-header add MyHttpFarm -pattern "^client:"

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/removeresponseheader/<id>

הסר כותרות מסוימות מהבקשות הנכנסות. כל המופעים של הכותרת שצוינה יוסרו.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
דפוס	מחרוזת	זה מחרוזת עם regexp לחפש בקשות הלקוח. אם כותרת כלשהי תואמת בתבנית, הכותרת תוסר	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify a remove response header directive.",
   "message" : "Modified an item from the removeresponseheader list",
   "success" : "true"
}

מחק כלל להסרת כותרת מתגובה

מחק כלל להסרת כותרת מתגובה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/removeresponseheader/0

zcli farm-remove-response-header remove torta 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/removeresponseheader/<index>

מדד הוא האינדקס של מערך removeresponseheader למחיקה.

דוגמה לתגובה:

{
   "description" : "Delete a pattern to remove response headers.",
   "message" : "The pattern 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

הוסף כלל לשכתוב כותרות מתוך בקשה

הוסף כלל לשכתוב כותרות מתוך בקשה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"^Cookie:","match":"^COOKIESESSION=(.*)","replace":"COOKIEUSER=$1"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replacerequestheader

farm-replace-request-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1`

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/replacerequestheader

הוסף כללים כדי לשכתב כותרות מהבקשה.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	Regex עם שם הכותרת שיש לשכתב	נָכוֹן
להתאים	מחרוזת	ערך רגקס שיתאים למה שאנו רוצים להחליף	נָכוֹן
להחליף	מחרוזת	ערך להחליף גפרורים	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Add a Replace Header.",
   "message" : "Added a new replace header",
   "status" : "needed restart",
   "success" : "true"
}

שנה כלל שכתוב כותרות מ-Request

שנה כלל שכתוב כותרות מ-Request

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"^Cookie:","match":"^COOKIESESSION=(.*)","replace":"COOKIEUSER=$1"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replacerequestheader/id

farm-replace-request-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1`

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/replacerequestheader/<id>

הוסף כללים כדי לשכתב כותרות מהבקשה.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	Regex עם שם הכותרת שיש לשכתב	נָכוֹן
להתאים	מחרוזת	ערך רגקס שיתאים למה שאנו רוצים להחליף	נָכוֹן
להחליף	מחרוזת	ערך להחליף גפרורים	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify a replaceHeader directive.",
   "message" : "Modified an item from the replaceHeader list",
   "success" : "true"
}

מחק כלל לשכתוב כותרות מהבקשה

מחק כלל לשכתוב כותרות מהבקשה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replacerequestheader/0

zcli farm-replace-request-header remove MyHttpFarm 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/replacerequestheader/<index>

מדד הוא האינדקס של מערך replacerequestheader שיש למחוק.

דוגמה לתגובה:

{
   "description" : "Delete a replace header directive.",
   "message" : "The replace header 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

העבר כותרות שכתוב מכלל בקשה

העבר כותרות שכתוב מכלל בקשה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"position":1}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replacerequestheader/id/actions

farm-replace-request-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1`

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/replacerequestheader/<id>/actions

העבר כותרת ReplaceRequest.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
עמדה	מספר	עמדת כלל חדשה	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Move a replace header directive",
   "message" : "Header was moved successfully.",
   "params" : {
      "position" : "1"
   }
}

הוסף כלל לשכתוב כותרות מהתגובה

הוסף כלל לשכתוב כותרות מהתגובה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"^Cookie:","match":"^COOKIESESSION=(.*)","replace":"COOKIEUSER=$1"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replaceresponseheader

farm-replace-response-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1` -t$

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/replaceresponseheader

הוסף כללים כדי לשכתב כותרות מהתגובה.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	Regex עם שם הכותרת שיש לשכתב	נָכוֹן
להתאים	מחרוזת	ערך רגקס שיתאים למה שאנו רוצים להחליף	נָכוֹן
להחליף	מחרוזת	ערך להחליף גפרורים	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Add a Replace Header.",
   "message" : "Added a new replace header",
   "status" : "needed restart",
   "success" : "true"
}

שנה כלל שכתוב כותרות מ-Response

שנה כלל שכתוב כותרות מ-Response

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"header":"^Cookie:","match":"^COOKIESESSION=(.*)","replace":"COOKIEUSER=$1"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replaceresponseheader/id

farm-replace-response-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1` -t$

שיחה זו זמינה מגרסה 4.0.2

PUT /farms/<farmname>/replaceresponseheader/<id>

הוסף כללים כדי לשכתב כותרות מהתגובה.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
כותרת	מחרוזת	Regex עם שם הכותרת שיש לשכתב	נָכוֹן
להתאים	מחרוזת	ערך רגקס שיתאים למה שאנו רוצים להחליף	נָכוֹן
להחליף	מחרוזת	ערך להחליף גפרורים	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Modify a replaceHeader directive.",
   "message" : "Modified an item from the replaceHeader list",
   "success" : "true"
}

מחק כלל לשכתב כותרות מהתגובה

מחק כלל לשכתב כותרות מהתגובה

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replaceresponseheader/0

zcli farm-replace-response-header remove MyHttpFarm 0

שיחה זו זמינה מגרסה 4.0.2

DELETE /farms/<farmname>/replaceresponseheader/<index>

מדד הוא האינדקס של מערך replaceresponseheader שיש למחוק.

דוגמה לתגובה:

{
   "description" : "Delete a replace header directive.",
   "message" : "The replace header 0 was deleted successfully",
   "status" : "needed restart",
   "success" : "true"
}

העבר כותרות שכתוב מכלל בקשה

העבר כותרות שכתוב מכלל תגובה

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"position":1}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/MyHttpFarm/replaceresponseheader/id/actions

farm-replace-response-header add farm1 -header ^Cookie: -match ^COOKIESESSION=(.*) -replace COOKIEUSER=$1`

שיחה זו זמינה מגרסה 4.0.2

POST /farms/<farmname>/replaceresponseheader/<id>/actions

העבר כותרת ReplaceRequest.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
עמדה	מספר	עמדת כלל חדשה	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Move a replace header directive",
   "message" : "Header was moved successfully.",
   "params" : {
      "position" : "1"
   }
}

HTTP - שירותים

השירותים בתוך חוות פרופיל HTTP מספק שיטת מיתוג תוכן כדי לספק מספר שירותי אינטרנט עם מאפיינים שונים, backends או אפילו שיטות התמדה, באמצעות כמה תנאים דטרמיניסטי בשימוש על ידי הליבה החווה על מנת להתאים את השירות הנכון עבור כל בקשה ללקוח. הגדרת שירות זו תשמש את החווה על מנת לקבוע את שרתי backend שיכולים לספק את התגובה ללקוח.

אחזר שירות לפי מזהה

אחזר שירות לפי מזהה

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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,
            "connection_limit" : null
         },
         {
            "id" : 0,
            "ip" : "192.168.100.254",
            "port" : 80,
            "status" : "up",
            "timeout" : null,
            "weight" : null,
            "connection_limit" : null
         }
      ],
      "farmguardian" : "check_tcp-cut_conns",
      "httpsb" : "false",
      "id" : "serv",
      "leastresp" : "false",
      "persistence" : "COOKIE",
      "redirect" : "",
      "redirecttype" : "",
      "sessionid" : "JSESSIONID",
      "ttl" : 18,
      "urlp" : "(?i)^/music$",
      "vhost" : "",
      "pinnedconnection" : 0,
      "routingpolicy" : "ROUND_ROBIN",
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם הפורמט שלהלן.

אובייקט שירותים עבור חוות HTTP:

שדה	סוּג	תיאור
backends	אובייקט []	Backends שהוגדרו בשירות.
חקלאי	מחרוזת	זהו שם FarmGuardian כי הוא בודק את מצב backend. FarmGuardian יהיה פועל בעוד החווה נמצאת במעמד.
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 נתמך.
חיבור מוצמד (מגרסה 4.0.2)	מספר	ציין אם ברצוננו להצמיד את כל החיבורים, (ברירת מחדל: 0, לא מוצמד). אם Pinnedconnection מוגדר ל-1, zproxy מעביר ישירות את כל הנתונים ללא ניתוח או עריכה.
מדיניות ניתוב (מגרסה 4.0.2)	מחרוזת	ציין את מדיניות הניתוב. כל האלגוריתמים משוקללים עם כל המשקולות המוגדרות בכל קצה אחורי. ישנן ארבע אפשרויות: רובין העגול השתמש באלגוריתם הרובין כמדיניות ניתוב (ברירת מחדלט). LEAST_CONNECTIONS בחר את הקצה האחורי עם הכי פחות חיבורים שנוצרו תוך שימוש כפרופורציה של המשקולות שנקבעו. זמן תגובה בחר את הקצה האחורי עם זמן התגובה הנמוך ביותר תוך שימוש בפרופורציה של המשקולות שנקבעו. PENDING_CONNECTIONS בחר את הקצה האחורי עם החיבורים הממתינים לפחות תוך שימוש בפרופורציה של המשקולות שנקבעו.

אובייקט Backend עבור חוות HTTP:

שדה	סוּג	תיאור
id	מספר	מזהה לאחור בתוך השירות הנתון.
ip	מחרוזת	ה- IP של Backend שבו פועל השירות האמיתי.
נמל	מספר	הנמל של Backend שבו פועל השירות האמיתי.
מצב	מחרוזת	מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק.
פסק זמן	מספר	זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות. אם מערכת null תשתמש בפרמטר הגלובלי Backends Backout.
מִשׁקָל	מספר	זה ערך המשקל של השרת האמיתי הנוכחי, גב גב בעל ערך משקל גבוה יותר יקבל יותר חיבורים. ערך ברירת המחדל null, לא משקל מיוחד המשמש עבור backend זה. הערכים האפשריים הם מ 1 ל 9.
connect_limit (מ 4.0.2)	מספר	(רק כאשר הדור החדש של פרוקסי עובד) המספר המרבי של חיבורים שנוצרו לכל backend. עם ערך 0, לא תהיה הגבלה ב-backend. הלקוח יקבל שגיאת 503 אם אין קצה אחורי זמין.

צור שירות חדש

צור שירות חדש

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"newserv"}' https://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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.
חיבור מוצמד (מגרסה 4.0.2)	מספר	ציין אם ברצוננו להצמיד את כל החיבורים, (ברירת מחדל: 0, לא מוצמד). אם Pinnedconnection מוגדר ל-1, zproxy מעביר ישירות את כל הנתונים ללא ניתוח או עריכה.
מדיניות ניתוב (מגרסה 4.0.2)	מחרוזת	ציין את מדיניות הניתוב. כל האלגוריתמים משוקללים עם כל המשקולות המוגדרות בכל קצה אחורי. ישנן ארבע אפשרויות: רובין העגול השתמש באלגוריתם הרובין כמדיניות ניתוב (ברירת מחדלט). LEAST_CONNECTIONS בחר את הקצה האחורי עם הכי פחות חיבורים שנוצרו תוך שימוש כפרופורציה של המשקולות שנקבעו. זמן תגובה בחר את הקצה האחורי עם זמן התגובה הנמוך ביותר תוך שימוש בפרופורציה של המשקולות שנקבעו. PENDING_CONNECTIONS בחר את הקצה האחורי עם החיבורים הממתינים לפחות תוך שימוש בפרופורציה של המשקולות שנקבעו.

דוגמה לתגובה:

{
   "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" : [],
      "httpsb" : "true",
      "id" : "newsrv",
      "leastresp" : "true",
      "persistence" : "",
      "redirect" : "http://zenloadbalancer.com",
      "redirecttype" : "default",
      "sessionid" : "sid",
      "ttl" : 125,
      "urlp" : "^/myapp1$",
      "vhost" : "www.mywebserver.com",
      "pinnedconnection" : 0,
      "routingpolicy" : "ROUND_ROBIN",
   },
   "status" : "needed restart"
}

פרמטרי תגובה

התגובה תהיה json עם פרמטרים המבוקש עודכן מצב שדה עם יש צורך מחדש ערך. יש לבצע פעולת הפעלה מחדש כדי להחיל את השינויים.

הוסף FarmGuardian

הוסף FarmGuardian

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"check_tcp-cut_conns"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/FarmHTTP/services/service1/fg

POST /farms/<farmname>/services/<id>/fg

החל FarmGuardian לשירות.

הפרמטר URI הוא המזהה הייחודי לשירות.

פרמטרים של בקשה

שדה	סוּג	תיאור
שם	מחרוזת	מזהה ייחודי של FarmGuardian. FarmGuardians נוצרים ושונה בסעיף ניטור.

דוגמה לתגובה:

{
   "description" : "Add the farm guardian check_tcp-cut_conns to the service service1 in the farm FarmHTTP",
   "message" : "Success, The farm guardian check_tcp-cut_conns was added to the service service1 in the farm FarmHTTP"
}

הסר FarmGuardian

הסר FarmGuardian

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/FarmHTTP/service/service1/fg/check_tcp-cut_conns

DELETE /farms/<farmname>/services/<id>/fg/<name>

הסר את FarmGuardian משירות בחווה.

דוגמה לתגובה:

{
   "description" : "Remove the farm guardian check_tcp-cut_conns from the service service1 in the farm FarmHTTP",
   "message" : "Sucess, check_tcp-cut_conns was removed from the service service1 in the farm FarmHTTP"
}

מחיקת שירות

מחיקת שירות

דוגמה לבקשה:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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,
         "connection_limit" : null
      },
      {
         "id" : 1,
         "ip" : "192.168.102.245",
         "port" : 80,
         "status" : "up",
         "timeout" : 22,
         "weight" : 2,
         "connection_limit" : null
      }
   ]
}

פרמטרי תגובה

שיחה זו מחזירה מערך אובייקט backend עם הפרמטרים השוררים.

שדה	סוּג	תיאור
id	מספר	מזהה ייחודי עבור backend בשירות. מזהה זה נוצר על ידי המערכת.
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.
נמל	מספר	הנמל של Backend שבו השירות מאזין.
פסק זמן	מספר	זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות.
מִשׁקָל	מספר	זה ערך המשקל עבור ה- backend הנוכחי. הערכים האפשריים הם מ 1 ל 9.
מצב	מחרוזת	מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק.
connect_limit (מ 4.0.2)	מספר	(רק כאשר הדור החדש של פרוקסי עובד) המספר המרבי של חיבורים שנוצרו לכל backend. עם ערך 0, לא תהיה הגבלה ב-backend. הלקוח יקבל שגיאת 503 אם אין קצה אחורי זמין.

צור 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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/httpfarm/services/newsrv/backends

POST /farms/<farmname>/services/<id>/backends

צור Backend חדש בפרופיל HTTP נתון. id הוא המזהה הייחודי לשירות.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.	נָכוֹן
נמל	מספר	הנמל של Backend שבו השירות מאזין.	נָכוֹן
פסק זמן	מספר	זה פסק זמן backend להגיב על בקשה מסוימת.
מִשׁקָל	מספר	זה ערך המשקל עבור ה- backend הנוכחי. הערכים האפשריים הם מ 1 ל 9.

דוגמה לתגובה:

{
   "description" : "New service backend",
   "message" : "Added backend to service succesfully",
   "params" : {
      "id" : 0,
      "ip" : "192.168.102.244",
      "port" : 80,
      "timeout" : 2,
      "weight" : 2,
      "connection_limit" : null
   },
   "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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/FarmHTTP/service/service1/backends/1

PUT /farms/<farmname>/services/<id>/backends/<id>

שינוי הפרמטרים של backend בשירות של פרופיל HTTP.

ראשון id הוא מזהה השירות הייחודי, הבא id הוא מזהה ייחודי backend.

פרמטרים של בקשה

שדה	סוּג	תיאור
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.
נמל	מספר	הנמל של Backend שבו השירות מאזין.
פסק זמן	מספר	זה פסק זמן backend להגיב על בקשה מסוימת, בתוך שניות.
מִשׁקָל	מספר	זה ערך המשקל עבור ה- backend הנוכחי. הערכים האפשריים הם מ 1 ל 9.

דוגמה לתגובה:

{
   "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,
      "connection_limit" : null
   },
   "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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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/v4.0/zapi.cgi/farms/l4farm

GET /farms/<farmname>

הצג את כל תצורת החווה.

תגובה BODY:

{
   "backends" : [
      {
         "id" : 0,
         "ip" : "192.168.55.40",
         "priority" : 2,
         "status" : "undefined",
         "weight" : 1
      },
      {
         "id" : 1,
         "ip" : "192.168.55.41",
         "priority" : 3,
         "status" : "undefined",
         "weight" : 2
      }
   ],
   "description" : "List farm l4farm",
   "params" : {
      "algorithm" : "weight",
      "farmguardian" : "check_tcp",
      "listener" : "l4xnat",
      "nattype" : "nat",
      "protocol" : "tcp",
      "status" : "down",
      "vip" : "192.168.100.241",
      "vport" : "88"
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם הפורמט שלהלן.

אובייקט משק חקלאי:

שדה	סוּג	תיאור
params	חפץ	פרמטרים של תצורה חקלאית.
backends	אובייקט []	כל השרתים האמיתיים שנוצרו בחווה זו ואת התצורה שלה.

אובייקט פרמטרים עבור חוות L4xNAT:

שדה	סוּג	תיאור
אַלגוֹרִיתְם	מחרוזת	סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: מִשׁקָל חיבור שיגור ליניארי לפי משקל, מקור המקור Hash לכל מקור IP ו- Source, פשוט המקור Hash לכל מקור IP בלבד, סימטרי חשיש הנסיעה הלוך ושוב לכל IP ופורט.
מאזין	מחרוזת	מאזין מגדיר כיצד החווה הולכת לשחק עם הבקשות מהלקוחות. שדה מידע, לא ניתן לשנותו.
nattype	מחרוזת	איך שכבת איזון שכבת 4 הליבה הולך לפעול. האפשרויות הן: נת המכונה גם מצב sNAT, backend מגיב לאיזון עומס על מנת לשלוח את התגובה ללקוח, dnat backend יגיב ישירות ללקוח, איזון עומס צריך להיות מוגדר כשער בשרת backend, Dsr לחזור שרת ישיר, איזון עומס לשנות את MAC היעד והתגובה הולכת ישירות ללקוח.
פרוטוקול	מחרוזת	פרוטוקול להיות מאוזן בשכבה 4. האפשרויות הן: את כל הפרופיל יהיה לטעון איזון כל פרוטוקול L4, TCP איזון העומס יהיה רק ​​איזון פרוטוקול TCP L4, UDP איזון העומסים יאזן רק את פרוטוקול UDP L4, לגימה איזון העומס יהיה רק ​​לאזן את SIP או פרוטוקול VoIP L7, FTP את איזון עומס רק לאזן את פרוטוקול L7 FTP, tftp את איזון עומס רק לאזן TFTP L7 פרוטוקול, sctp איזון עומסים רק לאזן את פרוטוקול SCTP L4, אמנדה איזון העומסים יאזן רק את פרוטוקול AMANDA L7, h323 איזון עומס יהיה רק ​​לאזן H323 L7 פרוטוקול, IRC איזון העומס יהיה רק ​​איזון פרוטוקול IRX L7, netbios-ns האיזון עומס יהיה רק ​​איזון פרוטוקול NETBIOS-NS.
מצב	מחרוזת	מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה.
החברים	מחרוזת	IP של החווה, שבו השירות וירטואלי מקשיב.
גווניה	מחרוזת	נמל של החווה, שבו השירות וירטואלי מקשיב. נמל ייחודי ניתן especified, נמל טווח יכול להיות especified עם מפריד : ואת מספר יציאות ניתן especified עם מפריד ,.
חקלאי	מחרוזת	זהו שם FarmGuardian כי הוא בודק את מצב backend. FarmGuardian יהיה פועל בעוד החווה נמצאת במעמד.

אובייקט Backend עבור חוות L4xNAT:

שדה	סוּג	תיאור
id	מספר	מזהה כדי לזהות את backend בחווה.
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.
מצב	מחרוזת	מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק.
עדיפות	מספר	זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר ו- 9 הוא העדיפות הנמוכה ביותר.
מִשׁקָל	מספר	זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. הערכים האפשריים הם מ 1 ל 9.

יצירת חוות חדשה

יצירת חוות חדשה

דוגמה לבקשה:

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/v4.0/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","newfarmname":"l4farm", "protocol":"tcp",
"nattype":"nat","vip":"178.62.126.152","vport":"81"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/newfarml4

PUT /farms/<farmname>

שנה את התצורה של חוות L4xNAT.

פרמטרים של בקשה

שדה	סוּג	תיאור
newfarmname	מחרוזת	שם החווה החדשה. את החווה חייבים לעצור את זה.
אַלגוֹרִיתְם	מחרוזת	סוג של אלגוריתם איזון עומס המשמש בחווה. האפשרויות הן: מִשׁקָל חיבור שיגור ליניארי לפי משקל, מקור המקור Hash לכל מקור IP ו- Source, פשוט המקור Hash לכל מקור IP בלבד, סימטרי חשיש הנסיעה הלוך ושוב לכל IP ופורט.
nattype	מחרוזת	איך שכבת איזון שכבת 4 הליבה הולך לפעול. האפשרויות הן: נת המכונה גם מצב sNAT, backend מגיב לאיזון עומס על מנת לשלוח את התגובה ללקוח, dnat backend יגיב ישירות ללקוח, איזון עומס צריך להיות מוגדר כשער בשרת backend, Dsr לחזור שרת ישיר, איזון עומס לשנות את MAC היעד והתגובה הולכת ישירות ללקוח.
פרוטוקול	מחרוזת	פרוטוקול להיות מאוזן בשכבה 4. האפשרויות הן: את כל הפרופיל יהיה לטעון איזון כל פרוטוקול L4, TCP איזון העומס יהיה רק ​​איזון פרוטוקול TCP L4, UDP איזון העומסים יאזן רק את פרוטוקול UDP L4, לגימה איזון העומס יהיה רק ​​לאזן את SIP או פרוטוקול VoIP L7, FTP את איזון עומס רק לאזן את פרוטוקול L7 FTP, tftp את איזון עומס רק לאזן TFTP L7 פרוטוקול, sctp איזון עומסים רק לאזן את פרוטוקול SCTP L4, אמנדה איזון העומסים יאזן רק את פרוטוקול AMANDA L7, h323 איזון עומס יהיה רק ​​לאזן H323 L7 פרוטוקול, IRC איזון העומס יהיה רק ​​איזון פרוטוקול IRX L7, netbios-ns מאזן העומס יאזן רק את פרוטוקול NETBIOS-NS, PPTP מאזן העומס יאזן רק את פרוטוקול H323 L7.
החברים	מחרוזת	IP של החווה, שבו השירות וירטואלי מקשיב.
גווניה	מחרוזת	נמל של החווה, שבו השירות וירטואלי מקשיב. נמל ייחודי ניתן especified, נמל טווח יכול להיות especified עם מפריד : ואת מספר יציאות ניתן especified עם מפריד ,.

דוגמה לתגובה:

{
   "description" : "Modify farm l4farm",
   "params" : {
      "algorithm" : "weight",
      "nattype" : "nat",
      "newfarmname" : "l4farm",
      "protocol" : "tcp",
      "vip" : "178.62.126.152",
      "vport" : "81"
   }
}

פרמטרים של תגובה

התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.

הוסף FarmGuardian

הוסף FarmGuardian

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"check_tcp-cut_conns"}' https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4Farm/fg

POST /farms/<farmname>/fg

החל FarmGuardian לחווה.

פרמטרים של בקשה

שדה	סוּג	תיאור
שם	מחרוזת	מזהה ייחודי של FarmGuardian. FarmGuardians נוצרים ושונה בסעיף ניטור.

דוגמה לתגובה:

{
   "description" : "Add the farm guardian check_tcp-cut_conns to the farm fgl4",
   "message" : "Success, The farm guardian check_tcp-cut_conns was added to the farm fgl4"
}

הסר FarmGuardian

הסר FarmGuardian

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4Farm/fg/check_tcp-cut_conns

DELETE /farms/<farmname>/fg/<name>

הסר את FarmGuardian מן החווה.

דוגמה לתגובה:

{
   "description" : "Remove the farm guardian check_tcp-cut_conns from the farm fgl4",
   "message" : "Sucess, check_tcp-cut_conns was removed from the farm fgl4"
}

L4xNAT - Backends

רשימת backends

רשימת backends

דוגמה לבקשה:

curl  -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4farm/backends

GET /farms/<farmname>/backends

קבל את רשימת backends בשירות.

דוגמה לתגובה:

{
   "description" : "List backends",
   "params" : [
      {
         "id" : 0,
         "ip" : "192.5.1.1",
         "priority" : 1,
         "status" : "up",
         "weight" : 1
      },
      {
         "id" : 1,
         "ip" : "192.5.1.3",
         "priority" : 2,
         "status" : "up",
         "weight" : 1
      },
   ]
}

פרמטרי תגובה

שיחה זו מחזירה מערך אובייקט backend עם הפרמטרים השוררים.

שדה	סוּג	תיאור
id	מספר	מזהה כדי לזהות את backend בחווה.
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.
מצב	מחרוזת	מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק.
עדיפות	מספר	זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר ו- 9 הוא העדיפות הנמוכה ביותר.
מִשׁקָל	מספר	זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. הערכים האפשריים הם מ 1 ל 9.

צור Backend חדש

צור Backend חדש

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.100"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4farm/backends

POST /farms/<farmname>/backends

צור Backend חדש בחווה L4xNAT.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.	נָכוֹן
עדיפות	מספר	זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר ו- 9 הוא העדיפות הנמוכה ביותר.
מִשׁקָל	מספר	זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. הערכים האפשריים הם מ 1 ל 9.

דוגמה לתגובה:

{
   "description" : "New farm backend",
   "message" : "Backend added",
   "params" : {
      "id" : 5,
      "ip" : "192.168.5.100",
      "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","priority":4,"weight":7}'
  https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4farm/backends/2

PUT /farms/<farmname>/backends/<id>

שינוי הפרמטרים של backend בשירות של חוות L4xNAT. id הוא מזהה ייחודי backend.

פרמטרים של בקשה

שדה	סוּג	תיאור
ip	מחרוזת	ה- IP של Backend שבו השירות האמיתי מאזין.
עדיפות	מספר	זהו ערך העדיפות עבור השרת האמיתי הנוכחי. הקשרים תמיד לפריו הכי זמין כאשר 1 הוא העדיפות הגבוהה ביותר ו- 9 הוא העדיפות הנמוכה ביותר.
מִשׁקָל	מספר	זהו ערך המשקל עבור השרת האמיתי הנוכחי. גיבויים עם משקל רב יותר יקבלו יותר חיבורים. הערכים האפשריים הם מ 1 ל 9.

דוגמה לתגובה:

{
   "description" : "Modify backend",
   "message" : "Backend modified",
   "params" : {
      "ip" : "192.168.5.40",
      "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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/farms/l4farm/backends/4

DELETE /farms/<farmname>/backends/<id>

מחיקת backend נתון בשירות של חוות L4xNAT.

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://<zevenet_server>:444/zapi/v4.0/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; או שקר, הממשק לא קיבל שום ממשק 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/v4.0/zapi.cgi/interfaces/gateway/ipv4

GET /interfaces/gateway/<ip_version>

שער ברירת המחדל הוא הצומת שבה נשלח כל תעבורת היעד שאינה ניתנת להשגה מקומית מכל ממשק בממשק העומס.

קבל את הפרמטרים של ממשק שער ברירת המחדל.

המערכת הוגדרה שני שערים, פעם אחת כדי לנתב את IPv4 ואת השני כדי לנתב את IPv6. ה- URI מצפה לגרסת IP ipv4 or ipv6.

דוגמה לתגובה:

{
   "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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/interfaces/gateway/ipv4

PUT /interfaces/gateway/<ip_version>

שינוי התצורה של ממשק השער.

URI מצפה לגרסת ה- IP המשמשת בשדה הכתובת. הערכים האפשריים הם ipv4 ו ipv6.

דוגמה לתגובה:

{
   "description" : "Modify default gateway",
   "message" : "The default gateway has been changed successfully",
   "success" : "true"
}

פרמטרים של בקשה

שדה	סוּג	תיאור
כתובת	מחרוזת	זהו ה- IP של השער.
ממשק	מחרוזת	שם הממשק עבור השער.

מחק את תצורת השער

DELETE /interfaces/gateway/<ip_version>

מחק את התצורה של תצורת ברירת המחדל של שער השער.

ה- URI מצפה לגירסת IP אחת של שער ברירת המחדל למחיקה. הערכים האפשריים הם ipv4 ו ipv6.

אזהרה: אם השער הוא disconfigured, Zevenet הוא לא הולך להיות נגיש מתוך קטע רשת חיצוני.

מחק את תצורת השער

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/interfaces/gateway/ipv4

הודעת תגובה

אם השער אינו מוגדר מאותו קטע רשת, הודעה זו תופיע, אחרת החיבור יפסיד.

דוגמה לתגובה:

{
   "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://<zevenet_server>:444/zapi/v4.0/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; או שקר, הממשק לא קיבל שום ממשק VLAN המלווה אותו.
מסכת רשת	מחרוזת	הגדר את קטע הרשת שבו פועל הממשק.
שער כניסה	מחרוזת	IP שימש לשלוח מנות לפלח רשת אחר.
מק	מחרוזת	קישור שכבת מזהה ייחודי. זה לא ניתן לשינוי.
שם	מחרוזת	שם הממשק. הוא משמש כמזהה ייחודי לממשק.
מצב	מחרוזת	הערכים יכולים להיות up, הממשק יכול לקבל מנות; מטה, הממשק אינו יכול לקבל מנות.

אחזור ממשק NIC

אחזור ממשק NIC

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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, vlan or וירטואלי. כל אחד מהם מוגדר בתפריט המשנה של הרשת.

שינוי ממשק 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://<zevenet_server>:444/zapi/v4.0/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",
      "force" : "true"
   }
}

פרמטרים של תגובה

התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.

מחיקת תצורת NIC

מחיקת תצורת NIC

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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",
      "force" : "true",
   }
}

פרמטרים של תגובה

התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.

מחק ממשק VLAN

מחק ממשק VLAN

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/interfaces/virtual/eth0:virtiface

PUT /interfaces/virtual/<name>

שינוי הפרמטרים של ממשק וירטואלי. שם הוא מזהה ייחודי של ממשק.

פרמטרים של בקשה

שדה	סוּג	תיאור	נדרש
ip	מחרוזת	IP של הממשק. ה- IP חייב להיות באותו קטע רשת מאשר בממשק האב.	נָכוֹן
כּוֹחַ	מחרוזת	אם חווה משתמשת בממשק, לא ניתן יהיה לשנות את הממשק. לאחר מכן, אם פרמטר זה נשלח עם הערך נָכוֹן, הממשק ייאלץ לקחת את התצורה החדשה וכל חוות משתמש ממשק יופעל מחדש.

דוגמה לתגובה:

{
   "description" : "Modify virtual interface",
   "params" : {
      "ip" : "192.168.100.10",
      "force" : "true"
   }
}

פרמטרים של תגובה

התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.

מחיקת ממשק וירטואלי

מחיקת ממשק וירטואלי

דוגמה לבקשה:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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://<zevenet_server>:444/zapi/v4.0/zapi.cgi/interfaces/virtual/eth0:virtiface/actions

POST /interfaces/virtual/<name>/actions

החל פעולה על ממשק וירטואלי. שיחה זו מאפשרת להפעיל או להשבית ממשק רשת.

שם הוא מזהה ייחודי של ממשק.

פרמטרים של בקשה

שדה	סוּג	תיאור	דרוש
פעולה	מחרוזת	פעולה כדי להחיל על הממשק. הערכים הזמינים הם: up, לאפשר לממשק ולהכין אותו לשימוש; מטה, להשבית את הממשק כדי לא לקבל או לא לשלוח מנות.	נָכוֹן

דוגמה לתגובה:

{
   "description" : "Action on virtual interface",
   "params" : {
      "action" : "down"
   }
}

פרמטרים של תגובה

התגובה תהיה json עם כל הערכים המבוקשים מעודכנים. ראה דוגמה לתגובה לקבלת מידע נוסף.

ניטור - FarmGuardian

FarmGuardian משמש למצב ניטור מתקדם של backends. כאשר בעיה מזוהה על ידי FarmGuardian משבית באופן אוטומטי את השרת האמיתי יהיה מסומן כמו ברשימה השחורה.

רשימת FarmGuardians

רשימת FarmGuardians

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/monitoring/fg

GET /monitoring/fg

רשימה של FarmGuardians. תבניות availabe FarmGuardians מופיעים ברשימה.

דוגמה לתגובה:

{
   "description" : "List farm guardian checks and templates",
   "params" : [
      {
         "command" : "check_tcp -p PORT -H HOST",
         "cut_conns" : "false",
         "description" : "It does a TCP connection to test if the backend is alive",
         "farms" : [],
         "interval" : 5,
         "log" : "false",
         "name" : "check_tcp-cut_conns",
         "template" : "true"
      },
      {
         "command" : "check_tcp -p 80 -H HOST",
         "cut_conns" : "false",
         "description" : "TCP check to the port 80",
         "farms" : [
                     "web_service",
                     "my_welcome_web"
         ],
         "interval" : 7,
         "log" : "true",
         "name" : "custom-tcp",
         "template" : "false"
      },
      {
         "command" : "check_tcp -p PORT -H HOST",
         "cut_conns" : "false",
         "description" : "It does a TCP connection to test if the backend is alive",
         "farms" : [],
         "interval" : 5,
         "log" : "false",
         "name" : "check_tcp",
         "template" : "true"
      }
   ]
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור
הפקודה	מחרוזת	פקודה כדי לבדוק את מצב השירות ב- backend. פקודות זמינות אלה נמצאות בנתיב libexec.
cut_conns	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian חותך את הקשרים הנוכחי כאשר backend אינו זמין; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
תיאור	מחרוזת	תיאור זעיר על ההמחאה.
חוות	מחרוזת []	חוות שבהן החווה FarmGuardian מוחל.
הפסקה	מספר	זמן בין המחאות.
היכנס	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian יכנס כל המחאה; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
שם	מחרוזת	מזהה ייחודי.
תבנית	מחרוזת	אם FarmGuardian היא תבנית, היא לא תחול על אף חווה. התבניות שימושיות ליצירת FarmGuardian חדש.

אחזר FarmGuardian

אחזר FarmGuardian

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/monitoring/fg/check_tcp

GET /monitoring/fg/<name>

הצג את התצורה של FarmGuardian.

פרמטר URI שם הוא מזהה ייחודי FarmGuardian.

דוגמה לתגובה:

{
   "description" : "Retrive the farm guardian check_tcp",
   "params" : {
      "command" : "check_tcp -p PORT -H HOST",
      "cut_conns" : "false",
      "description" : "It does a TCP connection to test if the backend is alive",
      "farms" : [],
      "interval" : 5,
      "log" : "false",
      "name" : "check_tcp",
      "template" : "true"
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור
הפקודה	מחרוזת	פקודה כדי לבדוק את מצב השירות ב- backend. פקודות זמינות אלה נמצאות בנתיב libexec.
cut_conns	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian חותך את הקשרים הנוכחי כאשר backend אינו זמין; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
תיאור	מחרוזת	תיאור זעיר על ההמחאה.
חוות	מחרוזת []	חוות שבהן החווה FarmGuardian מוחל.
הפסקה	מספר	זמן בין המחאות.
היכנס	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian יכנס כל המחאה; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
שם	מחרוזת	מזהה ייחודי.
תבנית	מחרוזת	אם FarmGuardian היא תבנית, היא לא תשתנה. התבניות שימושיות ליצירת FarmGuardian חדש או להחיל ישירות על חוות.

יצירת FarmGuardian

יצירת FarmGuardian

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"check_tcp-cut_conns", "parent":"check_tcp"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/monitoring/fg

POST /monitoring/fg

צור FarmGuardian חדש.

פרמטרים של בקשה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור	דרוש
שם	מחרוזת	מזהה ייחודי.	נָכוֹן
הורה	מחרוזת	זהו FarmGuardian משמש כתבנית כדי ליצור את FarmGuardian חדש. אם שדה זה לא נשלח, FarmGuardian החדש נוצר ריק.

דוגמה לתגובה:

{
   "description" : "Create a farm guardian check_tcp-cut_conns",
   "message" : "The farm guardian check_tcp-cut_conns has been created successfully",
   "params" : {
      "command" : "check_tcp -p PORT -H HOST",
      "cut_conns" : "false",
      "description" : "It does a TCP connection to test if the backend is alive",
      "farms" : [],
      "interval" : 5,
      "log" : "false",
      "name" : "check_tcp-cut_conns",
      "template" : "true"
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור
הפקודה	מחרוזת	פקודה כדי לבדוק את מצב השירות ב- backend. פקודות זמינות אלה נמצאות בנתיב libexec.
cut_conns	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian חותך את הקשרים הנוכחי כאשר backend אינו זמין; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
תיאור	מחרוזת	תיאור זעיר על ההמחאה.
חוות	מחרוזת []	חוות שבהן החווה FarmGuardian מוחל.
הפסקה	מספר	זמן בין המחאות.
היכנס	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian יכנס כל המחאה; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
שם	מחרוזת	מזהה ייחודי.
תבנית	מחרוזת	אם FarmGuardian היא תבנית, היא לא תשתנה. התבניות שימושיות ליצירת FarmGuardian חדש או להחיל ישירות על חוות.

שינוי FarmGuardian

שינוי FarmGuardian

דוגמה לבקשה:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"interval":7,"log":"true","description":"TCP check to the port 80","command":"check_tcp -p 80 -H HOST","cut_conns":"false"}'
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/monitoring/fg/custom-tcp

PUT /monitoring/fg/<name>

שינוי FarmGuardian.

פרמטר URI שם הוא מזהה ייחודי FarmGuardian.

פרמטרים של בקשה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור	דרוש
הפקודה	מחרוזת	פקודה כדי לבדוק את מצב השירות ב- backend. פקודות זמינות אלה נמצאות בנתיב libexec.
cut_conns	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian חותך את הקשרים הנוכחי כאשר backend אינו זמין; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
תיאור	מחרוזת	תיאור זעיר על ההמחאה.
הפסקה	מספר	זמן בין המחאות.
היכנס	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian יכנס כל המחאה; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
כּוֹחַ	מחרוזת	אם משק פועל משתמש ב- FarmGuardian, לא ניתן יהיה לשנות את FarmGuardian. לאחר מכן, אם פרמטר זה נשלח עם הערך נָכוֹן, FarmGuardian ייאלץ לקחת את התצורה החדשה.

דוגמה לתגובה:

{
   "description" : "Modify farm guardian custom-tcp",
   "message" : "Success, some parameters have been changed in farm guardian custom-tcp.",
   "params" : {
      "command" : "check_tcp -p 80 -H HOST",
      "cut_conns" : "false",
      "description" : "TCP check to the port 80",
      "farms" : [],
      "interval" : 7,
      "log" : "true",
      "name" : "custom-tcp",
      "template" : "false"
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם המפתח params ואת הפורמט להלן:

שדה	סוּג	תיאור
הפקודה	מחרוזת	פקודה כדי לבדוק את מצב השירות ב- backend. פקודות זמינות אלה נמצאות בנתיב libexec.
cut_conns	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian חותך את הקשרים הנוכחי כאשר backend אינו זמין; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
תיאור	מחרוזת	תיאור זעיר על ההמחאה.
חוות	מחרוזת []	חוות שבהן החווה FarmGuardian מוחל.
הפסקה	מספר	זמן בין המחאות.
היכנס	מחרוזת	הערכים האפשריים הם: נָכוֹן, FarmGuardian יכנס כל המחאה; או שקר, אם backend זה לא זמין, זה יהיה מושבת אבל המפגשים בחיים ממשיכים.
שם	מחרוזת	מזהה ייחודי.
תבנית	מחרוזת	אם FarmGuardian היא תבנית, היא לא תחול על אף חווה. התבניות שימושיות ליצירת FarmGuardian חדש.

מחק FarmGuardian

מחק FarmGuardian

דוגמה לבקשה:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/monitoring/fg/custom-tcp

DELETE /monitoring/fg/<name>

מחק מחווה.

פרמטר URI שם הוא מזהה ייחודי FarmGuardian.

דוגמה לתגובה:

{
   "description" : "Delete the farm guardian custom-tcp",
   "message" : "custom-tcp has been deleted successful.",
   "success" : "true"
}

ניטור - סטטיסטיקה

הצג מידע אודות מערכת ומשקים. מידע זה יהיה שימושי כדי לפקח על מצב איזון עומס Zevenet.

הצג נתונים סטטיסטיים של המערכת

הצג נתונים סטטיסטיים של המערכת

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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.2 in in" : 0,
         "eth0.2 out out" : 0,
         "eth1 in in" : 234.72,
         "eth1 out out" : 0,
         "eth2 in in" : 234.72,
         "eth2 out out" : 0,
         "eth3 in in" : 0,
         "eth3 out out" : 0,
         "eth4 in in" : 436.89,
         "eth4 out out" : 4300.38,
         "eth4.6 in in" : 0,
         "eth4.6 out out" : 0,
         "eth5 in in" : 301.39,
         "eth5 out out" : 0,
         "eth5.5 in in" : 0,
         "eth5.5 out out" : 0,
         "eth6 in in" : 77.42,
         "eth6 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/v4.0/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" : "77.42",
            "interface" : "eth6",
            "out" : "0.00"
         },
         {
            "in" : "2703.88",
            "interface" : "eth0",
            "out" : "50917.65"
         }
      ]
   }
}

פרמטרים של תגובה

התגובה תהיה JSON עם מפתח params אשר ערך הוא אובייקט עם המפתחות followeing:

שדה	סוּג	תיאור
נתונים	מחרוזת	תאריך מערכת.
המארח	מחרוזת	שם המארח.
ממשקים	אובייקט []	נתונים סטטיסטיים של תעבורת הרשת.

ממשקי אובייקט

שדה	סוּג	תיאור
in	מחרוזת	סה"כ תעבורת קלט ב- MB.
ממשק	מחרוזת	שם הממשק.
הַחוּצָה	מחרוזת	סך כל התפוקה.

הצג נתונים סטטיסטיים של ממשקים

הצג נתונים סטטיסטיים של ממשקים

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/system/network/interfaces

GET /stats/system/network/interfaces

קבל סיכום של כל ממשק רשת.

דוגמה לתגובה:

{
   "description" : "Interfaces info",
   "params" : {
      "nic" : [
         {
            "in" : "77.42",
            "interface" : "eth6",
            "ip" : "",
            "mac" : "ea:00:7d:88:1d:bd",
            "out" : "0.00",
            "status" : "up",
            "virtual" : [],
            "vlan" : []
         },
         {
            "in" : "2704.81",
            "interface" : "eth0",
            "ip" : "192.168.101.46",
            "mac" : "9e:2e:3e:a5:2e:6a",
            "out" : "51039.13",
            "status" : "up",
            "virtual" : [
               "eth0:1",
               "eth0:2",
               "eth0.2:6"
            ],
            "vlan" : [
               "eth0.2"
            ]
         },
         {
            "in" : "234.72",
            "interface" : "eth1",
            "ip" : "192.168.101.58",
            "mac" : "c2:d0:d7:64:df:68",
            "out" : "0.00",
            "status" : "up",
            "virtual" : [],
            "vlan" : []
         },
         {
            "in" : "234.72",
            "interface" : "eth2",
            "ip" : "",
            "mac" : "3a:3a:a7:e3:33:73",
            "out" : "0.00",
            "status" : "up",
            "virtual" : [],
            "vlan" : []
         },
         {
            "in" : "0.00",
            "interface" : "eth3",
            "ip" : "192.168.101.72",
            "mac" : "16:97:ab:43:87:02",
            "out" : "0.00",
            "status" : "down",
            "virtual" : [
               "eth3:1",
               "eth3:8",
               "eth3:6"
            ],
            "vlan" : []
         },
         {
            "in" : "436.89",
            "interface" : "eth4",
            "ip" : "",
            "mac" : "ea:00:7d:88:1d:bd",
            "out" : "4300.38",
            "status" : "up",
            "virtual" : [
               "eth4.6:5"
            ],
            "vlan" : [
               "eth4.6"
            ]
         },
         {
            "in" : "301.39",
            "interface" : "eth5",
            "ip" : "",
            "mac" : "ea:00:7d:88:1d:bd",
            "out" : "0.00",
            "status" : "up",
            "virtual" : [],
            "vlan" : [
               "eth5.5"
            ]
         }
      ]
   }
}

פרמטרים של תגובה

התגובה תהיה JSON עם מפתח params שהערך שלו הוא אובייקט עם המפתח nic.

שדה	סוּג	תיאור
nic	אובייקט []	נתונים סטטיסטיים ממשק.

אובייקט Nic:

שדה	סוּג	תיאור
in	מחרוזת	סה"כ תעבורת קלט ב- MB.
ממשק	מחרוזת	שם הממשק משמש כמזהה ייחודי.
ip	מחרוזת	ה- IP של הממשק.
מק	מחרוזת	ממשק ה- MAC.
הַחוּצָה	מחרוזת	סה"כ תעבורת פלט ב- MB.
מצב	מחרוזת	מצב ממשק. הערך יכול להיות מטה, הממשק מושבת; up, הממשק מאופשר.
וירטואלי	מחרוזת []	ממשקים וירטואליים שירשו מממשק זה.
vlan	מחרוזת []	ממשקי VLAN היורשים מממשק זה.

הצג נתונים סטטיסטיים של זיכרון

הצג נתונים סטטיסטיים של זיכרון

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/system/memory

GET /stats/system/memory

קבל סיכום של זיכרון המערכת.

דוגמה לתגובה:

{
   "description" : "Memory usage",
   "params" : {
      "Buffers" : 1.01,
      "Cached" : 42.47,
      "MemFree" : 880.11,
      "MemTotal" : 2005.01,
      "MemUsed" : 1124.91,
      "SwapCached" : 8.27,
      "SwapFree" : 565.15,
      "SwapTotal" : 672,
      "SwapUsed" : 106.84,
      "date" : "Fri Jan 27 12:27:11 2017",
      "hostname" : "api3"
   }
}

פרמטרים של תגובה

התגובה תהיה JSON עם מפתח params שערכו הוא אובייקט זיכרון.

זכרון אובייקט.

שדה	סוּג	תיאור
חוצצים	מספר	זהו הזיכרון המשמש את המאגרים. סכום זה מצוין ב- 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/v4.0/zapi.cgi/stats/system/load

GET /stats/system/load

קבל סיכום של עומס מערכת ה- CPU.

דוגמה לתגובה:

{
   "description" : "System load",
   "params" : {
      "Last_1" : 0.66,
      "Last_15" : 0.39,
      "Last_5" : 0.49,
      "date" : "Fri Jan 27 13:15:01 2017",
      "hostname" : "api3"
   }
}

פרמטרים של תגובה

שדה	סוּג	תיאור
Last_1	מספר	טען את השימוש במערכת בפעם האחרונה.
Last_5	מספר	טען את השימוש בחמש הדקות האחרונות.
Last_15	מספר	טען את השימוש במערכת במשך חמש עשרה הדקות האחרונות.
נתונים	מחרוזת	תאריך מערכת.
המארח	מחרוזת	שם המארח.

הצג נתונים סטטיסטיים של CPU

הצג נתונים סטטיסטיים של CPU

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/system/cpu

GET /stats/system/cpu

דוגמה לתגובה:

{
   "description" : "System CPU usage",
   "params" : {
      "cores" : 2,
      "date" : "Fri Jan 27 13:30:52 2017",
      "hostname" : "api3",
      "idle" : 94.9,
      "iowait" : 0,
      "irq" : 0,
      "nice" : 0,
      "softirq" : 0,
      "sys" : 3.06,
      "usage" : 5.1,
      "user" : 2.04
   }
}

פרמטרים של תגובה

שדה	סוּג	תיאור
ליבות	מספר	מספר הליבות במעבד.
להתבטל	מספר	CPU לא להשתמש על ידי כל תוכנית.
כן	מספר	מעבד המשמש בתהליך קלט או פלט.
Irq	מספר	מעבד המשמש interropcions חומרה.
נחמד	מספר	עדיפות תזמון CPU.
רך	מספר	CPU המשמשים interrrupcions תוכנה.
sys	מספר	CPU המשמש את המערכת.
שימוש	מספר	סה"כ מעבד משומש.
המשתמש	מספר	CPU המשמש את המשתמש.
נתונים	מחרוזת	תאריך מערכת.
המארח	מחרוזת	שם המארח.

הצג נתונים סטטיסטיים של חיבורים

הצג נתונים סטטיסטיים של חיבורים

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/system/connections

GET /stats/system/connections

קבל את סך החיבורים הנוכחיים במערכת. הדלפק מסכם כל סוג של חיבורים במעקב: ASSURED, ESTABLISHED, SYN_SENT, TIME_WAIT, LISTEN ...

דוגמה לתגובה:

{
   "description" : "System connections",
   "params" : {
      "connections" : 324
   }
}

פרמטרים של תגובה

שדה	סוּג	תיאור
חיבורים	מספר	סך כל החיבורים המעוקבים בפועל.

הצג מספר חוות

הצג מספר חוות

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/farms/total

GET /stats/farms/total

הצג את סך החוות שנוצרו במערכת.

דוגמה לתגובה:

{
   "description" : "Number of farms.",
   "number" : 8
}

פרמטרים של תגובה

שדה	סוּג	תיאור
מספר	מספר	זהו מספר החוות הקיימות במערכת.

הצג נתונים סטטיסטיים של חוות

הצג נתונים סטטיסטיים של חוות

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/zapi.cgi/stats/farms/farmname

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" : 1,
         "id" : 5,
         "ip" : "192.168.5.100",
         "pending" : 0,
         "port" : "8080",
         "status" : "up"
      }
   ],
   "description" : "List farm stats",
   "sessions" : [
      {
         "id" : 5,
         "session" : "192.168.5.100"
      }
   ]

}

פרמטרי תגובה בחוות L4xNAT

התגובה תהיה JSON עם אובייקט backends ו הפעלות:

אובייקט Backend:

שדה	סוּג	תיאור
נוסד	מספר	סך כל הקשרים הקיימים.
id	מספר	מזהה ייחודי של Backend.
ip	מחרוזת	IP שבו השירות האמיתי מקשיב.
תלוי ועומד	מספר	מספר החיבורים הממתינים.
נמל	מספר	נמל שבו השירות האמיתי מקשיב.
מצב	מחרוזת	מצב אחורה. הערכים האפשריים הם: up, החווה פועלת ואת backend הוא מוכן לקבל חיבורים; מטה, החווה פועלת והשירות זיהה כי backend לא עובד; תחזוקה, backend מסומן כלא מוכן לקבלת חיבורים על ידי מנהל המערכת, אפשרות זו שימושית למשימות התחזוקה של backend; לא מוגדר, מצב backend לא נבדק.

אובייקט מושב:

שדה	סוּג	תיאור
id	מספר	אחורה מזהה ייחודי שבו הלקוח מוקצה.
מושב	מחרוזת	מזהה ייחודי של פעילות באתר. זהו ה- IP של הלקוח.

פרמטרי תגובה בחוות datalink

הנתונים הסטטיסטיים של Datalink אינם זמינים בפועל.

הצגת מצב מודול

הצגת מצב מודול

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/farms/modules

GET /stats/farms/modules

קבל סיכום של נתונים סטטיסטיים של מודולים. שיחה זו מציגה כל מצב מודול, מספר התצורה, מספר החוות המוטלות ומעלה.

ההגדרה על מודולים היא ב חוות סָעִיף.

דוגמה לתגובה:

{
   "description" : "Module status",
   "params" : {
      "dslb" : {
         "critical" : 0,
         "down" : 1,
         "problem" : 0,
         "total" : 2,
         "up" : 1
      },
      "lslb" : {
         "critical" : 0,
         "down" : 2,
         "problem" : 0,
         "total" : 4,
         "up" : 2
      }
   }
}

פרמטרים של תגובה

התגובה תהיה JSON עם שלושה מפתחות: dslb ו לסלב.

שדה	סוּג	תיאור
קריטי	מספר	מספר חוות במצב קריטי. החווה היא קריטית כאשר היא מעלה את כל backends הם בלתי מושגת (למטה או תחזוקה).
מטה	מספר	מספר חוות הפסיקו. החוות נעצרות על ידי מנהל המערכת.
בְּעָיָה	מספר	מספר חוות במצב בעיה. החווה היא בעיה כאשר היא למעלה כמעט backend הוא במצב למטה.
סה"כ	מספר	מספר החוות.
up	מספר	מספר החוות הפועלות. הנה מוצג maintenanced ו צריך להפעיל מחדש את מצב החווה.

הצג נתונים סטטיסטיים של מודול

הצג נתונים סטטיסטיים של מודול

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/stats/farms/modules/lslb

GET /stats/farms/modules/<module>

הצג נתונים סטטיסטיים של חוות דעת של מודול מסוים.

הערכים הזמינים עבור מודול הפרמטר הם: לסלב or dslb.

דוגמה לתגובה:

{
   "description" : "List lslb farms stats",
   "farms" : [
      {
         "established" : 0,
         "farmname" : "newfarm",
         "pending" : 0,
         "profile" : "http",
         "status" : "up",
         "vip" : "192.168.100.199",
         "vport" : "40"
      },
      {
         "established" : 0,
         "farmname" : "nwl4farm",
         "pending" : 0,
         "profile" : "l4xnat",
         "status" : "down",
         "vip" : "192.168.100.241",
         "vport" : "88"
      },
      {
         "established" : 0,
         "farmname" : "l4farm",
         "pending" : 0,
         "profile" : "l4xnat",
         "status" : "up",
         "vip" : "192.168.100.102",
         "vport" : "70"
      }
   ]
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם מידע על חוות במודול.

שדה	סוּג	תיאור
נוסד	מספר	סך כל הקשרים הקיימים.
שם החווה	מחרוזת	שם החווה, מזהה ייחודי עבור חוות.
תלוי ועומד	מספר	מספר החיבורים הממתינים.
פרופיל	מחרוזת	סוג החווה. הערכים האפשריים הם: DataLink, l4xnat, http or https. כל פרופיל מוגדר בסעיף עצמי.
מצב	מחרוזת	מצב משק. ערכי הסטטוס הזמינים הם: מטה, החווה אינה פועלת; יש צורך מחדש, החווה היא למעלה אבל זה תלוי ועומד על הפעלה מחדש; קריטי, החווה היא למעלה כל backends הם בלתי מושגת או תחזוקה; בְּעָיָה, החווה היא מעלה ויש כמה backend בלתי מושגת, אבל כמעט backend הוא במעמד; תחזוקה, החווה היא מעלה ויש backends במעמד למעלה, אבל כמעט backend נמצא במצב תחזוקה; up, החווה היא מעלה את כל backends הם עובדים בהצלחה.
החברים	מחרוזת	IP של החווה, שבו השירות וירטואלי מקשיב.
גווניה	מחרוזת	נמל של החווה, שבו השירות וירטואלי מקשיב.

ניטור - גרפים

סעיף זה שימושי כדי לפקח על המערכת הפנימית איזון עומס כדי לזהות בעיות באמצעות הפרמטרים של השימוש ב- CPU, זיכרון החלפה, זיכרון RAM, כל ממשקי Nework מוגדר, לטעון אחסון דיסק קשיח.

כמו כן, תוכל לגשת להיסטוריה השבועית, העשירה והשנתית.

גרפים עם מידע הם הגיבו בפורמט base64.

רשימת תרשימים זמינים

רשימת תרשימים זמינים

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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",
      "eth2",
      "eth1",
      "eth3",
      "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/v4.0/zapi.cgi/graphs/farms/httpweb

בקש דוגמה עבור ממשק:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/graphs/interfaces/eth3

בקש דוגמה לדיסק:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/zapi.cgi/graphs/farms/httpweb/daily

בקש דוגמה עבור ממשק:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/graphs/interfaces/eth3/monthly

בקש דוגמה לדיסק:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/zapi.cgi/system/supportsave > supportsave.tar.gz

GET /system/supportsave

קבל תמונת מצב מערכת עם כל התצורה והתהליך הפועלים במערכת. זה תומך יש צורך למצוא בעיות או תמיכה.

אחזר את המשתמש הנוכחי

אחזר את המשתמש הנוכחי

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/system/users

GET /system/users

הצג מידע על המשתמש הנוכחי. המשתמש הנוכחי הוא מקבל את המשתמש ZAPI_KEY או המשתמש שנרשם על ידי webgui

דוגמה לתגובה:

{
   "description" : "Retrieve the user root",
   "params" : {
      "user" : "root",
      "zapi_permissions" : "true"
   }
}

פרמטרים של תגובה

התגובה תהיה אובייקט JSON עם מערך של הפרמטרים הבאים.

שדה	סוּג	תיאור
המשתמש	מחרוזת	זה הבעלים של המשתמש ZAPI_KEY. זה יכול להיות המשתמש ברירת המחדל השורש.
zapi_permissions	מחרוזת	אם הערך הוא נָכוֹן, המשתמש יכול להשתמש ב- API של Zevenet באמצעות zapikey של המשתמש; או אם הערך הוא שקר, המשתמש ביטל את השימוש ב- zapi.

שנה את המשתמש הנוכחי

שנה את המשתמש הנוכחי

דוגמה לבקשה:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"password":"CDe0c3ck","newpassword":"v2mfcvv2","zapi_permissions":"false","zapikey":"vCeH60mQFf2MgH5"}'

https://<zevenet_server>:444/zapi/v4.0/zapi.cgi/system/users

POST /system/users

שינוי התצורה של המשתמש הנוכחי. המשתמש הנוכחי הוא מקבל את המשתמש ZAPI_KEY או המשתמש שנרשם על ידי webgui.

פרמטרים של בקשה:

שדה	סוּג	תיאור	דרוש
זאפיקי	מחרוזת	לכל משתמש יכול להיות zapikey. באמצעות zapikey זה המשתמש יכול לבצע פעולה באמצעות zapikey עם ההרשאות של תפקיד המשתמש.
zapi_permissions	מחרוזת	הערכים האפשריים הם: נָכוֹן, על מנת לאפשר גישה לאיזון העומסים באמצעות הזאפי; או שקר, כדי לא לאפשר את הגישה דרך zapi.
סיסמה חדשה	מחרוזת	סיסמת משתמש חדשה כדי לגשת דרך האינטרנט.
סיסמא	מחרוזת	סיסמת משתמש נוכחי.	זה נדרש כאשר סיסמה חדשה נשלח.

דוגמה לתגובה:

{
   "description" : "Modify the user Shadi",
   "message" : "Settings was changed successful."
}

רשימת קובצי יומן

רשימת קובצי יומן

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/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/v4.0/zapi.cgi/system/logs/syslog.2.gz > log.gz

GET /system/logs/<file>

הורד קובץ יומן של קובצי היומן הזמינים המפורטים בעת בקשת GET.

פילה הוא מזהה הקובץ היומן הייחודי.

מערכת - גיבויים

בעזרת אפשרות הגיבוי תוכל לשמור את תצורת המערכת הנוכחית ולהוריד אותה.

בסעיף זה, תוכל ליצור, לשחזר, להעלות ולהוריד קבצי גיבוי.

רשימת גיבויים

רשימת גיבויים

דוגמה לבקשה:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/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/v4.0/zapi.cgi/system/backup/firstConf/actions

POST /system/backup/<name>/actions

שחזור התצורה מקובץ גיבוי. שם הוא מזהה הגיבוי הייחודי.

פרמטרים של בקשה

שדה	סוּג	תיאור
פעולה	מחרוזת	כדי לשחזר את תצורת הגיבוי, הערך חייב להיות להגיש מועמדות.

דוגמה לתגובה:

{
   "description" : "Apply a backup to the system",
   "params" : {
      "action" : "apply"
   }
}