Zevenet API v3 viide

ZAPI (Zeveneti rakenduse programmeerimisliides) on süsteemi administraatori Zeveneti koormuse tasakaalustaja käitumise vahend.

Enne kasutamist tuleb zapi kasutaja veebi kasutajaliidese abil aktiveerida. Süsteem / kasutajad.

Kui zapi kasutaja on loodud, on võimalik saata päring URL-ile, https: //zevenet_server: 444 / zapi / v3 / zapi.cgi /URI_path.

zevenet_server on IP, kus HTTP teenus kuulab.

URI_path määratleb toimingu või toimingu. Selle käitumine ja selle parameetrid määratletakse iga dokumendi osas.

Selles API-s kasutatavad tegusõnad on GET, POST, PUT or Kustuta. PUT- või POST-päring vajab alati peaaegu parameetrit, kuigi see ei vaja nõutavat parameetrit.

Sertifikaadid

Zevenet toetab PEM-vormingus cetificates, et neid HTTPS-kuulajaga HTTP-taludes kasutada. Kui soovite rohkem teada saada, kuidas pem-sertifikaate luua, külastage järgmist artiklit: PEM FORMATIS TUNNISTATUD SERTIFIKAADID

Loetlege kõik sertifikaadid

Loetlege kõik sertifikaadid

Päringu näide:

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

GET /certificates

Loetlege sertifikaatide poes kõik CSR- ja PEM-sertifikaadid, neid sertifikaate saab kasutada HTTPS-i põllumajandusettevõtetega.

Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on sertifikaatobjektide massiiv, millest igaüks sisaldab allpool toodud võtme atribuute.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
parameetrid	Objekt []	Sertifikaadi objektide loend.

Sertifikaadi objekt

Väli	KASUTUSALA	Kirjeldus
CN	nöör	Domeeni tavapärane nimi.
loomine	nöör	Loomise kuupäev.
aegumine	nöör	Aegumiskuupäev.
fail	nöör	Sertifikaadi failinimi, unikaalne ID.
emitent	nöör	Sertifitseeritud asutus, kes allkirjastab sertifikaadi.
tüüp	nöör	CSR või sertifikaat.

Lae sertifikaadi

Lae sertifikaadi

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem

GET /certificates/<file>

Laadige sertifikaatide kauplusesse installitud sertifikaat alla, kasutage failinime selle identifitseerimiseks.

Vastus sisaldab allpool toodud päiseid koos teabega faili kohta. Vastuse sisu on faili sisu.

Vastuse päised:

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

Näita sertifikaadi üksikasju

Näita sertifikaadi üksikasju

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem/info

GET /certificates/<file>/info

Näita sertifikaatide poes kogu antud sertifikaadis sisalduvat teavet, sealhulgas allkirju, on vajalik, et failinimi oleks viide.

Vastuse näide:

Certificate:
    Data:
        Version: 3 (0x2)
        Serial Number: 14346016480403539444 (0xc71749fb005a45f4)
    Signature Algorithm: sha1WithRSAEncryption
        Issuer: C=ES, ST=Spain, L=Spain, O=Sofintel, OU=Telecommunications, CN=Zen Load Balancer/emailAddress=zenloadbalancer-support@lists.sourceforge.net
        Validity
            Not Before: Jan 12 14:49:03 2011 GMT
            Not After : Jan  9 14:49:03 2021 GMT
        Subject: C=ES, ST=Spain, L=Spain, O=Sofintel, OU=Telecommunications, CN=Zen Load Balancer/emailAddress=zenloadbalancer-support@lists.sourceforge.net
        Subject Public Key Info:
            Public Key Algorithm: rsaEncryption
                Public-Key: (1024 bit)
                Modulus:
...

Kuva aktiveerimissertifikaadi andmed

Kuva aktiveerimissertifikaadi andmed

Päringu näide:

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

GET /certificates/activation

Näita kõiki aktiveerimissertifikaadis sisalduvaid andmeid, sealhulgas allkirju, see sertifikaat salvestatakse sertifikaatide salvestisse. Kui aktiveerimissertifikaat kustutatakse, lülitub toode välja.

Sertifikaadi kustutamine

Sertifikaadi kustutamine

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem

DELETE /certificates/<file>

Sertifikaatide poes kustutage sertifikaat failinime järgi.

Vastuse näide:

{
   "description" : "Delete certificate",
   "message" : "The Certificate example.pem has been deleted.",
   "success" : "true"
}

Aktiveerimissertifikaadi kustutamine

Aktiveerimissertifikaadi kustutamine

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/activation

DELETE /certificates/activation

Kustutage sertifikaatide kauplusesse installitud aktiveerimissertifikaat. Kui see sertifikaat kustutatakse, lülitatakse koormuse tasakaalustaja välja.

Vastuse näide:

{
   "description" : "Delete activation certificate",
   "message" : "The activation certificate has been deleted",
   "success" : "true"
}

Looge CSR-sertifikaat

Looge CSR-sertifikaat

Päringu näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"NewCSR","fqdn":"host.domain.com","division":"IT","organization":"Example Corp.",
"locality":"Madrid","state":"Madrid","country":"ES","mail":"info@domain.com"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates

POST /certificates

Loo sertifikaadi allkirjastamise taotlus (CSR-fail).

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
nimi	nöör	Sertifikaadi ID nimi.	tõsi
fqdn	nöör	Teie serveri täielikult kvalifitseeritud domeeninimi.	tõsi
jaotus	nöör	Sertifikaadiga tegelev organisatsiooni jaotus.	tõsi
organisatsioon	nöör	Teie organisatsiooni juriidiline nimi.	tõsi
asukoht	nöör	Linn, kus asub teie organisatsioon.	tõsi
riik	nöör	Riik / piirkond, kus teie organisatsioon asub.	tõsi
riik	nöör	Selle riigi kahekohaline ISO kood, kus teie organisatsioon asub.	tõsi
post	nöör	E-posti aadress, mida kasutatakse teie organisatsiooni poole pöördumiseks.	tõsi

Vastuse näide:

{
   "description" : "Create CSR",
   "message" : "Certificate NewCSR created",
   "success" : "true"
}

Laadige sertifikaat üles

Laadige sertifikaat üles

Päringu näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: text/plain'
--tcp-nodelay --data-binary @/local_path/to/example.pem
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem

POST /certificates/<file>

Laadige üles HTMPS-kuulajaga HTTP-põllumajandusettevõtete PEM-sertifikaat.

Nõuab parameetrit --tcp-nodelayja --data-binary faili üleslaadimiseks binaarrežiimis.

URI parameetrite taotlemine

Väli	KASUTUSALA	Kirjeldus	Nõutud
fail	nöör	Sertifikaadi salvestamiseks sertifikaadifaili nimi.	tõsi

Vastuse näide:

{
   "description" : "Upload PEM certificate",
   "message" : "Certificate uploaded",
   "success" : "true"
}

Laadige aktiveerimissertifikaat üles

Laadige aktiveerimissertifikaat üles

Päringu näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: text/plain'
--tcp-nodelay --data-binary @/path/to/example.pem
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/activation

POST /certificates/activation

Laadige PEM-vormingus aktiveerimissertifikaat üles, see sertifikaat on vajalik kõigi funktsioonide lubamiseks. See sertifikaat salvestatakse sertifikaatide salvestisse, kui sertifikaatide poes on aktiveerimissertifikaat, siis eelmine sertifikaat on üle kirjutatud.

Vastuse näide:

{
   "description" : "Upload activation certificate",
   "message" : "Activation certificate uploaded",
   "success" : "true"
}

Põllumajandusettevõtted

Zevenet suudab hallata liiklust kolmel erineval viisil, iga teed haldab erinev moodul, kohaliku teenuse koormuse tasakaalustaja või LSLB moodul, globaalse teenuse koormuse tasakaalustaja või GSLB moodul ja Datalink teenuse koormuse tasakaalustaja või DSLB moodul.

Kõik moodulid töötavad farmiprofiili kontseptsiooniga, põllumajandusprofiil on grupp parameetreid, mis on valmis tegema konkreetse toimingu võrguliiklusega, on oluline mõista, mida on võimalik teha iga põllumajandusprofiili jaoks, et saada Zevenet'i parimaid tulemusi ADC.

• LSLB: see moodul on võimeline töötama http ja l4xnat profiilifarmid. See toimib veebi tagasipööratud proksina või ruuterina
• GSLB: see moodul on võimeline töötama gslb profiili talu. See toimib domeeninimede serverina
• DSLB: see moodul on võimeline töötama andmelink profiili talu. See toimib lüüsi.

Loetlege kõik talud

Loetlege kõik talud

Päringu näide:

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

GET /farms

Loetlege kõik olemasolevad talud

Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on põllumajandusettevõtete jätkamise objektide massiivi, millest igaüks sisaldab allpool toodud võtme atribuute.

Farm Objekt

Väli	KASUTUSALA	Kirjeldus
farmname	nöör	Talu kirjeldav nimi. Seda kasutatakse unikaalse identifikaatorina.
profiil	nöör	Profiili tüüp, profiili olemasolevad väärtused on järgmised: http, https or l4xnat LSLB mooduli jaoks gslb GLSB mooduli ja andmelink DSLB mooduli jaoks
staatus	nöör	Talu olek, oleku olemasolevad väärtused on järgmised: up, talu töötab või alla, talu on peatatud
vip	nöör	Virtuaalne IP, kus talu saab liiklust
vport	nöör	Virtuaalne sadam, kus farm võtab liiklust, on pordi saadaolevad väärtused: pordi number profiilide [s], l4xnat ja gslb jaoks, pordide rühm, mis on eraldatud tähega „,” või pordivahemik, mis on eraldatud tähisega „:” l4xnati profiilide jaoks, l4xnat saab mõlemal eraldaja väärtusel (“,” ja “:”) kasutada samal väljal.

Vastuse näide:

{
   "description" : "List farms",
   "params" : [
      {
         "farmname" : "httpFarm",
         "profile" : "http",
         "status" : "up",
         "vip" : "192.168.101.146",
         "vport" : "81"
      }
   ]
}

Talu eemaldamine

Talu eemaldamine

Päringu näide:

curl --tlsv1 -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP

DELETE /farms/<farmname>

Kustuta põllumajandusettevõte oma ettevõtte nime identfier abil.

Vastuse näide:

{
  "description" : "Delete farm FarmHTTP",
  "message" : "The Farm FarmHTTP has been deleted.",
  "success" : "true"
}

Tehke tegevus talus

Tehke tegevus talus

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"stop"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmTCP/actions

PUT /farms/<farmname>/actions

Rakenda põllumajandusettevõttele toimingut, vaadake tegevuste tabeli Taotluse parameetrid.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Määrake soovitud toiming. Toimingud on järgmised: peatus, talu peatatakse. algus, alustatakse talu ja restart, talu peatatakse ja käivitatakse automaatselt.

Vastuse näide:

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

Vastuse parameetrid

Kui konfiguratsioonis ei ole probleeme, tagastab zapi soovitud toimingu.

HTTP talud

HTTP-profiil on täiustatud kihi 7 koormuse tasakaalustamine (või rakenduse kohaletoimetamise kontroller), millel on proxy-spetsiifilised omadused. See profiil pakub mõningaid funktsioone, nagu HTTPS-kihi 7 koormuse tasakaalustamine, kombineerituna SSL-laadimisega. See profiil on mõeldud veebiteenustele (kaasa arvatud veebirakendusserverid) ja kõikidele rakenduste protokollidele, mis põhinevad HTTP ja HTTPS protokollidel, nagu WebDav, RDP üle HTTP, ICA HTTP kaudu jne. Selleks, et konfigureerida seda põllumajandusprofiili, virtuaalne IP-aadress ja virtuaalne TCP-port on vajalik.

Too talu nime järgi

Too talu nime järgi

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm

GET /farms/<farmname>

Näita kõiki antud talu konfiguratsioone.

Vastuse näide:

{
   "description" : "List farm httpFarm",
   "ipds" : {
      "blacklists" : [
         "rem"
      ],
      "dos" : []
   },
   "params" : {
      "certlist" : [
         {
            "file" : "zencert.pem",
            "id" : 1
         }
      ],
      "cipherc" : "ALL",
      "ciphers" : "all",
      "contimeout" : 20,
      "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" : "down",
      "vip" : "192.168.100.211",
      "vport" : 200
   },
   "services" : [
      {
         "backends" : [],
         "cookiedomain" : "",
         "cookieinsert" : "false",
         "cookiename" : "",
         "cookiepath" : "",
         "cookiettl" : 0,
         "fgenabled" : "false",
         "fglog" : "false",
         "fgscript" : "",
         "fgtimecheck" : 5,
         "httpsb" : "false",
         "id" : "service3",
         "leastresp" : "false",
         "persistence" : "",
         "redirect" : "",
         "redirecttype" : "",
         "sessionid" : "",
         "ttl" : 0,
         "urlp" : "",
         "vhost" : ""
      },
      {
         "backends" : [
            {
               "id" : 0,
               "ip" : "192.168.0.168",
               "port" : 80,
               "status" : "up",
               "timeout" : null,
               "weight" : null
            }
         ],
         "cookiedomain" : "",
         "cookieinsert" : "false",
         "cookiename" : "",
         "cookiepath" : "",
         "cookiettl" : 0,
         "fgenabled" : "false",
         "fglog" : "false",
         "fgscript" : "tcp_check",
         "fgtimecheck" : 5,
         "httpsb" : "false",
         "id" : "srv",
         "leastresp" : "false",
         "persistence" : "",
         "redirect" : "",
         "redirecttype" : "",
         "sessionid" : "",
         "ttl" : 0,
         "urlp" : "",
         "vhost" : ""
      },
   ]
}

Vastuse parameetrid

Vastus on JSON-objekt, mille formaat on allpool.

Farm Objekt:

Väli	KASUTUSALA	Kirjeldus
ipds	objekt	Selle talu IPDS-reeglite loetelu.
parameetrid	objekt	Põllumajandusettevõtte konfiguratsiooni parameetrid.
teenused	Objekt []	Koostage kõik selles talus loodud teenused ja selle konfiguratsioon.

IPDS-objekt:

Väli	KASUTUSALA	Kirjeldus
mustad nimekirjad	String []	Põllumajandusettevõtte suhtes kohaldatakse musta nimekirja reegleid.
dos	String []	Põllumajandusettevõtte suhtes kohaldatavad DoS-reeglid.

HTTP-põllumajandusettevõtete parameetrite objekt:

Väli	KASUTUSALA	Kirjeldus
certlist	Objekt []	Ainult https-profiilis. Põllumajandusettevõttes aktiveeritud sertifikaatide nimekiri, pem-vormingus, võib SNI-toe jaoks samasse talusse lisada rohkem kui ühe pem-sertifikaadi. nõutav https-väärtusega kuulaja. Siin võib kasutada kõiki sertifikaatide poe sertifikaate.
cipherc	nöör	Ainult https kuulaja. See on lubatud krüpteeringute loend, mida SSL-ühendus aktsepteerib, mis on string, mis on samas formaadis kui OpenSSL-i šifreerides. Seda atribuuti kasutatakse ainult siis, kui salakirjad väljal on väärtuse õmblusväärtus.
salakirjad	nöör	Ainult https-väärtusega kuulaja. Kasutatakse SSL-ühenduste poolt aktsepteeritud šifrite loendi koostamiseks, et SSL-ühendust tugevdada. Valikud on järgmised: kõik, kõik krüptid aktsepteeritakse, kõrge turvalisus, aktsepteeritakse ainult kõrge turvalisusega šifreid või tollikindlust, laaditakse ainult šifrid cipherc valdkonnas.
contimeout	Number	Kui kaua talu ootab TCP ühendus backendiga sekundites.
error414	nöör	Isikupärastatud teade 414i HTTP-veakoodiga vastamiseks.
error500	nöör	Isikupärastatud teade 500i HTTP-veakoodiga vastamiseks.
error501	nöör	Isikupärastatud teade 501i HTTP-veakoodiga vastamiseks.
error503	nöör	Isikupärastatud teade 503i HTTP-veakoodiga vastamiseks.
httpverb	nöör	See väli näitab operatsioone, mis lubatakse HTTP-kliendi taotlustele. saadaolevad väärtused on: standardHTTP, vastuvõetamatud http-taotlused GET, POST, HEAD. expandHTTP, aktsepteeritud eelmised http-taotlused pluss PUT, DELETE. standardWebDAV, aktsepteeritud eelmised http-taotlused pluss LOCK, UNLOCK, PROPFIND, PROPPATCH, SEARCH, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV aktsepteeritud eelmised http-taotlused ja SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT või MSRPCext, aktsepteerisid eelmised http-päringud pluss RPC_IN_DATA, RPC_OUT_DATA. Pange tähele, et need väärtused on juhutundlikud.
kuulaja	nöör	Kuulaja määrab kindlaks, kuidas talu kliendi soovidega mängib. Valikud on järgmised: http turvatud protokolli või https turvatud protokolli jaoks.
reqtimeout	Number	Kui kaua talu ootab kliendi soov sekundites.
restimeout	Number	Kui kaua talu ootab vastupidi vastuseid sekundites.
ülestõusmisaeg	Number	Aeg langenud reaalsest serverist välja, pärast seda perioodi kontrollib koormuse tasakaalustaja, kas reaalne server on elus, sekundites.
ümberkirjutamine	nöör	Kui see on lubatud, on talumaja kohustatud muutma asukoha ja sisu asukohta: päised vastustes virtuaalserveriga klientidele. Valikud on järgmised: lubatud, aktiveeritud blokeeritud, inaktiveeritud või lubatud taustad võrreldakse ainult taustaprogrammi.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up, talu töötab; alla, talu on peatatud või vaja uuesti taaskäivitada, et viimaste muudatuste jõustumiseks tuleb talu uuesti alustada.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	Number	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.

Certlisti objekt:

Väli	KASUTUSALA	Kirjeldus
fail	nöör	Sertifikaadi nimi, sertifikaadipoe sertifikaadi viited.
id	Number	Sertifikaadi ID: loendis esimest järjekorda kasutatakse vaikimisi, kui virtuaalse hosti päis ei ühti sertifikaadi CN-väljaga. Kasutatakse SNI jaoks.

HTTP objektide teenuste objekt:

Väli	KASUTUSALA	Kirjeldus
taustaprogrammid	Objekt []	Teenuses määratletud taustaprogrammid.
cookiedomain	nöör	Prääniku sisestamine toimub siis, kui küpsise sisus on domeeni vasted. Luba cookieinsert on vaja.
cookieinsert	nöör	See võimaldab küpsiste sisestamist taustaprogrammide kleepuvate seansside jaoks. Valikud on järgmised tõsi, otsib profiil antud küpsisest välja cookiename, kui seda pole, lisatakse see küpsis, vale, ei võeta meetmeid.
cookiename	nöör	Küpsise nime (seansi ID) kasutatakse kleepuva protsessi identifitseerimiseks taustaprogrammidena. Luba cookieinsert on vaja.
cookiepath	nöör	See haldab antud küpsise küpsise tee väärtust. Luba cookieinsert on vaja.
cookiettl	Number	See on küpsise maksimaalne eluaeg sekundites. Luba cookieinsert on vaja.
fgenabled	nöör	Luba talupidaja kasutamine. tõsi talu eestkostja on lubatud ja kontrollib taustaprogrammi staatust, vale talu eestkostja on keelatud ja ei kontrolli taustaprogrammi staatust. HTTP-profiilides teostatakse check_tcp vaikimisi, isegi kui talude eestkostja on keelatud.
liiv	nöör	Luba logide kasutamine talude eestkostjana. tõsi lubatud, vale, keelatud. fgenabled on nõutud.
fgscript	nöör	Juht, mida talu eestkostja kasutab tagaplaanide tervise kontrollimiseks. tõsi lubatud, vale, keelatud. fgenabled on nõutud.
fgtimecheck	Number	talu eestkostja kontrollib iga sekundit, kui sekundiline on taustaprogrammi tervislik seisund. fgenabled on nõutud.
httpsb	nöör	See parameeter näitab põllumajandusettevõttele, et praeguses teenuses määratletud taustaprogrammid kasutavad HTTPSi keelt ja seejärel krüpteeritakse andmed enne saatmist. tõsi, saadab profiil HTTPS-protokolli liikluse taustaprogrammidele, vale, saadab profiil HTTP protokolli liikluse taustaprogrammidele.
id	nöör	Teenuse nimi, seda ei saa pärast teenuse loomist muuta.
hüpata	nöör	See võimaldab kõige vähem reageerivat tasakaalustamismeetodit. tõsi profiilis kontrollitakse, milline taustaprogramm võtab vähem aega, et saata sellele rohkem ühendust, vale profiil ei kontrolli, millisele taustaprogrammile reageerimiseks kulub vähem aega.
püsivus	nöör	See parameeter määrab kindlaks, kuidas HTTP-teenust kliendi seansi hallata. Valikud on järgmised: "" tühi string, midagi ei võeta, IP püsivus istung toimub kliendi IP baasil, BASIC püsivus istung toimub BASICi päiste baasil, URL püsivuse seanss toimub URI-s oleva välja alusel; PARM püsivusseanss tehakse URI lõpus oleva väärtuse baasil, COOKIE püsivuse seanss toimub küpsise nime alusel, see küpsis peab olema loodud taustaprogrammide poolt ja HEADER, toimub püsivuse seanss päise nime alusel.
suunata	nöör	See käitub spetsiaalse taustaprogrammina, kuna kliendi soovile vastatakse automaatselt uuele URL-ile. Kui ümbersuunamine on konfigureeritud, siis päringut ei edastata taustaprogrammile, siis suunatakse kliendile ümbersuunamine.
ümbersuunamisviis	nöör	Kuidas suunatakse ümber, kaks võimalust: vaikimisi, võetakse URL absoluutse peremehe ja tee suunamiseks, lisada, lisatakse päringu algne tee või URI vaikesuvandiga määratud hostile ja teele. Kui suunata väli ei ole konfigureeritud, on see väli tühi string.
seanss	nöör	See on kättesaadav, kui püsivus väli on URL, COOKIE või HEADER, parameetri väärtus otsib talu http päises ja haldab kliendi seanssi.
ttl	Number	Ainult püsivusega. See väärtus näitab passiivse kliendi seansi maksimaalset eluaega (maksimaalne seansi vanus) sekundites.
urlp	nöör	Võimaldab määrata veebiteenuse, mis puudutab URL-i, mida klient taotleb konkreetse URL-i mustri kaudu, mida süntaktiliselt kontrollitakse. PCRE regulaaravaldist toetatakse.
vhost	nöör	See määrab domeeninime poolt kindlaks määratud tingimuse sama virtuaalse IP ja pordi kaudu, mis on määratud HTTP-talu poolt. PCRE regulaaravaldist toetatakse.

HTTP-põllumajandusettevõtete taustaprogramm:

Väli	KASUTUSALA	Kirjeldus
id	Number	Backend-tunnus antud teenuse sees.
ip	nöör	Taustaprogrammi IP, kus tõeline teenus töötab.
port	Number	Taustaprogrammi sadam, kus tegelik teenus töötab.
staatus	nöör	Taustase staatus. Väärtus võib olla: up backend on valmis ühenduste vastuvõtmiseks, hooldus taustaprogramm on märgitud, et see pole ühenduste vastuvõtmiseks valmis, see valik on kasulik taustaprogrammi hooldustoimingute jaoks.
timeout	Number	Teatud päringule vastamiseks on sekundi jooksul tagaplaani aeg. Kui nullsüsteem kasutab globaalset parameetrit Backends timeout.
kaal	Number	See on praeguse reaalse serveri kaalu väärtus, suurema kaalu väärtusega taustaprogramm saab rohkem ühendusi. Vaikeväärtus null, selle taustaprogrammi jaoks pole kasutatud erikaalu.

Loo uus talu

Loo uus talu

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"farmname":"newHTTPfarm", "profile":"http", "vip":"192.168.100.23", 
"vport":80}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms

POST /farms

Looge uus HTTP-talu.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
farmname	nöör	Talu kirjeldav nimi. Seda kasutatakse unikaalse identifikaatorina.	tõsi
profiil	nöör	Loodud talu profiil. Http talude jaoks on http.	tõsi
vip	nöör	Selle põllumajandusettevõtte IP, kus virtuaalne teenus käivitub. Näidatud IP peab olema konfigureeritud süsteemis ja UP	tõsi
vport	Number	Talu sadam, kus virtuaalne teenus kuulab. Sama virtuaalset pordi ja virtuaalset IP-d ei tohi kasutada teine ​​farm.	tõsi

Vastuse näide:

{
   "description" : "Creating farm 'newHTTPfarm'",
   "params" : {
      "interface" : "eth0.2",
      "farmname" : "newHTTPfarm",
      "profile" : "http",
      "vip" : "192.168.100.23",
      "vport" : 80
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu

Muuda talu

Päringu näide:

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",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP 

PUT /farms/<farmname>

Muuda antud HTTP-talu globaalseid parameetreid.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
contimeout	Number	Kui kaua talu ootab sekundi jooksul ühendust backendiga.
restimeout	Number	Kui kaua talu ootab vastupidi vastuseid sekundites.
ülestõusmisaeg	Number	See väärtus sekundites on ajavahemik, et saada välja musta nimekirja kantud taustaprogramm ja kontrollida, kas see on elus.
reqtimeout	Number	Kui kaua talu ootab kliendi soov sekundites.
ümberkirjutamine	nöör	Kui see on lubatud, on talumaja kohustatud muutma asukoha ja sisu asukohta: päised vastustes virtuaalserveriga klientidele. Valikud on järgmised: lubatud, aktiveeritud blokeeritud, inaktiveeritud või lubatud taustad võrreldakse ainult taustaprogrammi.
httpverb	nöör	See väli näitab operatsioone, mis lubatakse HTTP-kliendi taotlustele. saadaolevad väärtused on: standardHTTP, vastuvõetamatud http-taotlused GET, POST, HEAD. expandHTTP, aktsepteeritud eelmised http-taotlused pluss PUT, DELETE. standardWebDAV, aktsepteeritud eelmised http-taotlused pluss LOCK, UNLOCK, PROPFIND, PROPPATCH, SEARCH, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV aktsepteeritud eelmised http-taotlused ja SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT või MSRPCext, aktsepteerisid eelmised http-päringud pluss RPC_IN_DATA, RPC_OUT_DATA. Pange tähele, et need väärtused on juhutundlikud.
error414	nöör	Isikupärastatud sõnumiviga 414.
error500	nöör	Isikupärastatud sõnumiviga 500.
error501	nöör	Isikupärastatud sõnumiviga 501.
error503	nöör	Isikupärastatud sõnumiviga 503.
kuulaja	nöör	Kuulaja määrab kindlaks, kuidas talu kliendi soovidega mängib. Valikud on järgmised: http turvatud protokolli või https turvatud protokolli jaoks.
salakirjad	nöör	Ainult https kuulaja. Seda välja kasutatakse SSL-ühenduste poolt aktsepteeritud šifrite loendi loomiseks SSL-ühenduse tugevdamiseks. Valikud on järgmised: kõik, kõik krüptid aktsepteeritakse, kõrge turvalisus, aktsepteeritakse ainult kõrge turvalisusega šifreid või tollikindlust, laaditakse ainult šifrid cipherc valdkonnas.
cipherc	nöör	Ainult https kuulaja. See on lubatud krüpteeringute loend, mida SSL-ühendus aktsepteerib, mis on string, mis on samas formaadis kui OpenSSL-i šifreerides. Seda atribuuti kasutatakse ainult siis, kui salakirjad väljal on väärtuse õmblusväärtus.
newfarmname	nöör	Uue talu nimi. Farm tuleb lõpetada.
vport	Number	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.
vip	nöör	Selle IP-aadress, kus virtuaalne teenus kuulab, peab see IP olema konfigureeritud ja üles ehitatud.

Vastuse näide:

{
   "description" : "Modify farm FarmHTTP",
   "params" : {
      "cipherc" : "TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*",
      "ciphers" : "customsecurity",
      "contimeout" : 22,
      "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
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Lisage sertifikaat

Lisage sertifikaat

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"file":"example.pem"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/certificates

POST /farms/<farmname>/certificates

Kaasa SNI-loendisse või certlist HTTPS-kuulajaga HTTP-talu massiiv. Kasutatud sertifikaat tuleb süsteemi juba üles laadida, vt Sertifikaadid> Loetlege kõik sertifikaadid saadaval olevate sertifikaatide loend.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
fail	nöör	sertifikaadi faili nimi, eelnevalt tuleb sertifikaat süsteemi üles laadida.	tõsi

Vastuse näide:

{
   "description" : "Add certificate",
   "message" : "The certificate example.pem has been added to the SNI list of farm httpFarm, you need restart the farm to apply",
   "success" : "true",
   "status": "needed restart"
}

Sertifikaadi kustutamine

Sertifikaadi kustutamine

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/MyHttpFarm/certificates/example.pem

DELETE /farms/<farmname>/certificates/<file>

Kustutage valitud failinimega sertifikaat HTTPS-kuulajaga HTTP-talu certlistist. Sertifikaadi poest ei kustutata sertifikaati.

Vastuse näide:

{
   "description" : "Delete farm certificate",
   "message" : "The Certificate example.pem has been deleted.",
   "success" : "true",
   "status": "needed restart"   
}

Lisage IPDS-reegel

Lisage IPDS-reegel

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/ipds/blacklists

POST /farms/<farmname>/ipds/<dos|blacklists>

Rakenda põllumajandusettevõttele musta nimekirja või DoS reeglit.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Unikaalse identifikaatorina kasutatav IPDS-reegli nimi.

Vastuse näide:

{
   "description" : "Apply a rule to a farm",
   "message" : "Blacklist rule china was applied successful to the farm httpFarm.",
   "success" : "true"
}

Eemaldage IPDS-reegel

Eemaldage IPDS-reegel

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/ipds/blacklists/china

DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>

Eemaldage antud talu must nimekiri või reegli režiim oma idenfikaatori abil nimi.

Vastuse näide:

{
   "description" : "Delete a rule form a farm",
   "message" : "Blacklist rule china was removed successful from the farm httpFarm.",
   "success" : "true"
}

HTTP - Teenused

HTTP-profiili talu teenused pakuvad sisu vahetamise meetodit erinevate veebiteenuste pakkumiseks, millel on erinevad omadused, taustaprogrammid või isegi püsivuse meetodid, kasutades mõningaid deterministlikke tingimusi, mida talumaja südamik kasutab, et sobitada iga kliendi sooviga õige teenusega. Seda teenuse määratlust kasutab põllumajandusettevõte, et määrata kindlaks taustaprogrammide serverid, mis võivad kliendile vastuse anda.

Teeninduseobjekti sees on kahte liiki väärtusi: teenindusega seotud ja talupoegadega seotud väärtused.

Farmguardianit kasutatakse tagaplaanide täiustatud jälgimise oleku jaoks ja täielikult isikupärastatud praeguse teenuse jaoks mõeldud skriptide jaoks. Kui farmguardian tuvastab probleemi, lülitab ta reaalse serveri automaatselt välja ja märgistatakse musta nimekirja.

Teenuseobjekti täieliku kirjelduse kohta HTTP-talus viidata HTTP-talud> Tooma farmi nime järgi> HTTP-talude objekt Table Services

Looge uus teenus

Looge uus teenus

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"newserv"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services

POST /farms/<farmname>/services

Looge teenus antud HTTP-profiili talus. Selle muudatuse rakendamiseks on talus vaja uuesti käivitada.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
id	nöör	Teenuse nimi, mida kasutatakse kordumatu identifikaatorina. Lubatud on ainult tähtnumbrilised väärtused.	tõsi

Vastuse näide:

{
   "description" : "New service newserv",
   "params" : {
      "id" : "newserv"
   },
   "status" : "needed restart"
}

Teenuse muutmine

Teenuse muutmine

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
 -d '{"vhost":"www.mywebserver.com","urlp":"^/myapp1$","persistence":"URL",
"redirect":"http://zenloadbalancer.com","ttl":125,"sessionid":"sid","leastresp":"true",
"httpsb":"true"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services/sev2

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

Muuda HTTP-profiili teenuse parameetreid. id on teenuse kordumatu tunnus, mida muudetakse.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
vhost	nöör	Määrab domeeninime poolt kindlaks määratud tingimuse sama virtuaalse IP ja pordi kaudu, mis on määratud HTTP-profiili talu poolt. PCRE regulaaravaldist toetatakse.
urlp	nöör	Võimaldab määrata veebiteenuse, mis puudutab URL-i, mida klient taotleb konkreetse URL-i mustri kaudu, mida süntaktiliselt kontrollitakse. PCRE regulaaravaldist toetatakse.
suunata	nöör	See toimib spetsiaalse taustaprogrammina, kliendi soovile vastatakse automaatselt uuele URL-ile.
ümbersuunamisviis	nöör	Kuidas suunatakse ümber, kaks võimalust: vaikimisi, võetakse URL absoluutse peremehe ja tee suunamiseks, lisada, lisatakse päringu algne tee või URI teie poolt määratud hostile ja teele suunata valdkonnas. See käitumine kehtib ainult siis, kui suunata ei ole tühi väärtus.
cookieinsert	nöör	See võimaldab küpsiste sisestamist taustaprogrammide kleepuvate seansside jaoks. Valikud on järgmised tõsi, otsib profiil antud küpsisest välja cookiename, kui seda pole, lisatakse see küpsis, vale, sisestamise küpsis on keelatud.
cookiename	nöör	Küpsise nime (seansi ID) kasutatakse kleepuva protsessi identifitseerimiseks taustaprogrammidena. Luba cookieinsert on vaja.
cookiedomain	nöör	Prääniku sisestamine toimub siis, kui küpsise sisus on domeeni vasted. Luba cookieinsert on vaja.
cookiepath	nöör	See haldab antud küpsise küpsise tee väärtust, kui kliendi päringu või taustaprogrammi vastuses olev URI ei ühti küpsise teega, siis küpsise sisestamise püsivuse meetodit ei rakendata. Luba cookieinsert on vaja.
cookiettl	Number	See on küpsise maksimaalne eluaeg sekundites. Luba cookieinsert on vaja.
püsivus	nöör	See parameeter määrab kindlaks, kuidas HTTP-teenust kliendi seansi hallata. Valikud on järgmised: "" tühi string, midagi ei võeta, IP püsivus istung toimub kliendi IP baasil, BASIC püsivus istung toimub BASICi päiste baasil, URL püsivuse seanss toimub URI-s oleva välja alusel; PARM püsivusseanss toimub väärtuse alusel, mis on eraldatud tähega „;” URI lõpus, COOKIE püsivuse seanss toimub küpsise nime alusel, see küpsis peab olema loodud taustaprogrammide poolt ja HEADER, toimub püsivuse seanss päise nime alusel.
ttl	Number	Ainult püsivusega. Inaktiivse kliendi seansi maksimaalne eluaeg (maksimaalne seansi vanus) sekundites.
seanss	nöör	See on kättesaadav, kui püsivus väli on URL, COOKIE or HEADER, otsitakse parameetri väärtust http päises olevast profiilist ja see haldab kliendi seanssi.
hüpata	nöör	See võimaldab kõige vähem reageerivat tasakaalustamismeetodit. tõsi, kontrollib profiil profiilis, milline taustaprogramm võtab vähem aega, et sellele rohkem ühendust saada, vale, profiil ei kontrolli, millisele taustaprogrammile reageerimiseks kulub vähem aega.
httpsb	nöör	See näitab talule, et praeguses teenuses määratletud taustaprogrammid kasutavad HTTPS-i keelt ja seejärel krüpteeritakse andmed enne saatmist. tõsi, saadab profiil HTTPS-protokolli liikluse taustaprogrammidele, vale, saadab profiil HTTP protokolli liikluse taustaprogrammidele.

Vastuse näide:

{
   "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" : [],
      "cookiedomain" : "",
      "cookieinsert" : "false",
      "cookiename" : "",
      "cookiepath" : "",
      "cookiettl" : 0,
      "fgenabled" : "false",
      "fglog" : "false",
      "fgscript" : "",
      "fgtimecheck" : 5,
      "httpsb" : "true",
      "id" : "newsrv",
      "leastresp" : "true",
      "persistence" : "",
      "redirect" : "http://zenloadbalancer.com",
      "redirecttype" : "default",
      "sessionid" : "sid",
      "ttl" : 125,
      "urlp" : "^/myapp1$",
      "vhost" : "www.mywebserver.com"
   },
   "status" : "needed restart"
}

Vastusparameetrid

Vastuseks on nõutud parameetrite värskendaja ja staatus valdkonnas vaja uuesti taaskäivitada väärtus. Muutuste rakendamiseks tuleb võtta uuesti toiming.

Muuda talu eestkostjat

Muuda talu eestkostjat

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"check_tcp","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/fg

Farmguardianit kasutatakse tagaplaanide täiustatud jälgimise oleku jaoks ja täielikult isikupärastatud praeguse teenuse jaoks mõeldud skriptide jaoks. Kui farmguardian tuvastab probleemi, lülitab ta reaalse serveri automaatselt välja ja märgistatakse musta nimekirja.

PUT /farms/<farmname>/fg

Muuda põllumajandusettevõtte eestkostja parameetreid antud HTTP-profiilis.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
fgtimecheck	Number	Farmi hooldaja kontrollib taustaprogrammi terviseseisundit iga „timetocheck” sekundi järel.
fgscript	nöör	Juht, mida talu eestkostja täidab tervisliku seisundi kontrollimiseks
fgenabled	nöör	See võimaldab näidatud teenuses talupidajat. tõsi talupoegade eestkostjat kasutatakse tagaplaanide staatuse kontrollimiseks, vale talu eestkostja keelatakse
liiv	nöör	Luba logide kasutamine talude eestkostjana. tõsi talu eestkostja logib kõik toimingud, vale talu eestkostja ei kavatse ühtegi tegevust sisse logida, on soovitatav lubada liiv ainult tõrkeotsinguks.
teenus	nöör	Unikaalse identifikaatorina kasutatav teenuse nimi.	tõsi

Vastuse näide:

{
   "description" : "Modify farm FarmHTTP",
   "params" : {
      "fgenabled" : "true",
      "fglog" : "true",
      "fgscript" : "checktcp",
      "fgtimecheck" : 5,
      "service" : "service1"
   }
}

Teisalda teenused

Teisalda teenused

Päringu näide:

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

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

Need toimingud viivad antud teenuse Teenuste loendis üles või alla, see valik on kasulik, kui on vaja muuta prioriteedijärjekorda, märkida, et teenuseid hinnatakse samas järjekorras, mida näidatakse. see tegevus käivitab talu automaatselt.

id on teenuse kordumatu tunnus, mida muudetakse.

Päringu parameetrid

Väli	KASUTUSALA	Kirjeldus	Nõutud
positsioon	Number	Asukoht, kus teenus on. Esimesel positsioonil on indeks 0.	tõsi

Vastuse näide:

{
   "description" : "Move service",
   "message" : "service1 was moved successful.",
   "params" : {
      "position" : 0
   }
}

Teenuse kustutamine

Teenuse kustutamine

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services/service1

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

Kustutage http-profiili teatud teenus. id on teenuse kordumatu tunnus, mis kustutatakse.

Vastuse näide:

{
  "description" : "Delete service service1 in farm FarmHTTP",
  "message" : "The service service1 in farm FarmHTTP has been deleted.",
  "success" : "true",
  "status": "needed restart"
}

HTTP - Teenused - taustaprogrammid

Loetlege taustaprogrammid

Loetlege taustaprogrammid

Päringu näide:

curl  -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/service1/backends

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

Hankige teenuse taustaprogrammide loend. id on teenuse kordumatu tunnus.

Vastuse näide:

{
   "description" : "List service backends",
   "params" : [
      {
         "id" : 0,
         "ip" : "192.168.0.10",
         "port" : 88,
         "status" : "up",
         "timeout" : 12,
         "weight" : 1
      },
      {
         "id" : 1,
         "ip" : "192.168.102.245",
         "port" : 80,
         "status" : "up",
         "timeout" : 22,
         "weight" : 2
      }
   ]
}

Vastusparameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus
id	Number	teenuse taustaprogrammi unikaalne identifikaator. See identifikaator genereeritakse süsteemi poolt.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
port	Number	Taustaprogrammi sadam, kus tegelik teenus kuulab.
timeout	Number	Teatud päringule vastamiseks on sekundi jooksul tagaplaani aeg.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus.
staatus	nöör	Taustase staatus. Väärtus võib olla: up backend on valmis ühenduste vastuvõtmiseks, hooldus taustaprogramm on märgitud, et see pole ühenduste vastuvõtmiseks valmis, see valik on kasulik taustaprogrammi hooldustoimingute jaoks.

Loo uus taust

Loo uus taust

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.102.244","port":80, "weight":2,"timeout":2}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/newsrv/backends

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

Uue taustaprogrammi loomine antud HTTP-profiilis. id on teenuse kordumatu tunnus.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.	tõsi
port	Number	Taustaprogrammi sadam, kus tegelik teenus kuulab.	tõsi
timeout	Number	Teatud päringu vastuvõtmiseks on taustaprogrammi aeg.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus.

Vastuse näide:

{
   "description" : "New service backend",
   "message" : "Added backend to service succesfully",
   "params" : {
      "id" : 0,
      "ip" : "192.168.102.244",
      "port" : 80,
      "timeout" : 2,
      "weight" : 2
   },
   "status" : "needed restart"
}

Vastusparameetrid

Vastuseks on nõutud parameetrite värskendaja ja staatus valdkonnas vaja uuesti taaskäivitada väärtus, kui talu tuleb uuesti alustada. Muutuste rakendamiseks tuleb võtta uuesti toiming.

Muuda taustaprogrammi

Muuda taustaprogrammi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
  -d '{"ip":"192.168.0.10","port":88,"timeout":12,"service":"sev2", "weight":1}' 
  https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/service/service1/backends/1

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

Muuda HTTP-profiili teenuse taustaprogrammi parameetreid.

esimene id on järgmine teenuse unikaalne identifikaator id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
port	Number	Taustaprogrammi sadam, kus tegelik teenus kuulab.
timeout	Number	Teatud päringule vastamiseks on sekundi jooksul tagaplaani aeg.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus.

Vastuse näide:

{
   "description" : "Modify service backend",
   "info" : "There're changes that need to be applied, stop and start farm to apply them!",
   "message" : "Backend modified",
   "params" : {
      "ip" : "192.168.0.10",
      "port" : 88,
      "timeout" : 12,
      "weight" : 1
   },
   "status" : "needed restart"
}

Vastusparameetrid

Vastuseks on nõutud parameetrite värskendaja ja staatus valdkonnas vaja uuesti taaskäivitada väärtus, kui talu tuleb uuesti alustada. Muutuste rakendamiseks tuleb võtta uuesti toiming.

Hoolduse tagapõhi

Hoolduse tagapõhi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
 -d '{"action":"maintenance"}'
 https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/newsrv/backends/0/maintenance

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

Määrake antud toiming HTTP-talu taustaprogrammis, olemasolevaid toiminguid kirjeldatakse allpool.

esimene id on järgmine teenuse unikaalne identifikaator id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Määrake soovitud toiming. Toimingud on järgmised: up taustaprogramm on klienditaotluste vastuvõtmiseks valmis, hooldus taustaprogramm ei ole klienditaotluste vastuvõtmiseks valmis, see toiming on kasulik taustalerveri peatamiseks, ilma et see mõjutaks kliente.

Vastuse näide:

{
   "description" : "Set service backend status",
   "params" : {
      "action" : "maintenance"
   }
}

Kustuta taustaprogramm

Kustuta taustaprogramm

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/newfarmHTTP/services/service1/backends/4

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

Kustutage antud taustaprogramm HTTP-profiili teenuses.

esimene id on järgmine teenuse unikaalne identifikaator id on taustaprogrammi unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete service backend",
   "message" : "Backend removed",
   "success" : "true"
}

L4xNAT Talud

L4xNATi profiili talu võimaldab luua väga suure jõudlusega L4 talu ja palju rohkem samaaegseid ühendusi kui koormuse tasakaalustussüdamikud kihis 7, nagu HTTP talu profiilid. See kiht 4 jõudluse parandamine on vastuolus täiustatud sisuhaldusega, mida kiht 7 profiilid suudavad hallata.

Lisaks võisid L4xNATi talud siduda mitmete portidega, mitte ainult ühe virtuaalse pordiga, mida kasutatakse koos teiste 7i kihtide profiilidega. Selleks, et L4xNATi taludes saaks valida virtuaalsete pordide või konkreetse virtuaalse pordi, on kohustuslik valida protokolli tüüp. Muul juhul kuulab põllumajandusettevõte virtuaalsest IP-st (tähistatud tähemärgiga) kõigis sadamates.'). Kui TCP või UDP protokoll on valitud, on võimalik määrata port, mitu pordi ',', 'sadamate vahel': 'või kõigi portide vahel'". Kõigi nende kombinatsioon kehtib ka.

Too talu nime järgi

Too talu nime järgi

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4farm

GET /farms/<farmname>

Näita kõiki antud talu konfiguratsioone.

Vastus BODY:

{
   "backends" : [
      {
         "id" : 0,
         "ip" : "192.168.55.40",
         "port" : "88",
         "priority" : 2,
         "status" : "up",
         "weight" : 1
      },
      {
         "id" : 1,
         "ip" : "192.168.55.41",
         "port" : "88",
         "priority" : 3,
         "status" : "up",
         "weight" : 2
      }
   ],
   "description" : "List farm l4farm",
   "ipds" : {
      "blacklists" : [],
      "dos" : []
   },
   "params" : {
      "algorithm" : "weight",
      "fgenabled" : "false",
      "fglog" : "false",
      "fgscript" : "",
      "fgtimecheck" : 5,
      "listener" : "l4xnat",
      "nattype" : "nat",
      "persistence" : "",
      "protocol" : "tcp",
      "status" : "down",
      "ttl" : 120,
      "vip" : "192.168.100.241",
      "vport" : "88"
   }
}

Vastuse parameetrid

Vastus on JSON-objekt, mille formaat on allpool.

Farm Objekt:

Väli	KASUTUSALA	Kirjeldus
ipds	objekt	Selle talu IPDS-reeglite loetelu.
parameetrid	objekt	Põllumajandusettevõtte konfiguratsiooni parameetrid.
taustaprogrammid	Objekt []	Kõik tõelised serverid, mis on loodud selles talus ja selle konfiguratsioonis.

IPDS-objekt:

Väli	KASUTUSALA	Kirjeldus
mustad nimekirjad	String []	Põllumajandusettevõtte suhtes kohaldatakse musta nimekirja reegleid.
dos	String []	Põllumajandusettevõtte suhtes kohaldatavad DoS-reeglid.

L4xNAT talude parameetrite objekt:

Väli	KASUTUSALA	Kirjeldus
algoritm	nöör	Talus kasutatud koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: kõige vähem ühendust alati kõige vähem ühendusserveriga, kaal ühendus lineaarselt, massi järgi, prio ühendused alati kõige kättesaadavamale tasemele.
kuulaja	nöör	Kuulaja määratleb, kuidas talu klientide päringutega mängima hakkab. teabeväljal, seda ei saa muuta.
nattype	nöör	Kuidas koormuse tasakaalustaja kiht 4 südamik töötab. Valikud on järgmised: nat nn sNAT-režiim, reageerib taustaprogramm koormuse tasakaalustajale, et saata vastus kliendile, dnat taustaprogramm reageerib otse kliendile, koormuse tasakaalustaja tuleb konfigureerida lüüsi taustaprogrammis.
püsivus	nöör	Sama IP-aadress ühendatakse sama serveriga. Valikud on järgmised: "" tühi väärtus, püsivus on keelatud, ip püsivus on sisse lülitatud, kasutatakse päritolu IP-d nagu unikaalset ID-d istungil.
protokoll	nöör	Protokoll tasakaalustatakse kihis 4. Valikud on järgmised: kõik profiil laadib tasakaalu mis tahes L4i protokolli, tcp koormuse tasakaalustaja tasakaalustab ainult TCP L4i protokolli, Udp ainult koormuse tasakaalustaja tasakaalustab UDP L4 protokolli, lonks koormuse tasakaalustaja tasakaalustab ainult SIP või VoIP L7 protokolli, ftp koormuse tasakaalustaja tasakaalustab ainult FTP L7 protokolli, tftp koormuse tasakaalustaja tasakaalustab ainult TFTP L7 protokolli.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up talu töötab ja salvestab liiklust, alla talumajapidamine on alla ja ei püüa liiklust.
ttl	Number	See välja väärtus näitab sekundite arvu, millal kliendi allika ja taustaprogrammi vahel on püsivus. Püsivus peab olema konfigureeritud.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	nöör	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab. Unikaalset porti saab täpsustada, vahemiku porti saab määrata eraldajaga : ja mitu porti saab määrata eraldajaga ,.
fgenabled	nöör	Võimaldab kasutada talude eestkostjat. tõsi talu eestkostja on lubatud, vale talu eestkostja on keelatud.
liiv	nöör	Võimaldab logide kasutamist talude eestkostjana. fgenabled peab olema lubatud.
fgscript	nöör	Käsk, mida talu eestkostja kontrollib. Need võimalikud käsud on libexeci teekonnal. fgenabled peab olema lubatud.
fgtimecheck	Number	Talu hooldaja kontrollib iga sekundit. fgenabled peab olema lubatud.

L4xNATi talude taustaprogramm:

Väli	KASUTUSALA	Kirjeldus
id	Number	ID, et identifitseerida talu taustaprogramm.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
port	Number	Backendi sadam, kus tegelik teenus kuulab. Tühi väärtus on aktsepteeritud ja see kasutab sama konfiguratsiooni kui virtuaalne port (id).
staatus	nöör	Taustase staatus. Väärtus võib olla: up backend on ühenduste vastuvõtmiseks valmis, hooldus taustaprogramm ei ole ühenduste vastuvõtmiseks valmis.
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Ühendused on alati kõige enam kättesaadavad, kui 1 on kõige tähtsam.
kaal	Number	See on praeguse reaalse serveri kaalu väärtus. Suurema kaaluga taustaprogrammid saavad rohkem ühendusi.

Loo uus talu

Loo uus talu

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"profile":"l4xnat", "vip":"192.168.100.241", "vport":"88","farmname":"newl4farm"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms

POST /farms

Looge uus L4xNAT talu.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
farmname	nöör	Põllumajandusettevõtte nimi, kordumatu tunnus.	tõsi
profiil	nöör	Loodud talu profiil. L4xNATi jaoks on talud l4xnat, teatesõnum, seda väärtust ei saa muuta	tõsi
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.	tõsi
vport	nöör	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab. L4xNATi talumajapidamised võimaldavad eraldada mitmepordist , või vahemikuport eraldatud :.	tõsi

Vastuse näide:

{
   "description" : "Creating farm 'newl4farm'",
   "params" : {
      "farmname" : "newl4farm",
      "interface" : "eth0",
      "profile" : "l4xnat",
      "vip" : "192.168.100.241",
      "vport" : "88"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu

Muuda talu

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"algorithm":"weight","persistence":"","newfarmname":"l4farm", "protocol":"tcp",
"nattype":"nat","ttl":125,"vip":"178.62.126.152","vport":"81"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/newfarml4

PUT /farms/<farmname>

Muuda L4xNAT talu konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
newfarmname	nöör	Uue talu nimi. Talu tuleb see peatada.
algoritm	nöör	Talus kasutatud koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: kõige vähem ühendust alati kõige vähem ühendusserveriga, kaal ühendus lineaarselt, massi järgi, prio ühendused alati kõige kättesaadavamale tasemele.
kuulaja	nöör	Kuulaja määratleb, kuidas talu klientide päringutega mängima hakkab. teabeväljal, seda ei saa muuta.
nattype	nöör	Kuidas koormuse tasakaalustaja kiht 4 südamik töötab. Valikud on järgmised: nat nn sNAT-režiim, reageerib taustaprogramm koormuse tasakaalustajale, et saata vastus kliendile, dnat taustaprogramm reageerib otse kliendile, koormuse tasakaalustaja tuleb konfigureerida lüüsi taustaprogrammis.
püsivus	nöör	Sama IP-aadress ühendatakse sama serveriga. Valikud on järgmised: "" tühi väärtus, püsivus on keelatud, ip püsivus on sisse lülitatud, kasutatakse päritolu IP-d nagu unikaalset ID-d istungil.
protokoll	nöör	Protokoll tasakaalustatakse kihis 4. Valikud on järgmised: kõik profiil laadib tasakaalu mis tahes L4i protokolli, tcp koormuse tasakaalustaja tasakaalustab ainult TCP L4i protokolli, Udp ainult koormuse tasakaalustaja tasakaalustab UDP L4 protokolli, lonks koormuse tasakaalustaja tasakaalustab ainult SIP või VoIP L7 protokolli, ftp koormuse tasakaalustaja tasakaalustab ainult FTP L7 protokolli, tftp koormuse tasakaalustaja tasakaalustab ainult TFTP L7 protokolli.
ttl	Number	See välja väärtus näitab sekundite arvu, millal kliendi allika ja taustaprogrammi vahel on püsivus. Püsivus peab olema konfigureeritud.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	nöör	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab. Unikaalset porti saab täpsustada, vahemiku porti saab määrata eraldajaga : ja mitu porti saab määrata eraldajaga ,.

Vastuse näide:

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

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu eestkostjat

Muuda talu eestkostjat

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"Command of Farm Guardian","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4farm/fg

Farmguardianit kasutatakse tagaplaanide täiustatud jälgimise oleku jaoks ja täielikult isikupärastatud praeguse teenuse jaoks mõeldud skriptide jaoks. Kui farmguardian tuvastab probleemi, lülitab ta reaalse serveri automaatselt välja ja märgistatakse musta nimekirja.

PUT /farms/<farmname>/fg

Muutke talu eestkostja parameetreid teenuses L4xNAT.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
fgenabled	nöör	Võimaldab kasutada talude eestkostjat. tõsi talu eestkostja on lubatud, vale talu eestkostja on keelatud.
liiv	nöör	Võimaldab logide kasutamist talude eestkostjana. fgenabled peab olema lubatud.
fgscript	nöör	Käsk, mida talu eestkostja kontrollib. Need võimalikud käsud on libexeci teekonnal. fgenabled peab olema lubatud.
fgtimecheck	Number	Talu hooldaja kontrollib iga sekundit. fgenabled peab olema lubatud.

Vastuse näide:

{
   "description" : "Modify farm guardian",
   "message" : "Success, some parameters have been changed in farm guardian in farm l4farm.",
   "params" : {
      "fgenabled" : "true",
      "fglog" : "true",
      "fgscript" : "check_tcp",
      "fgtimecheck" : 5
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Lisage IPDS-reegel

Lisage IPDS-reegel

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4Farm/ipds/blacklists

POST /farms/<farmname>/ipds/<dos|blacklists>

Rakenda kasvandustele mustade või DoS-reeglit.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Unikaalse identifikaatorina kasutatav IPDS-reegli nimi.

Vastuse näide:

{
   "description" : "Apply a rule to a farm",
   "message" : "Blacklist rule china was applied successful to the farm l4Farm.",
   "success" : "true"
}

Eemaldage IPDS-reegel

Eemaldage IPDS-reegel

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4Farm/ipds/blacklists/china

DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>

Eemaldage IPDS-mooduli must nimekiri või DoS-reegel antud talust kasutades oma idenfikaatorit nimi.

Vastuse näide:

{
   "description" : "Delete a rule from a farm",
   "message" : "Blacklist rule china was removed successful from the farm l4Farm.",
   "success" : "true"
}

L4xNAT - taustaprogrammid

Loetlege taustaprogrammid

Loetlege taustaprogrammid

Päringu näide:

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

GET /farms/<farmname>/backends

Hankige teenuse taustaprogrammide loend.

Vastuse näide:

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

Vastusparameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus
id	Number	ID, et identifitseerida talu taustaprogramm.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
port	Number	Backendi sadam, kus tegelik teenus kuulab. Tühi väärtus on aktsepteeritud ja see kasutab sama konfiguratsiooni kui virtuaalne port (id).
staatus	nöör	Taustase staatus. Väärtus võib olla: up backend on ühenduste vastuvõtmiseks valmis, hooldus taustaprogramm ei ole ühenduste vastuvõtmiseks valmis.
max_conns	Number	See on taustaprogrammi samaaegse ühenduse maksimaalne arv. Kui selle välja väärtus on 0, pole taustaprogramm seadistanud ühtegi ühenduse piirangut.
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Ühendused on alati kõige enam kättesaadavad, kui 1 on kõige tähtsam.
kaal	Number	See on praeguse reaalse serveri kaalu väärtus. Suurema kaaluga taustaprogrammid saavad rohkem ühendusi.

Loo uus taust

Loo uus taust

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.100","port":8080,"max_conns":400}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends

POST /farms/<farmname>/backends

Looge antud L4xNATi talus uus taust.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.	tõsi
port	Number	Backendi sadam, kus tegelik teenus kuulab. Tühi väärtus on aktsepteeritud ja see kasutab sama konfiguratsiooni kui virtuaalne port (id).
max_conns	Number	See on taustaprogrammi samaaegse ühenduse maksimaalne arv. Kui selle välja väärtus on 0, pole taustaprogramm seadistanud ühtegi ühenduse piirangut.
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Ühendused on alati kõige enam kättesaadavad, kui 1 on kõige tähtsam. Vaikeväärtus on 1.
kaal	Number	See on praeguse reaalse serveri kaalu väärtus. Suurema kaaluga taustaprogrammid saavad rohkem ühendusi. Vaikeväärtus on 1.

Vastuse näide:

{
   "description" : "New farm backend",
   "message" : "Backend added",
   "params" : {
      "id" : 5,
      "ip" : "192.168.5.100",
      "port" : 8080,
      "max_conns" : 400,
      "priority" : null,
      "weight" : null
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda taustaprogrammi

Muuda taustaprogrammi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
  -d '{"ip":"192.168.5.40","port":8080,"max_conns":220,"priority":4,"weight":7}' 
  https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/2

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

Muuda taustaprogrammi parameetreid L4xNATi talu teenuses. id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
port	Number	Backendi sadam, kus tegelik teenus kuulab. Tühi väärtus on aktsepteeritud ja see kasutab sama konfiguratsiooni kui virtuaalne port (id).
max_conns	Number	See on taustaprogrammi samaaegse ühenduse maksimaalne arv. Kui selle välja väärtus on 0, pole taustaprogramm seadistanud ühtegi ühenduse piirangut.
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Ühendused on alati kõige enam kättesaadavad, kui 1 on kõige tähtsam.
kaal	Number	See on praeguse reaalse serveri kaalu väärtus. Suurema kaaluga taustaprogrammid saavad rohkem ühendusi.

Vastuse näide:

{
   "description" : "Modify backend",
   "message" : "Backend modified",
   "params" : {
      "ip" : "192.168.5.40",
      "port" : 8080,
      "max_conns" : 220,
      "priority" : 4,
      "weight" : 7
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Hoolduse tagapõhi

Hoolduse tagapõhi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
 -d '{"action":"maintenance"}'
 https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/1/maintenance

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

Määrake antud toiming L4xNAT talu taustaprogrammis. id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Määrake soovitud toiming. Toimingud on järgmised: up taustaprogramm on klienditaotluste vastuvõtmiseks valmis, hooldus taustaprogramm ei ole klienditaotluste vastuvõtmiseks valmis, see toiming on kasulik taustalerveri peatamiseks, ilma et see mõjutaks kliente.

Vastuse näide:

{
   "description" : "Set backend status",
   "params" : {
      "action" : "maintenance"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta taustaprogramm

Kustuta taustaprogramm

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/4

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

L4xNATi talu teenuses kustutage antud taustaprogramm.

id on taustaprogrammi unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete backend",
   "message" : "Backend removed",
   "success" : "true"
}

GSLB talud

Globaalse teenuse koormuse tasakaalustamine, mida tavaliselt nimetatakse GSLB-ks, võimaldab luua koormuse tasakaalustamisteenuse, mis põhineb DNS-teenuse hierarhilisel arhitektuuril. Selline talu annab autoriteetse DNS-i, millel on koormuse tasakaalustamise algoritmid ja teenuse oleku tuvastamine DNS-i rakenduste kihil.

Too talu nime järgi

Too talu nime järgi

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm

GET /farms/<farmname>

Näita kõiki antud talu konfiguratsioone.

Vastuse näide:

{
   "description" : "List farm gslbfarm",
   "ipds" : {
      "blacklists" : [],
      "dos" : []
   },
   "params" : {
      "status" : "needed restart",
      "vip" : "192.168.100.155",
      "vport" : 60
   },
   "services" : [
      {
         "algorithm" : "roundrobin",
         "backends" : [
            {
               "id" : 1,
               "ip" : "127.0.0.1"
            },
            {
               "id" : 2,
               "ip" : "192.168.55.40"
            },
            {
               "id" : 4,
               "ip" : "192.135.10.2"
            }
         ],
         "deftcpport" : 53,
         "fgenabled" : "true",
         "fgscript" : "check_tcp",
         "fgtimecheck" : 5,
         "id" : "service1"
      },
      {
         "algorithm" : "prio",
         "backends" : [
            {
               "id" : 1,
               "ip" : "127.0.0.1"
            },
            {
               "id" : 2,
               "ip" : "127.0.0.1"
            }
         ],
         "deftcpport" : 80,
         "fgenabled" : "false",
         "fgscript" : "",
         "fgtimecheck" : 5,
         "id" : "prioServ"
      }
   ],
   "zones" : [
      {
         "defnamesv" : "ns3",
         "id" : "global.com",
         "resources" : [
            {
               "id" : 0,
               "rdata" : "ns3",
               "rname" : "@",
               "ttl" : null,
               "type" : "NS"
            },
            {
               "id" : 1,
               "rdata" : "192.168.100.155",
               "rname" : "ns3",
               "ttl" : null,
               "type" : "A"
            },
            {
               "id" : 3,
               "rdata" : "resource2",
               "rname" : "ns2",
               "ttl" : null,
               "type" : "NS"
            },
            {
               "id" : 4,
               "rdata" : "192.168.200.30",
               "rname" : "resource2",
               "ttl" : null,
               "type" : "A"
            }
         ]
      },
      {
         "defnamesv" : "ns1",
         "id" : "DOM.com",
         "resources" : [
            {
               "id" : 0,
               "rdata" : "ns1",
               "rname" : "@",
               "ttl" : null,
               "type" : "NS"
            },
            {
               "id" : 1,
               "rdata" : "192.168.100.155",
               "rname" : "ns1",
               "ttl" : null,
               "type" : "A"
            }
         ]
      }
   ]
}

Vastuse parameetrid

Vastus on JSON-objekt, mille formaat on allpool.

Farm Objekt:

Väli	KASUTUSALA	Kirjeldus
ipds	objekt	Selle talu IPDS-reeglite loetelu.
parameetrid	objekt	Põllumajandusettevõtte konfiguratsiooni parameetrid.
teenused	Objekt []	Koostage kõik selles talus loodud teenused ja selle konfiguratsioon.
tsoonid	Objekt []	Koostage kõik selles talus loodud tsoonid ja selle konfiguratsioon.

IPDS-objekt:

Väli	KASUTUSALA	Kirjeldus
mustad nimekirjad	String []	Põllumajandusettevõttele kehtivad mustad nimekirjad.
dos	String []	Põllumajandusettevõtte suhtes kohaldatavad DoS-reeglid.

GSLB põllumajandusettevõtete parameeterobjekt:

Väli	KASUTUSALA	Kirjeldus
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	Number	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up, talu töötab; alla, talu on peatatud või vaja uuesti taaskäivitada, et viimaste muudatuste jõustumiseks tuleb talu uuesti alustada.

GSLB põllumajandusettevõtete teenindusobjekt:

Väli	KASUTUSALA	Kirjeldus
taustaprogrammid	Objekt []	Teenuses määratletud taustaprogrammid.
fgenabled	nöör	Luba talupidaja kasutamine. tõsi talu eestkostja on lubatud ja kontrollib taustaprogrammi staatust, vale talu eestkostja on keelatud ja ei kontrolli taustaprogrammi staatust. GSLB-profiilides teostatakse TCp-kontroll vaikimisi, isegi kui talude eestkostja on keelatud.
fgscript	nöör	Juht, mida talu eestkostja kasutab tagaplaanide tervise kontrollimiseks. tõsi lubatud, vale, keelatud. fgenabled on nõutud.
fgtimecheck	Number	Farmi hooldaja kontrollib iga sekundit, kui sekundit kontrollib taustaprogrammi terviseseisundit. fgenabled on nõutud.
id	nöör	Teenuse nimi, mida kasutatakse kordumatu identifikaatorina.
algoritm	nöör	Teenuses kasutatav koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: roundrobin, mis tasakaalustab ühendused ja kõik tagaplaanid, või prio mis saadab kõik ühendused esimese kättesaadava taustaprogrammiga.
deftcpport	Number	TCP-pordi vaikekontroll. See on tervisekontrolli TCP-port, mida teenus kontrollib, et teha kindlaks, kas taustaprogramm on elus. Tühi väärtus on keelatud.

GSLB põllumajandusettevõtete taustaprogramm:

Väli	KASUTUSALA	Kirjeldus
id	Number	Teenuse taustaprogrammi unikaalne identifikaator. See identifikaator genereeritakse süsteemi poolt.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.

Tsooni objekt:

Väli	KASUTUSALA	Kirjeldus
id	Number	Tsooni nime kasutati nagu ainulaadset indikaatorit.
defnamesv	nöör	See on sissepääsupunkti juurenimi server, mis on saadaval asutuse alguspunkti (SOA) DNS-kirje kujul.
ressursid	Objekt []	Vahendid määratletud piirkonnas.

Allika objekt:

Väli	KASUTUSALA	Kirjeldus
id	Number	Tsooni ressursi unikaalne identifikaator.
rname	nöör	Ressursinimi on hüüdnimi, mida DNS-teenus tõlkib tegelike nõutavate andmete jaoks rdata.
ttl	Number	Praeguse kirje väärtus, mis on vajalik ajale Live (vabatahtlik), mis on vajalik selleks, et määrata, kui kaua praegune nimi salvestatakse.
tüüp	nöör	DNS-i kirje tüüp. Valikud on järgmised: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). Lisateabe saamiseks vaadake GSLB - tsoonid - ressursid sektsiooni.
rdata	nöör	See on rekorditüübi jaoks vajalikud tegelikud andmed, sisendväärtus sõltub ressursi nime liigist, rname ja ressursitüüp, tüüp.

Loo uus talu

Loo uus talu

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"farmname":"gslbfarm","profile":"gslb","vip":"192.168.100.241","vport":53}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms

POST /farms

Looge uus GSLB talu.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
farmname	nöör	Põllumajandusettevõtte nimi, põllumajandusettevõtte kordumatu tunnus.	tõsi
profiil	nöör	Loodud talu profiil. GSLB põllumajandusettevõtete puhul on gslb.	tõsi
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.	tõsi
vport	Number	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.	tõsi

Vastuse näide:

{
   "description" : "Creating farm 'gslbfarm'",
   "params" : {
      "farmname" : "gslbfarm",
      "interface" : "eth0",
      "profile" : "gslb",
      "vip" : "192.168.100.241",
      "vport" : 53
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu

Muuda talu

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"newfarmname":"gslbnewname","vip":"192.168.100.155","vport":60}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm

PUT /farms/<farmname>

Muuda GSLB talu konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
newfarmname	nöör	Uue talu nimi. Selle muudatuse tegemiseks tuleb talu peatada.
vport	Number	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.

Vastuse näide:

{
   "description" : "Modify farm gslbnewname",
   "params" : {
      "newfarmname" : "gslbnewname",
      "vip" : "192.168.100.155",
      "vport" : 60
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Lisage IPDS-reegel

Lisage IPDS-reegel

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbFarm/ipds/blacklists

POST /farms/<farmname>/ipds/<dos|blacklists>

Rakenda põllumajandusettevõttele musta nimekirja või DoS reeglit.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Unikaalse identifikaatorina kasutatav IPDS-reegli nimi.

Vastuse näide:

{
   "description" : "Apply a rule to a farm",
   "message" : "Blacklist rule china was applied successful to the farm gslbFarm.",
   "success" : "true"
}

Eemaldage IPDS-reegel

Eemaldage IPDS-reegel

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbFarm/ipds/blacklists/china

DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>

Eemaldage antud talu must nimekiri või reegli režiim oma idenfikaatori abil nimi.

Vastuse näide:

{
   "description" : "Delete a rule form a farm",
   "message" : "Blacklist rule china was removed successful from the farm gslbFarm.",
   "success" : "true"
}

GSLB - Teenused

GSLB teenus esindab rea reaalseid servereid ja nendega seotud algoritmi. Uue teenuse loomiseks peate määrama kehtiva identifitseerimisnime ja soovitud algoritmi.

Olemasolevad teenused on järgmised:

Round Robin: võrdne jagamine. Võrdne liiklus kõigi aktiivsete reaalsete serveritega. Iga sissetuleva ühenduse jaoks määrab tasakaalustaja järgmise vooru reaalse serveri päringu edastamiseks.

Prioriteet: ühendused on alati kõige enam kättesaadavad. Tasakaalusta kõik ühendused sama kõrgeima prioriteediga serveriga. Kui see server on välja lülitatud, lülituvad ühendused järgmisele kõrgeimale serverile. Selle algoritmiga saate luua aktiivse passiivse klastri teenuse mitme reaalse serveriga.

Teenused objektiks GSLB taludele

Väli	KASUTUSALA	Kirjeldus
taustaprogrammid	Objekt []	Teenuses määratletud taustaprogrammid.
fgenabled	nöör	Luba talupidaja kasutamine. tõsi talu eestkostja on lubatud ja kontrollib taustaprogrammi staatust, vale talu eestkostja on keelatud ja ei kontrolli taustaprogrammi staatust. GSLB-profiilides teostatakse TCp-kontroll vaikimisi, isegi kui talude eestkostja on keelatud.
fgscript	nöör	Juht, mida talu eestkostja kasutab tagaplaanide tervise kontrollimiseks. tõsi lubatud, vale, keelatud. fgenabled on nõutud.
fgtimecheck	Number	Farmi hooldaja kontrollib iga sekundit, kui sekundiline on taustaprogrammi tervislik seisund. fgenabled on nõutud.
id	nöör	Teenuse nimi, mida kasutatakse kordumatu identifikaatorina.
algoritm	nöör	Teenuses kasutatav koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: roundrobin, mis tasakaalustab ühendused ja kõik tagaplaanid, või prio mis saadab kõik ühendused esimese kättesaadava taustaprogrammiga.
deftcpport	nöör	TCP-pordi vaikekontroll. See on tervisekontrolli TCP-port, mida teenus kontrollib, et teha kindlaks, kas taustaprogramm on elus. Tühi väärtus on keelatud.

Looge uus teenus

Looge uus teenus

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"service1","algorithm":"roundrobin"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services

POST /farms/<farmname>/services

Looge teenus antud GSLB talus. Selle muudatuse rakendamiseks tuleb talu uuesti alustada.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
id	nöör	Teenuse nimi, mida kasutatakse kordumatu identifikaatorina.	tõsi
algoritm	nöör	Teenuses kasutatav koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: roundrobin, mis tasakaalustab ühendused ja kõik tagaplaanid, või prio mis saadab kõik ühendused esimese kättesaadava taustaprogrammiga.	tõsi

Vastuse näide:

{
   "description" : "New service service1",
   "params" : {
      "algorithm" : "roundrobin",
      "id" : "service1"
   },
   "status" : "needed restart"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Teenuse muutmine

Teenuse muutmine

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
 -d '{"deftcpport":53}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1

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

Muuda teenuse parameetreid GSLB talus. id on teenuse kordumatu tunnus, mida muudetakse.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
deftcpport	Number	See on tervisekontrolli TCP-port, mida teenus kontrollib, et teha kindlaks, kas taustaprogramm on elus.

Vastuse näide:

{
   "description" : "Modify service service1 in farm gslbfarm",
   "info" : "There're changes that need to be applied, stop and start farm to apply them!",
   "params" : {
      "deftcpport" : 53
   },
   "status" : "needed restart"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu eestkostjat

Muuda talu eestkostjat

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":"5","fgscript":"check_tcp","fgenabled":"true",
"service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/fg

Farmguardianit kasutatakse tagaplaanide täiustatud jälgimise oleku jaoks ja täielikult isikupärastatud praeguse teenuse jaoks mõeldud skriptide jaoks. Kui farmguardian tuvastab probleemi, lülitab ta reaalse serveri automaatselt välja ja märgistatakse musta nimekirja.

PUT /farms/<farmname>/fg

Muuda GSLB teenuses põllumajandusettevõtte eestkostja parameetreid.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
fgenabled	nöör	Luba talupidaja kasutamine. tõsi talu eestkostja on lubatud ja kontrollib taustaprogrammi staatust, vale talu eestkostja on keelatud ja ei kontrolli taustaprogrammi staatust. GSLB-profiilides teostatakse TCp-kontroll vaikimisi, isegi kui kasutatav on keelatud.
fgscript	nöör	Juht, mida talu eestkostja kasutab tagaplaanide tervise kontrollimiseks. tõsi lubatud, vale, keelatud.	tõsi, kui fgenabled on lubatud.
fgtimecheck	Number	Farmi hooldaja kontrollib iga sekundit, kui sekundiline on taustaprogrammi tervislik seisund. fgenabled on nõutud.
teenus	nöör	Teenuse tunnus, id, mis talu eestkostja muudab.	tõsi

Vastuse näide:

{
   "description" : "Modify farm guardian",
   "message" : "Success, some parameters have been changed in farm guardian in farm gslbfarm.",
   "params" : {
      "fgenabled" : "true",
      "fgscript" : "check_tcp",
      "fgtimecheck" : 5
   },
   "status" : "needed restart"   
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Teenuse kustutamine

Teenuse kustutamine

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1

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

Kustutage GSLB talu antud teenus. id on teenuse kordumatu tunnus, mis kustutatakse.

Vastuse näide:

{
  "description" : "Delete service service1 in farm gslbfarm",
  "message" : "The service service1 in farm gslbfarm has been deleted.",
  "success" : "true",
  "status": "needed restart"
}

GSLB - Teenused - taustaprogrammid

See jaotis haldab teenusega seotud reaalset teenuse nimekirja.

Loetlege taustaprogrammid

Loetlege taustaprogrammid

Päringu näide:

curl  -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends

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

Hankige teenuse taustaprogrammide loend. id on teenuse kordumatu tunnus.

Vastuse näide:

{
   "description" : "List service backends",
   "params" : [
      {
         "id" : 1,
         "ip" : "127.0.0.1"
      },
      {
         "id" : 2,
         "ip" : "192.168.55.40"
      }
   ]
}

Vastusparameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus
id	Number	Teenuse taustaprogrammi unikaalne identifikaator. See identifikaator genereeritakse süsteemi poolt.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.

Loo uus taust

Loo uus taust

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.135.10.2"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends

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

Looge GSLB talus antud teenuses uus taustaprogramm. id on teenuse kordumatu tunnus, kuhu taustaprogramm lisatakse.

Prioriteetsetel teenustel on 2-i taustaprogrammid kui maksimum, aktiivne host ja passiivne peremees.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.	tõsi

Vastuse näide:

{
   "description" : "New service backend",
   "message" : "Added backend to service succesfully",
   "params" : {
      "id" : 4,
      "ip" : "192.135.10.2"
   },
   "status" : "needed restart"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda taustaprogrammi

Muuda taustaprogrammi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
  -d '{"ip":"192.168.2.30"}' 
  https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends/1

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

Muuda backendi parameetreid GSLB talu teenuses.

Märkus PUT see on esimene id on teenuse unikaalne identifikaator ja järgmine id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.

Vastuse näide:

{
   "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.2.30"
   },
   "status" : "needed restart"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta taustaprogramm

Kustuta taustaprogramm

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends/3

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

Kustutage antud taustaprogramm GSLB talu teenuses

Vastuse näide:

{
   "description" : "Delete service backend",
   "message" : "Backend removed",
   "success" : "true"
}

GSLB - tsoonid

GSLB tsooni sektsioon kirjeldab DNS-domeeninime, alamdomeene, varjunimesid jne, mis on vajalikud täieliku DNS-tsooni loomiseks koos täiendavate koormuse tasakaalustamise kirjetega, kasutades määratud teenuseid.

Loo tsoon

Loo tsoon

Päringu näide:

curl  -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"id":"global.conf"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones

POST /farms/<farmname>/zones

Looge DNS-tsoon.

Päringu parameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus	Nõutud
id	Number	Tsooni nime kasutati nagu ainulaadset indikaatorit.	tõsi

Vastuse näide:

{
   "description" : "New zone global.com",
   "params" : {
      "id" : "global.com"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Tsooni muutmine

Tsooni muutmine

Päringu näide:

curl  -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"defnamesv":"ns3"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com

PUT /farms/<farmname>/zones/<id>

Muuda tsooni parameetreid. id on tsooni kordumatu tunnus, mida muudetakse.

Päringu parameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus
defnamesv	nöör	See on sissepääsupunkti juurenimi server, mis on saadaval asutuse alguspunkti (SOA) DNS-kirje kujul.

Vastuse näide:

{
   "description" : "Modify zone global.com in farm gslbfarm",
   "params" : {
      "defnamesv" : "ns3"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Tsooni kustutamine

Tsooni kustutamine

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/dom.com

DELETE /farms/<farmname>/zones/<id>

Kustutage GSLB talu teatud tsoon.

Vastuse näide:

{
   "description" : "Delete zone dom.com in farm gslbfarm.",
   "message" : "The zone dom.com in farm gslbfarm has been deleted.",
   "success" : "true"
}

GSLB - tsoonid - ressursid

DNS-teenusena määratletud ressursid lahendavad taotlused. Võimalikud DNS-i ressursid Zevenet'i koormuse saldodes on:

1. NS. Name Server tüüpi kirje, mis delegeerib DNS-tsooni antud autoriteetsete nimeserverite kasutamiseks.
2. A. Aadressi tüübi kirje, mis tagastab hostile IPv4i aadressi.
3. CNAME. Kanooniline nimetüübi kirje, see esindab antud nime varjunime.
4. DYNA. Dünaamilise aadressi tüübi kirje, ta tagastab dünaamilise aadressi, mis on määratud GSLB teenusega, mis on juba loodud talumaja konfiguratsioonis vastavalt sellisele teenusele valitud algoritmile.
5. AAAA. Aadressi tüübi kirje, mis tagastab hostile IPv6i aadressi.
6. MX. E-posti vahetuse tüübi kirje kaardistab domeeninime selle domeeni sõnumiedastusagentide loendisse.
7. SRV. Teenusepakkuja tüübi kirje, üldistatud teenuse asukoha kirje, mida kasutatakse uuemate protokollide asemel protokolli-spetsiifiliste kirjete, nagu MX, loomiseks.
8. TXT. Tekstitüübi kirje, mida kasutatakse tekstipõhise teabe salvestamiseks, mida saab vajadusel haarata. Kõige sagedamini näeme TXT-kirjeid, mida kasutatakse SPF-andmete hoidmiseks ja domeeni omandiõiguse kontrollimiseks.
9. PTR. Pointeri kirje, kanoonilise nime osuti. Erinevalt CNAME-st peatub DNS-töötlus ja lihtsalt nimi tagastatakse. Kõige tavalisem kasutamine on tagurpidi DNS-i otsingute rakendamiseks.
10. NAPTR. Nimetamise asutuse pointer, võimaldab regulaarselt väljendada domeeninimede ümberkirjutamist, mida saab seejärel kasutada URI-dena, täiendavateks domeeninimedeks otsingutele jne.

Loetlege ressursid

Loetlege ressursid

Päringu näide:

curl  -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources

GET /farms/<farmname>/zones/<id>/resources

Hankige tsoonis ressursside nimekiri. id on tsooni kordumatu tunnus.

Vastuse näide:

{
   "description" : "List zone resources",
   "params" : [
      {
         "id" : 0,
         "rdata" : "ns3",
         "rname" : "@",
         "ttl" : null,
         "type" : "NS"
      },
      {
         "id" : 1,
         "rdata" : "192.168.100.155",
         "rname" : "ns3",
         "ttl" : null,
         "type" : "A"
      },
      {
         "id" : 2,
         "rdata" : "192.168.0.9",
         "rname" : "resource2",
         "ttl" : 10,
         "type" : "A"
      },
      {
         "id" : 3,
         "rdata" : "resource2",
         "rname" : "ns2",
         "ttl" : null,
         "type" : "NS"
      }
   ]
}

Vastusparameetrid

See kõne tagastab ressursiobjektide massiivi parameetritega.

Väli	KASUTUSALA	Kirjeldus
id	Number	Tsooni ressursi unikaalne identifikaator.
rname	nöör	Ressursinimi on hüüdnimi, mida DNS-teenus tõlkib tegelike nõutavate andmete jaoks rdata.
ttl	Number	Praeguse kirje väärtus, mis on vajalik ajale Live (vabatahtlik), mis on vajalik selleks, et määrata, kui kaua praegune nimi salvestatakse.
tüüp	nöör	DNS-i kirje tüüp. Valikud on järgmised: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). Lisateabe saamiseks vaadake GSLB - tsoonid - ressursid sektsiooni.
rdata	nöör	See on rekorditüübi jaoks vajalikud tegelikud andmed, sisendväärtus sõltub ressursi nime liigist, rname ja ressursitüüp, tüüp.

Loo uus ressurss

Loo uus ressurss

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"rname":"resource2", "rdata":"192.168.0.9", "ttl":10, "type":"A" }' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources

POST /farms/<farmname>/zones/<id>/resources

Looge GSLB talu kindlas tsoonis uus ressurss. id on tsooni kordumatu tunnus, mida muudetakse, kui ressurss lisatakse.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
rname	nöör	Ressursinimi on hüüdnimi, mida DNS-teenus tõlkib tegelike nõutavate andmete jaoks rdata.	tõsi
ttl	Number	Praeguse rekordi aeg väärtuseni Live. See on marsruuterite maksimaalne arv, mida päring saab läbi til die. Selle kasulik on see, et pakett ei sisesta võrgusilmus.
tüüp	nöör	DNS-i kirje tüüp. Valikud on järgmised: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). Lisateabe saamiseks vaadake GSLB - tsoonid - ressursid sektsiooni.	tõsi
rdata	nöör	See on rekorditüübi jaoks vajalikud tegelikud andmed, sisendväärtus sõltub ressursi nime liigist, rname ja ressursitüüp, tüüp. Kui DYNA on valitud tüüp siis peab rdata väärtus olema üks konfigureeritud teenused selles tsoonis.	tõsi

Vastuse näide:

{
   "description" : "New zone resource",
   "message" : "Resource added",
   "params" : {
      "rdata" : "192.168.0.9",
      "rname" : "resource2",
      "ttl" : 10,
      "type" : "A",
      "zone" : "global.com"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muutke ressurssi

Muutke ressurssi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
  -d '{"rname":"resource2", "rdata":"192.168.200.30","ttl":null, "type":"A" }' 
  https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources/1

PUT /farms/<farmname>/zones/<id>/resources/<id>

Muuda resouce parameetreid GSLB talu tsoonis.

esimene id on järgmise tsooni kordumatu tunnus id on ressursi kordumatu tunnus.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
rname	nöör	Ressursinimi on hüüdnimi, mida DNS-teenus tõlkib tegelike nõutavate andmete jaoks rdata.
ttl	Number	Praeguse kirje väärtus, mis on vajalik ajale Live (vabatahtlik), mis on vajalik selleks, et määrata, kui kaua praegune nimi salvestatakse.
tüüp	nöör	DNS-i kirje tüüp. Valikud on järgmised: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). Lisateabe saamiseks vaadake GSLB - tsoonid - ressursid sektsiooni.
rdata	nöör	See on rekorditüübi jaoks vajalikud tegelikud andmed, sisendväärtus sõltub ressursi nime liigist, rname ja ressursitüüp, tüüp. Kui tüüp on koormatud väärtusega DYNA SIIS rdata tuleb laadida saadaval teenus nimi

Vastuse näide:

{
   "description" : "Modify zone resource",
   "message" : "Resource modified",
   "params" : {
      "rdata" : "192.168.200.30",
      "rname" : "resource2",
      "ttl" : null,
      "type" : "A"
   },
   "success" : "true"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustutage ressurss

Kustutage ressurss

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources/3

DELETE /farms/<farmname>/zones/<id>/resources/<id>

Kustutage antud resouce GSLB talu tsoonis

Pange tähele, et DELETE URI üle esimese id on tsooni unikaalne identifikaator ja järgmine id on ressursi kordumatu tunnus.

Vastuse näide:

{
   "description" : "Delete zone resource",
   "message" : "Resource removed",
   "success" : "true"
}

Datalink Farms

Datalinki põllumajandusprofiil võimaldab luua marsruutidel põhineva põllumajandusettevõtte, kus taustaprogrammid on üleslingi marsruuterid või väravad. Selline põllumajandusprofiil on valmis jagama mitu üleslingi WAN-ruuteri ligipääsu, kasutades koormuse tasakaalustajat üleslingi kanali multipleksorina (1-i sisend ja mitu ruuteri-väljundit). Seetõttu võiksid datalinkide talumajapidamisi kasutada kõrgete kättesaadavate sideühendustena ja lisaks võiks neid kasutada ribalaiuse suurendamiseks, mis ühendab marsruuterite vahelise ribalaiuse.

Too talu nime järgi

Too talu nime järgi

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/dlink

GET /farms/<farmname>

Kuva kõik talu konfiguratsioonid.

Vastuse näide:

{
   "backends" : [
      {
         "id" : 0,
         "interface" : "eth0",
         "ip" : "192.168.100.10",
         "priority" : 2,
         "weight" : 2
      },
      {
         "id" : 1,
         "interface" : "eth0",
         "ip" : "192.168.100.11",
         "priority" : 2,
         "weight" : 1
      }
   ],
   "description" : "List farm dlink",
   "params" : {
      "algorithm" : "weight",
      "status" : "down",
      "vip" : "192.168.100.199"
   }
}

Vastuse parameetrid

Vastus on JSON-objekt, mille formaat on allpool.

Farm Objekt:

Väli	KASUTUSALA	Kirjeldus
parameetrid	objekt	Põllumajandusettevõtte konfiguratsiooni parameetrid.
taustaprogrammid	Objekt []	Selles talus loodud reaalsed serverid ja selle konfiguratsioon.

Parameetrite objekt datalinkide taludele:

Väli	KASUTUSALA	Kirjeldus
algoritm	nöör	Talus kasutatud koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: kaal, jagab tasakaalustaja kõigi olemasolevate taustaprogrammide vahel, mis annavad rohkem tasu tagaplaanile suurema kaaluga prio, mis saadab kõik ühendused taustaprogrammiga väikese väärtusega prioriteet.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up, talu töötab või alla, talu on peatatud.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.

Datalinkide talumajapidamiste taustaprogramm:

Väli	KASUTUSALA	Kirjeldus
id	Number	Põllumajandusettevõtte taustaprogrammi unikaalne identifikaator.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
liides	nöör	See on kohalik võrguliides, kus taustaprogramm on ühendatud.
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon, kuna eel- ja madalama prioriteediga eelistatakse
kaal	Number	See on praeguse reaalse serveri kaalu väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon kui kaal.

Loo uus talu

Loo uus talu

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"farmname":"dlink", "vip":"192.168.100.241", "profile":"datalink" }' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms

POST /farms

Looge uus datalinkimaja.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
farmname	nöör	Põllumajandusettevõtte nimi, kordumatu tunnus.	tõsi
profiil	nöör	Loodud talu profiil. Datalinkide puhul on andmelink	tõsi
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.	tõsi

Vastuse näide:

{
   "description" : "Creating farm 'dlink'",
   "params" : {
      "farmname" : "dlink",
      "interface" : "eth0",
      "profile" : "datalink",
      "vip" : "192.168.100.241"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda talu

Muuda talu

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"newfarmname":"dlink2", "vip":"192.168.100.199","algorithm":"weight"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink

PUT /farms/<farmname>

Muuda datalinkide ettevõtte konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
newfarmname	nöör	Uus talu nimi. Talu tuleb peatada.
algoritm	nöör	Talus kasutatud koormuse tasakaalustamise algoritmi tüüp. Valikud on järgmised: kaal, jagab tasakaalustaja kõigi olemasolevate taustaprogrammide vahel, mis annavad rohkem tasu tagaplaanile suurema kaaluga prio, mis saadab kõik ühendused taustaprogrammiga väikese väärtusega prioriteet.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.

Vastuse näide:

{
   "description" : "Modify farm dlink",
   "params" : {
      "algorithm" : "weight",
      "vip" : "192.168.100.199",
      "newfarmname" : "dlink2"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Datalink - taustaprogrammid

Datalinkide talumajapidamised on teenuse marsruutimise kaudu väravad. Teenus mitmekordistub nende väravate vahel ja mõned neist ei ole kättesaadavad, teenus kasutab teist.

Loetlege taustaprogrammid

Loetlege taustaprogrammid

Päringu näide:

curl  -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends

GET /farms/<farmname>/backends

Hankige teenuse taustaprogrammide loend.

Vastuse näide:

[
   {
      "id" : 6,
      "interface" : "eth0",
      "ip" : "192.168.100.10",
      "priority" : 2,
      "weight" : 2
   },
   {
      "id" : 7,
      "interface" : "eth0",
      "ip" : "192.168.100.11",
      "priority" : 2,
      "weight" : 1
   }
]

Vastusparameetrid

See kõne tagastab backend-objekti massiivi parameetrite abil.

Väli	KASUTUSALA	Kirjeldus
id	Number	Põllumajandusettevõtte taustaprogrammi unikaalne identifikaator. See identifikaator genereeritakse süsteemi poolt.
liides	nöör	See on kohalik võrguliides, kus taustaprogramm on ühendatud.
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.
prioriteet	Number	See on praeguse taustaprogrammi prioriteetne väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon, kuna eel- ja madalama prioriteediga eelistatakse.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon kui kaal.

Loo uus taust

Loo uus taust

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.10","interface":"eth0","priority":2,"weight":2}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends

POST /farms/<farmname>/backends

Looge antud taustaprogrammile uus taustaprogramm.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Taustaprogrammi IP, kus tegelik teenus kuulab.	tõsi
liides	nöör	See on kohalik võrguliides, kus taustaprogramm on ühendatud.	tõsi
prioriteet	Number	See on praeguse reaalse serveri prioriteetne väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon, kuna eel- ja madalama prioriteediga eelistatakse. Vaikeväärtus on 1.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus. Seda kasutatakse siis, kui algoritm väli on konfiguratsioon kui kaal. Vaikeväärtus on 1.

Vastuse näide:

{
   "description" : "New farm backend",
   "message" : "Backend added",
   "params" : {
      "id" : 6,
      "interface" : "eth0",
      "ip" : "192.168.100.10",
      "priority" : 2,
      "weight" : 2
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda taustaprogrammi

Muuda taustaprogrammi

Päringu näide:

 curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
  -d '{"ip":"192.168.102.50","interface":"eth0", "weight":1,"timeout":1}' 
  https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/datalink/backends/2

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

Muuda taustaprogrammi parameetreid datalinki talu teenuses. id on taustaprogrammi unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
nöör	ip	Taustaprogrammi IP, kus tegelik teenus kuulab.
liides	nöör	See on kohalik võrguliides, kus taustaprogramm on ühendatud.
timeout	Number	Teatud päringu vastuvõtmiseks on taustaprogrammi aeg.
kaal	Number	See on praeguse taustaprogrammi kaalu väärtus.

Vastuse näide:

{
   "description" : "Modify backend",
   "message" : "Backend modified",
   "params" : {
      "interface" : "eth0",
      "ip" : "192.168.102.50",
      "timeout" : 1,
      "weight" : 1
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta taustaprogramm

Kustuta taustaprogramm

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends/4

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

Kustutage antud taustaprogramm datalinki talu teenuses. id on taustaprogrammi unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete backend",
   "message" : "Backend removed",
   "success" : "true"
}

võrk

Zevenet võib töötada erinevat tüüpi võrguliideste abil.

Selles jaotises saate NIC-, VLAN-, virtuaalsete ja sidumisliideste loendit, loo, konfigureerida, kustutada ja seadistada.

Nic: või võrguliidese kaart, see on arvuti riistvarakomponent ja tis-tüüpi liides on aluseks Zevenetis defineeritavatele ja hallatavatele järgmistele liidestele.

vlan: või virtuaalne lan kaart on lahke või võrguliides, mis pakub võrgu segmenteerimisteenuseid. Nic liidese kaudu saab luua rohkem kui ühe vlaani. bonding: Ka teise müüja nimetab seda pagasirajaliideteks, seda tüüpi nööri saab luua rohkem kui ühe nic liidesega. Zevenet toetab 7i erinevat tüüpi liideseid.

virtuaalne: Seda tüüpi liidest saab luua mis tahes ülaltoodud liidese kaudu. Seda tüüpi liidest tuleks kasutada põllumajandusettevõtete jaoks ja virtuaalset liidest on vaja määratleda samas alamvõrgus kui vanem.

Loetlege kõik liidesed

Loetlege kõik liidesed

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic

GET /interfaces

Hankige süsteemi liidesed nende konfiguratsiooniga.

Vastuse näide:

{
   "description" : "List interfaces",
   "interfaces" : [
      {
         "gateway" : "",
         "ip" : "",
         "mac" : "66:eb:31:0e:07:71",
         "name" : "bond2",
         "netmask" : "",
         "status" : "down",
         "type" : "bond"
      },
      {
         "gateway" : "192.168.100.1",
         "ip" : "192.168.100.121",
         "mac" : "a2:6d:80:29:87:c6",
         "name" : "bondiface",
         "netmask" : "255.255.255.0",
         "status" : "up",
         "type" : "bond"
      },
      {
         "gateway" : "192.168.100.5",
         "ip" : "192.168.100.241",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0",
         "netmask" : "255.255.255.0",
         "status" : "up",
         "type" : "nic",
         "is_slave" : "false"
      },
      {
         "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",
         "ip" : "192.168.100.41",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0:virtiface",
         "netmask" : "255.255.255.0",
         "status" : "down",
         "type" : "virtual"
      },
      {
         "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",
         "type" : "nic",
         "is_slave" : "false"
      },
      {
         "gateway" : "",
         "ip" : "",
         "mac" : "66:eb:31:0e:07:71",
         "name" : "eth2",
         "netmask" : "",
         "status" : "up",
         "type" : "nic",
         "is_slave" : "true"
      },
      {
         "gateway" : "",
         "ip" : "",
         "mac" : "a2:6d:80:29:87:c6",
         "name" : "eth3",
         "netmask" : "",
         "status" : "up",
         "type" : "nic",
         "is_slave" : "true"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on liidese objektirühm.

Liidese objekt:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. IP peab virtuaalses liideses olema samas võrgusegmendis kui vanemliides.
võrgumask	nöör	Liidese võrgumask. Seda väärtust ei saa virtuaalsetes liideses muuta, see on päritud algsest liidesest.
värav	nöör	Liidese värav. Seda väärtust ei saa virtuaalsetes liideses muuta, see on päritud algsest liidesest.
mac	nöör	Liidese MAC. See väärtus pärineb esimesest NIC-orjast sidumisliidestes. Virtuaalsetes ja VLAN-i liidestes pärineb see vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
tüüp	nöör	Erinevad liidesed on järgmised: Nic, vlan, virtuaalne or võlakiri.
is_slave	nöör	Ainult NIC-liideses saadaval, tõsi, liides on osa sidumisliidest, vale liides ei ole sidumisliidese osa.

Too vaikimisi lüüs

Too vaikimisi lüüs

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/interfaces/gateway

GET /interfaces/gateway

Vaikevärav on sõlmpunkt, mis saadab kogu sihtliikluse, mis ei ole koormuse tasakaalustaja mis tahes liideselt kohapeal kättesaadav.

Hankige vaikelüüsi liidese parameetrid.

Vastuse näide:

{
   "description" : "Default gateway",
   "params" : {
      "address" : "192.168.100.5",
      "interface" : "eth0"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
aadress	nöör	See on lüüsi IP.
liides	nöör	Lüüsi liidese nimi.

Muuda vaikelüüsi

Muuda vaikelüüsi

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"interface":"eth0","address":"192.168.100.5"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces

PUT /interfaces/gateway

Muuda lüüsi liidese konfiguratsiooni.

Vastuse näide:

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

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
aadress	nöör	See on lüüsi IP.
liides	nöör	Lüüsi liidese nimi.

Kustuta lüüsi konfiguratsioon

DELETE /interfaces/gateway

Kustuta vaikelüüsi konfiguratsiooni konfiguratsioon.

Hoiatus: kui lüüsi ei ole konfigureeritud, ei ole Zevenet välisvõrgu segmendist kättesaadav.

Kustuta lüüsi konfiguratsioon

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/gateway

Vastussõnum

Kui lüüs on sama võrgusegmendist erinev, ilmub see teade, vastasel juhul kaob ühendus.

Vastuse näide:

{
   "description" : "Remove default gateway",
   "message" : "The default gateway has been deleted successfully",
   "params" : {
      "address" : null,
      "interface" : null
   }
}

Võrk - NIC liidesed

NIC-liidesed on teie Zevenet-i koormuse tasakaalustajaga ühendatud füüsilised liidesed.

Süsteem tuvastab uued liidesed automaatselt pärast nende ühendamist.

Kasutades NIC-liideseid vanematena, saab luua muud tüüpi eri liideseid. Olemasolevad liidesed on järgmised: VLAN,virtuaalne ja bonding.

NIC-liideste loend

GET /interfaces/nic

Hankige kõik NIC-liideste parameetrid.

NIC-liideste loend

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic

Vastuse näide:

{
   "description" : "List NIC interfaces",
   "interfaces" : [
      {
         "gateway" : "192.168.100.5",
         "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",
         "ip" : "192.168.100.102",
         "is_slave" : "false",
         "mac" : "62:30:43:36:29:ac",
         "name" : "eth1",
         "netmask" : "255.255.255.0",
         "status" : "up"
      },
      {
         "gateway" : "",
         "ip" : "",
         "is_slave" : "false",
         "mac" : "a2:6d:80:29:87:c6",
         "name" : "eth3",
         "netmask" : "",
         "status" : "down"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on rida NIC-liidese objekte.

NIC-i liidese objekt:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse pakettide saatmiseks teisele võrgusegmendile.
mac	nöör	Linkkihi unikaalne tunnus. See on muutmatu.
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
is_slave	nöör	tõsi liides on osa sidumisliidest, \ t vale liides ei ole sidumisliidese osa.

NIC-liidese hankimine

NIC-liidese hankimine

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1

GET /interfaces/nic/<name>

Hangi kõik NIC-liidese parameetrid. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Show NIC interface",
   "interface" : {
      "gateway" : "192.168.100.5",
      "ip" : "192.168.100.102",
      "is_slave" : "false",
      "mac" : "62:30:43:36:29:ac",
      "name" : "eth1",
      "netmask" : "255.255.255.0",
      "status" : "up"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse pakettide saatmiseks teisele võrgusegmendile.
mac	nöör	Linkkihi unikaalne tunnus. See on muutmatu.
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
tüüp	nöör	Erinevad liidesed on järgmised: Nic, vlan, virtuaalne or võlakiri. Igaüks neist on määratletud nende alammenüüs.
is_slave	nöör	tõsi liides on osa sidumisliidest, \ t vale liides ei ole sidumisliidese osa.

Muuda NIC-liidest

Muuda NIC-liidest

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.102","netmask":"255.255.255.0","gateway":"192.168.100.5"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1

PUT /interfaces/nic/<name>

Muutke NIC-liidese parameetreid. nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.

Vastuse näide:

{
   "description" : "Configure nic interface",
   "params" : {
      "gateway" : "192.168.100.5",
      "ip" : "192.168.100.102",
      "netmask" : "255.255.255.0"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta NIC-konfiguratsioon

Kustuta NIC-konfiguratsioon

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth3

DELETE /interfaces/nic/<name>

Kustutage NIC-liidese konfiguratsioon. Pärast seda toimingut on liides kasutu ja uuesti konfigureerimiseks valmis. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete nic interface",
   "message" : "The configuration for the network interface eth3 has been deleted.",
   "success" : "true"
}

Määra NIC-liidese toiming

Määra NIC-liidese toiming

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1/actions

POST /interfaces/nic/<name>/actions

Rakenda NIC-liidesele toiming. See kõne võimaldab võrguliidese lubamist või keelamist.

nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Liidesele rakendatav tegevus. Olemasolevad väärtused on järgmised: uplubage liides ja valmistage see ette kasutamiseks; alla, keelake liides, et pakette mitte vastu võtta või mitte.	tõsi

Vastuse näide:

{
   "description" : "Action on nic interface",
   "params" : {
      "action" : "up"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Võrk - sidumisliidesed

Linuxi liidese liides või teise pakkuja poolt kutsutud Trunk pakub ka meetodit mitme võrguliidese koondamiseks üheks loogiliseks liideseks. Ühendatud liideste käitumine sõltub režiimist, Zevenet Load Balancer toetab järgmisi meetodeid:

Ümarahela poliitika: Edastage pakette järjestikuses järjekorras esimesest olemasolevast orjast viimase kaudu. See režiim tagab koormuse tasakaalustamise ja tõrketaluvuse.

Aktiivne varukoopia: Ainult üks sideme ori on aktiivne. Erinev ori muutub aktiivseks, kui ja ainult siis, kui aktiivne ori ei toimi. Lingi MAC-aadress on väliselt nähtav ainult ühes pordis (võrgukaart), et vältida lüliti segadust. See režiim tagab tõrketaluvuse. Esmane valik mõjutab selle režiimi käitumist.

XORi poliitika: Edastamine lähteallika MAC-aadressi XOR'd alusel sihtkoha MAC-aadressiga. See valib sama sihtkoha iga MAC-aadressi jaoks. See režiim tagab koormuse tasakaalustamise ja tõrketaluvuse.

Ringhäälingupoliitika: Edastab kõike kõigil ori liidestel. See režiim tagab tõrketaluvuse.

IEEE 802.3ad LACP: Loob koondamisgrupid, millel on ühesugused kiiruse ja dupleksseaded. Kasutab kõiki aktiivseid agregatoreid vastavalt 802.3adi spetsifikatsioonile.

Eeltingimused:

1. Võrgu liidese tugi baasi draiverites iga ori kiiruse ja dupleksi saamiseks.

2. Lüliti, mis toetab IEEE 802.3adi dünaamilise lingi koondamist. Enamik lülititest vajab 802.3adi režiimi lubamiseks teatud tüüpi konfiguratsiooni.

Adaptive edastuskoormuse tasakaalustamine: Kanaliühendus, mis ei vaja spetsiaalset lülititugi. Väljuv liiklus jaotatakse vastavalt igale orjale jooksva koormuse (kiiruse suhtes arvutatud) järgi. Sissetulev liiklus saabub praegusele orjale. Kui vastuvõtev slave ei õnnestu, võtab teine ​​slave ebaõnnestunud vastuvõtva orja MAC-aadressi üle.

Eeltingimus:

Alustage juhi tugi iga orja kiiruse saamiseks.

Kohanduv koormuse tasakaalustamine: Sisaldab adaptiivset ülekandekoormuse tasakaalustamist ja IPV4i liikluse koormuse tasakaalustamist ning ei vaja spetsiaalset lülititugi. Vastuvõtu koormuse tasakaalustamine saavutatakse ARP läbirääkimistega. Sidumisseadme juht takistab kohaliku süsteemi poolt saadetud väljapääsu ARP-vastuseid ja kirjutab allika riistvara aadressi ühe liiteseadme unikaalse riistvara aadressi nii, et erinevad eakaaslased kasutavad serverile erinevaid riistvara aadresse.

Loend Sidumisliidesed

Loend Sidumisliidesed

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding

GET /interfaces/bonding

Konfigureerige süsteemi kõik liideseid.

Vastuse näide:

{
   "description" : "List bonding interfaces",
   "interfaces" : [
      {
         "gateway" : "",
         "ip" : "",
         "mac" : "66:eb:31:0e:07:71",
         "mode" : "broadcast",
         "name" : "bond2",
         "netmask" : "",
         "slaves" : [
            {
               "name" : "eth2"
            }
         ],
         "status" : "down"
      },
      {
         "gateway" : "192.168.100.1",
         "ip" : "192.168.100.121",
         "mac" : "a2:6d:80:29:87:c6",
         "mode" : "balance-rr",
         "name" : "bondiface",
         "netmask" : "255.255.255.0",
         "slaves" : [
            {
               "name" : "eth3"
            },
            {
               "name" : "eth4"
            }
         ],
         "status" : "up"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on sidumisliidese objekti massiiv.

Sidumisparameetrid on:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.
mac	nöör	Linkkihi unikaalne tunnus. See on mac esimese NIC liidese orja.
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
orjad	Objekt []	NIC-liidese liikmed liimimisliidese kohta.
režiimis	nöör	See on liimimisliidese töörežiim. Valikud on järgmised: tasakaal-rr, Ümmargune poliitika; aktiivne varukoopiaAktiivne varukoopia; tasakaalu - võiXOR poliitika; ülekanne, Ringhäälingupoliitika; 802.3ad, IEEE 802.3ad LACP; tasakaal-tlbAdaptive saatekoormuse tasakaalustamine; tasakaal-alb, Kohanduv koormuse tasakaalustamine. Need väärtused on määratletud punktis Võrk - sidumisliidesed.

Orjade objekt:

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Nimi on NIC orja liidese unikaalne identifikaator.

Laadi sidumisliides

Laadi sidumisliides

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface

GET /interfaces/bonding/<name>

Hangi kõik liidese parameetrid. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Show bonding interface",
   "interface" : {
      "gateway" : "192.168.100.1",
      "ip" : "192.168.100.121",
      "mac" : "a2:6d:80:29:87:c6",
      "mode" : "balance-rr",
      "name" : "bondiface",
      "netmask" : "255.255.255.0",
      "slaves" : [
         {
            "name" : "eth3"
         },
         {
            "name" : "eth2"
         }
      ],
      "status" : "up"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on sidumisliidese objekt.

Sidumisparameetrid on:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.
mac	nöör	Linkkihi unikaalne tunnus. See on mac esimese NIC liidese orja.
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
orjad	Objekt []	NIC-liidese liikmed liimimisliidese kohta.
režiimis	nöör	See on liimimisliidese töörežiim. Valikud on järgmised: tasakaal-rr, Ümmargune poliitika; aktiivne varukoopiaAktiivne varukoopia; tasakaalu - võiXOR poliitika; ülekanne, Ringhäälingupoliitika; 802.3ad, IEEE 802.3ad LACP; tasakaal-tlbAdaptive saatekoormuse tasakaalustamine; tasakaal-alb, Kohanduv koormuse tasakaalustamine. Need väärtused on määratletud punktis Võrk> Liimimisliidesed.

Ori objekt:

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Nimi on NIC orja liidese unikaalne identifikaator.

Loo sidumisliides

Loo sidumisliides

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"slaves":["eth3","eth2"],"name":"bondiface","mode":"balance-rr"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding

POST /interfaces/bonding

Looge NIC-liideste ühendamiseks liidese liides.

Sidumise MAC-aadress võetakse selle esimesest NIC-liidesest. Liimimisrežiimi ei saa pärast liidese liidese loomist muuta, kuid liideseid võib liidese liideses vajadusel lisada või kustutada. NIC-liides lukustatakse, kui see on liidese liidese osa.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.	tõsi
orjad	String []	Kõik NIC-liidesed, mis loovad sideme. Nõutav on NIC-parameeter nimi.	tõsi
režiimis	nöör	See on liimimisliidese töörežiim. Valikud on järgmised: tasakaal-rr, Ümmargune poliitika; aktiivne varukoopiaAktiivne varukoopia; tasakaalu - võiXOR poliitika; ülekanne, Ringhäälingupoliitika; 802.3ad, IEEE 802.3ad LACP; tasakaal-tlbAdaptive saatekoormuse tasakaalustamine; tasakaal-alb, Kohanduv koormuse tasakaalustamine. Need väärtused on määratletud punktis Võrk> Liimimisliidesed.	tõsi

Vastuse näide:

{
   "description" : "Add a bond interface",
   "params" : {
      "mac" : "a2:6d:80:29:87:c6",
      "mode" : "balance-rr",
      "name" : "bondiface",
      "slaves" : [
         {
            "name" : "eth3"
         },
         {
            "name" : "eth2"
         }
      ],
      "status" : "down"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on konfigureeritud parameetrid.

Väli	KASUTUSALA	Kirjeldus
mac	nöör	Linkkihi unikaalne tunnus. See on mac esimese NIC liidese orja.
nimi	nöör	Liidese nimi. Seda kasutatakse liidese kordumatu identifikaatorina.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.
orjad	Objekt []	NIC-liidesed, mis loovad sidumisliidese.
režiimis	nöör	See on liimimisliidese töörežiim. Valikud on järgmised: tasakaal-rr, Ümmargune poliitika; aktiivne varukoopiaAktiivne varukoopia; tasakaalu - võiXOR poliitika; ülekanne, Ringhäälingupoliitika; 802.3ad, IEEE 802.3ad LACP; tasakaal-tlbAdaptive saatekoormuse tasakaalustamine; tasakaal-alb, Kohanduv koormuse tasakaalustamine. Need väärtused on määratletud punktis Võrk> Liimimisliidesed.

Ori objekt:

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Nimi on NIC orja liidese unikaalne identifikaator.

Muuda sidumisliidest

Muuda sidumisliidest

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.121","netmask":"255.255.255.0","gateway":"192.168.100.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface

PUT /interfaces/bonding/<name>

Muuda sidumisliidese parameetreid. nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.

Vastuse näide:

{
   "description" : "Modify bond address",
   "params" : {
      "gateway" : "192.168.100.1",
      "ip" : "192.168.100.121",
      "netmask" : "255.255.255.0"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta sidumiskonfiguratsioon

Kustuta sidumiskonfiguratsioon

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface

DELETE /interfaces/bonding/<name>

Kustutage liidese liidese konfiguratsioon. Konfiguratsiooniparameetrid on järgmised: värav, ip ja võrgumask.

nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete bonding network configuration",
   "message" : "The configuration for the bonding interface bondiface has been deleted.",
   "success" : "true"
}

Määra sidumisliidese toiming

Määra sidumisliidese toiming

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"up"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/actions

POST /interfaces/bonding/<name>/actions

Rakendage liimimisliidesele toiming. See kõne võimaldab sidumisliidese kustutamist ja selle lubamist või keelamist.

Vajalik on sidumisliidese kustutamine hävitama toiming, kui soovite kasutada kasutatud NIC-liideseid lukustuses. Sidumisjuht taastab seejärel MAC-aadressid, mida liikmeliidesed olid enne sidumisliidese lisamist.

nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Liidesele rakendatav tegevus. Olemasolevad väärtused on järgmised: up lubage liides ja valmistage see ette kasutamiseks alla keelake liides, et pakette ei saada või mitte, hävitama kustutada liimimine ja taastada NIC-i orjade liidesed.	tõsi

Vastuse näide:

{
   "description" : "Action on bond interface",
   "params" : {
      "action" : "up"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Lisa liimimisliides

Lisa liimimisliides

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"eth4"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/slaves

POST /interfaces/bonding/<name>/slaves

Lisage olemasoleva sidumisliidese jaoks NIC liides slave.

nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
nimi	nöör	NIC-liidesed nimi liimimisliidese lisamiseks.	tõsi

Vastuse näide:

{
   "description" : "Add a slave to a bond interface",
   "params" : {
      "mac" : "a2:6d:80:29:87:c6",
      "mode" : "balance-rr",
      "name" : "bondiface",
      "slaves" : [
         {
            "name" : "eth3"
         },
         {
            "name" : "eth2"
         },
         {
            "name" : "eth4"
         }
      ],
      "status" : "up"
   }
}

Vastuse parameetrid

Vastus on värskendatud konfigureeritud väärtustega json. Lisateabe saamiseks vaadake vastuse näidet.

Eemaldage liimimisliides

Eemaldage liimimisliides

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/slaves/eth2

DELETE /interfaces/bonding/<name>/slaves/<name>

Kustutage liidesest NIC-liides. Sidumisliidese peab olema peaaegu üks NIC-i alliliides.

esimene nimi on DELETE kõne on sidumisnime unikaalne identifikaator nimi aasta DELETE kõne on liidese nime unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Remove bonding slave interface",
   "message" : "The bonding slave interface eth2 has been removed.",
   "success" : "true"
}

Võrgu - VLAN liidesed

VLAN-i liides võimaldab NIC-i või sidumisliidese tööd teises võrgus, nii et IP, värav ja võrgumask väljad võivad olla vanemliidesest erinevad. VLAN-i liides pärsib MAC-aadressi oma vanemliideselt.

VLAN-i liideste väli nimi ilmub punktiga ".", mida kasutatakse vlan-liidese identifikaatorite loomiseks.

Nimeta VLAN-i liidesed

Nimeta VLAN-i liidesed

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan

GET /interfaces/vlan

Hankige kõik VLAN-i liideste parameetrid.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on VLAN-i liidese objekti massiiv.

VLAN-i parameetrid on järgmised:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. See võib olla erinev algseadme IP-st.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.
mac	nöör	Liidese MAC. See väärtus pärineb vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on kett, mille moodustab vanema liidese nimi, punktmärk “.” ja vlan-võrguliidese või vlan-märgendi number.
vanem	nöör	Selle loomiseks kasutatakse seda liidest.
staatus	nöör	Väärtused võivad olla up liides võib vastu võtta pakette, alla liides ei saa pakette vastu võtta.

VLAN-i liidese hankimine

VLAN-i liidese hankimine

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1

GET /interfaces/vlan/<name>

Hankige kõik VLAN-i liidese parameetrid. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.
mac	nöör	Liidese MAC. See väärtus pärineb vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on kett, mille moodustab vanema liidese nimi, punktmärk “.” ja vlan-võrguliidese number.
staatus	nöör	Väärtused võivad olla up liides võib vastu võtta pakette, alla liides ei saa pakette vastu võtta.

Loo VLAN-i liides

Loo VLAN-i liides

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.120.120","netmask":"255.255.255.0","gateway":"192.168.120.1", "name":"eth0.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan

POST /interfaces/vlan

Looge VLAN-i liides NIC-i või sidumisliidese kaudu. Uus VLAN-i liides jagab MAC-i, kuigi järgmised võrguparameetrid peavad olema erinevad: ipja järgmised muudatused võivad muutuda: värav, võrgumask.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Liidese IP. See peab olema erinev algseadme IP-st.	tõsi
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.	tõsi
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.	tõsi
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on kett, mille moodustab vanema liidese nimi, punktmärk “.” ja vlan-võrguliidese number.	tõsi

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda VLAN-i liidest

Muuda VLAN-i liidest

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155","netmask":"255.255.255.0","gateway":"192.168.131.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1

PUT /interfaces/vlan/<name>

Muuda VLAN-i liidese parameetreid. nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. See võib olla erinev algseadme IP-st.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks.

Vastuse näide:

{
   "description" : "Modify VLAN interface",
   "params" : {
      "gateway" : "192.168.131.1",
      "ip" : "192.168.131.155",
      "netmask" : "255.255.255.0"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta VLAN-i liides

Kustuta VLAN-i liides

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1

DELETE /interfaces/vlan/<name>

VLAN-liidese kustutamine. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete VLAN interface",
   "message" : "The VLAN interface eth0.1 has been deleted.",
   "success" : "true"
}

Seadke VLAN-i liidese tegevus

Seadke VLAN-i liidese tegevus

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1/actions

POST /interfaces/vlan/<name>/actions

Rakenda VLAN-liidesele toiming. See kõne võimaldab võrguliidese lubamist või keelamist.

nimi on unikaalne nimi.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Liidesele rakendatav tegevus. Olemasolevad väärtused on järgmised: uplubage liides ja valmistage see ette kasutamiseks; alla, keelake liides, et pakette mitte vastu võtta või mitte.	tõsi

Vastuse näide:

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

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Võrk - virtuaalsed liidesed

Võrgu liidesed võimaldavad kasutajatel olla samas võrgusegmendis teine ​​võrguliides, kui vanem, nii et virtuaalsed liidesed pärivad võrgukonfiguratsiooni alati oma vanemalt. Erinev parameeter on ip. Virtuaalset liidest saab luua NIC, side või VLAN abil. Uue virtuaalse liidese loomine ilmub kooloniga „:” tähistatud väljale, mida kasutatakse virtuaalse liidese identifitseerimise loomiseks.

Nimekiri virtuaalsed liidesed

Nimekiri virtuaalsed liidesed

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual

GET /interfaces/virtual

Hankige kõik virtuaalsete liideste parameetrid.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. IP peab olema samas võrgusegmendis kui vanemliides.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab. See pärineb vanemliideselt.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks. See pärineb vanemliideselt.
mac	nöör	Liidese MAC. See pärineb vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on vanemliidese poolt moodustatud kett, koolon märk „:” ja virtuaalse võrguliidese nimi, tähtnumbrilised tähemärgid on lubatud.
vanem	nöör	Selle loomiseks kasutatakse seda liidest.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.

Too virtuaalne liides

Too virtuaalne liides

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface

GET /interfaces/virtual/<name>

Hangi kõik virtuaalse liidese parameetrid. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. IP peab olema samas võrgusegmendis kui vanemliides.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab. See pärineb vanemliideselt.
värav	nöör	IP, mida kasutatakse erinevate võrgusegmendi pakettide saatmiseks. See pärineb vanemliideselt.
mac	nöör	Liidese MAC. See pärineb vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on ahel, mille moodustavad vanemliides, koolon märk „:” ja virtuaalse võrguliidese tähtnumbriline string.
vanem	nöör	Selle loomiseks kasutatakse seda liidest.
staatus	nöör	Väärtused võivad olla up, liides võib vastu võtta pakette; alla, liides ei saa pakette vastu võtta.

Loo virtuaalne liides

Loo virtuaalne liides

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.41", "name":"eth0:virtiface"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual

POST /interfaces/virtual

Loo virtuaalne liides.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
ip	nöör	Liidese IP. IP peab olema samas võrgusegmendis kui vanemliides.	tõsi
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on ahel, mille moodustavad vanemliides, koolon märk „:” ja virtuaalse võrguliidese tähtnumbriline string.	tõsi

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Vastuseks on liidesekonfiguratsioon. Lisateabe saamiseks vaadake vastuse näidet.

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. IP peab olema samas võrgusegmendis kui vanemliides.
võrgumask	nöör	Määrake võrgusegment, kus liides töötab. See pärineb vanemliideselt.
värav	nöör	IP, mida kasutatakse pakettide saatmiseks teisele võrgusegmendile. See pärineb vanemliideselt.
mac	nöör	Liidese MAC. See pärineb vanemliideselt.
nimi	nöör	Liidese nimi. Seda kasutatakse kordumatu identifikaatorina. See nimi on kett, mis on moodustatud vanemliidese, koolonimärgi „:” ja virtuaalse võrguliidese tähtnumbrilise stringi abil.

Virtuaalse liidese muutmine

Virtuaalse liidese muutmine

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface

PUT /interfaces/virtual/<name>

Muutke virtuaalse liidese parameetreid. nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Liidese IP. IP peab olema samas võrgusegmendis kui vanemliides.

Vastuse näide:

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

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta virtuaalne liides

Kustuta virtuaalne liides

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface

DELETE /interfaces/virtual/<name>

Virtuaalsete liideste kustutamine. nimi on liidese unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete virtual interface",
   "message" : "The virtual interface eth0:virtiface has been deleted.",
   "success" : "true"
}

Seadista virtuaalse liidese tegevus

Seadista virtuaalse liidese tegevus

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface/actions

POST /interfaces/virtual/<name>/actions

Rakendage toimingut virtuaalsele liidesele. See kõne võimaldab võrguliidese lubamist või keelamist.

nimi on liidese unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Liidesele rakendatav tegevus. Olemasolevad väärtused on järgmised: uplubage liides ja valmistage see ette kasutamiseks; alla, keelake liides, et pakette mitte vastu võtta või mitte.	tõsi

Vastuse näide:

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

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Võrk - ujuvad liidesed

Selline liides kasutab määratletud virtuaalset liidest ja varjab a Nic, bonding or VLAN liides lapsega virtuaalne liides. Seda liidest kasutatakse l4xnati profiilides olekus, kus klaster on konfigureeritud.

Nimekirja ujuvad liidesed

Nimekirja ujuvad liidesed

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating

GET /interfaces/floating

Näita kõiki kasutatavaid või konfigureeritud liideseid, kus ujuv IP on loodud.

Vastuse näide:

{
   "description" : "List floating interfaces",
   "params" : [
      {
         "floating_ip" : null,
         "interface" : "bondiface"
      },
      {
         "floating_ip" : "192.168.100.199",
         "interface" : "eth0"
      },
      {
         "floating_ip" : null,
         "interface" : "eth0.1"
      },
      {
         "floating_ip" : null,
         "interface" : "eth1"
      }
   ]
}

Vastuse parameetrid

Vastus on JSON-objekt, millel on ujuva liidese objekti massiiv:

Ujuv objekt:

Väli	KASUTUSALA	Kirjeldus
floating_ip	nöör	Ujuv IP kasutati liides. floating_ip peab eksisteerima virtuaalse liidese lapsena liides.
liides	nöör	Liidesega varjatud liides.

Laadi ujuv liides

Laadi ujuv liides

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0

GET /interfaces/floating/<name>

Näitab, kas liidesel on konfigureeritud ujuv IP. Kui sellel on üks konfiguratsioon, kuvatakse see siin.

nimi on liidese unikaalne identifikaator, mis võib olla n-tüüpi, siduv või vlan-tüüpi.

Vastuse näide:

{
   "description" : "Show floating interface",
   "params" : {
      "floating_ip" : "192.168.100.199",
      "interface" : "eth0"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
floating_ip	nöör	Ujuv IP kasutati liides. floating_ip peab eksisteerima virtuaalse liidese lapsena liides.
liides	nöör	Liidesega varjatud liides.

Muuda ujuvat liidest

Muuda ujuvat liidest

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"floating_ip":"192.168.100.199"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0

PUT /interfaces/floating/<name>

Seadistage ujuv IP NIC-, sidumis- või VLAN-liidese jaoks.

nimi on liidese unikaalne identifikaator, mis võib olla n-tüüpi, siduv või vlan-tüüpi.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
floating_ip	nöör	Ujuv IP kasutati liides. floating_ip peab eksisteerima virtuaalse liidese lapsena liides.	tõsi

Vastuse näide:

{
   "description" : "Modify floating interface",
   "message" : "Floating interface modification done",
   "success" : "true"
}

Kustuta ujuv konfiguratsioon

Kustuta ujuv konfiguratsioon

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0

DELETE /interfaces/floating/<name>

Eemaldage liideses ujuv IP-konfiguratsioon.

nimi on liidese unikaalne identifikaator, mis võib olla n-tüüpi, siduv või vlan-tüüpi.

Vastuse näide:

{
   "description" : "Remove floating interface",
   "message" : "The floating interface has been removed.",
   "success" : "true"
}

Järelevalve - statistika

Näita teavet süsteemi ja talude kohta. See teave on kasulik Zeveneti koormuse tasakaalustaja oleku jälgimiseks.

Näita süsteemi statistikat

Näita süsteemi statistikat

Päringu näide:

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

GET /stats

Hankige globaalse süsteemi statistika.

Vastuse näide:

{
   "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" : {
         "bond0 in in" : 234.72,
         "bond0 out out" : 0,
         "bond0.10 in in" : 0,
         "bond0.10 out out" : 0,
         "bond1 in in" : 234.72,
         "bond1 out out" : 0,
         "bond3 in in" : 815.69,
         "bond3 out out" : 4300.38,
         "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
      }
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
cpu	objekt	CPU statistika.
andmed	nöör	Süsteemi kuupäev.
hostname	nöör	Saatejuhi nimi.
koormus	objekt	Põhikoormuse statistika.
mälu	objekt	Kasutatud mälu statistika.
võrk	objekt	Võrgu liikluse statistika.

CPU objekt:

Väli	KASUTUSALA	Kirjeldus
südamikud	Number	Protsessori südamike arv.
tühikäigul	Number	CPU ei kasuta ühtegi programmi.
iowait	Number	Sisend- või väljundprotsessis kasutatav protsessor.
irq	Number	CPU, mida kasutavad riistvaravälised häired.
kena	Number	CPU sõiduplaani prioriteet.
softirq	Number	Tarkvarakatkestuste poolt kasutatav protsessor.
sys	Number	Süsteemi kasutatav protsessor.
kasutus	Number	Kasutatav CPU.
kasutaja	Number	Kasutaja poolt kasutatav protsessor.

Laadige objekt:

Väli	KASUTUSALA	Kirjeldus
Last_1	Number	Laadige süsteem viimase minuti jooksul.
Last_5	Number	Laadige süsteemi keskmiselt viis minutit tagasi.
Last_15	Number	Laadige süsteem viiekümne minuti tagant.

Mäluobjekt.

Väli	KASUTUSALA	Kirjeldus
Puhvrid	Number	See on puhvrite poolt kasutatav mälu. See summa on märgitud Mb.
Vahemällu salvestatud	Number	See on süsteemi mällu salvestatud kogu mälu. See summa on märgitud Mb.
MemFree	Number	See on kogu vaba mälu, mida süsteem pole vahemällu salvestanud. See summa on märgitud Mb.
MemTotal	Number	See on süsteemi kogu mälu mälu. See summa on märgitud Mb.
MemUsed	Number	See on süsteemi poolt kasutatav mälu. See summa on märgitud Mb.
Vaheta vahetatud	Number	See on kogu vahemälu reserveeritud.
SwapFree	Number	See on kogu vaba mälu, mida süsteem pole vahemällu salvestanud. See summa on märgitud Mb.
Vaheta kokku	Number	See on kogu vahetusmälu reserveeritud.
SwapUsed	Number	See on süsteemi poolt kasutatav mälu, optimaalsetel süsteemidel peaks olema 0.

Võrguobjekt:

Väli	KASUTUSALA	Kirjeldus
aastal sisse	Number	Sisestage liiklus selleks liides.
välja	Number	Selle jaoks väljastage liiklust liides.

Kuva võrgu statistika

Kuva võrgu statistika

Päringu näide:

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

GET /stats/system/network

Hankige kokkuvõte sisend- ja väljundliiklusest võrguliidese kaudu.

Vastuse näide:

{
   "description" : "Network interfaces usage",
   "params" : {
      "date" : "Fri Jan 27 11:58:05 2017",
      "hostname" : "api3",
      "interfaces" : [
         {
            "in" : "234.72",
            "interface" : "bond1",
            "out" : "0.00"
         },
         {
            "in" : "77.42",
            "interface" : "eth6",
            "out" : "0.00"
         },
         {
            "in" : "2703.88",
            "interface" : "eth0",
            "out" : "50917.65"
         },
         {
            "in" : "815.69",
            "interface" : "bond2",
            "out" : "4300.38"
        }
      ]
   }
}

Vastuse parameetrid

Vastuseks on võtmega JSON parameetrid mille väärtus on järgmiste võtmetega objekt:

Väli	KASUTUSALA	Kirjeldus
andmed	nöör	Süsteemi kuupäev.
hostname	nöör	Saatejuhi nimi.
liidesed	Objekt []	Võrgu liikluse statistika.

Liidese objekt

Väli	KASUTUSALA	Kirjeldus
in	nöör	Kogu sisendliiklus MB-s.
liides	nöör	Liidese nimi.
välja	nöör	Väljundite koguarv MB.

Näita liideste statistikat

Näita liideste statistikat

Päringu näide:

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

GET /stats/system/network/interfaces

Hankige iga võrguliidese kokkuvõte.

Vastuse näide:

{
   "description" : "Interfaces info",
   "params" : {
      "bond" : [
         {
            "in" : "234.72",
            "interface" : "bond1",
            "ip" : "",
            "mac" : "3a:3a:a7:e3:33:73",
            "out" : "0.00",
            "slaves" : [
               "eth2"
            ],
            "status" : "down",
            "virtual" : [],
            "vlan" : []
         },
         {
            "in" : "815.70",
            "interface" : "bond3",
            "ip" : "",
            "mac" : "ea:00:7d:88:1d:bd",
            "out" : "4300.38",
            "slaves" : [
               "eth4",
               "eth5",
               "eth6"
            ],
            "status" : "up",
            "virtual" : [],
            "vlan" : []
         },
         {
            "in" : "234.72",
            "interface" : "bond0",
            "ip" : "",
            "mac" : "c2:d0:d7:64:df:68",
            "out" : "0.00",
            "slaves" : [
               "eth1"
            ],
            "status" : "down",
            "virtual" : [],
            "vlan" : [
               "bond0.10"
            ]
         }
      ],
      "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"
            ]
         }
      ]
   }
}

Vastuse parameetrid

Vastuseks on võtmega JSON parameetrid mille väärtus on võtmetega objekt võlakiri ja Nic.

Väli	KASUTUSALA	Kirjeldus
võlakiri	Objekt []	Võlakirjaliidese statistika.
Nic	Objekt []	NIC-liidese statistika.

Võlakiri:

Väli	KASUTUSALA	Kirjeldus
in	nöör	Kogu sisendliiklus MB-s.
liides	nöör	Unikaalse identifikaatorina kasutatav liidese nimi.
ip	nöör	Liidese IP.
mac	nöör	Liidese MAC.
välja	nöör	Kogu väljundliiklus MB-s.
orjad	String []	Nimekiri orjadest, mis ehitavad sideme liidese.
staatus	nöör	Liidese olek. Väärtus võib olla alla, liides on keelatud; up, liides on lubatud.
virtuaalne	String []	Virtuaalsed liidesed, mis pärivad selle liidese kaudu.
vlan	String []	Sellest liidesest pärinevad VLAN-liidesed.

Nic objekt:

Väli	KASUTUSALA	Kirjeldus
in	nöör	Kogu sisendliiklus MB-s.
liides	nöör	Unikaalse identifikaatorina kasutatav liidese nimi.
ip	nöör	Liidese IP.
mac	nöör	Liidese MAC.
välja	nöör	Kogu väljundliiklus MB-s.
staatus	nöör	Liidese olek. Väärtus võib olla alla, liides on keelatud; up, liides on lubatud.
virtuaalne	String []	Virtuaalsed liidesed, mis pärivad selle liidese kaudu.
vlan	String []	Sellest liidesest pärinevad VLAN-liidesed.

Näita mälu statistikat

Näita mälu statistikat

Päringu näide:

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

GET /stats/system/memory

Hankige süsteemi mälu kokkuvõte.

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Vastuseks on võtmega JSON parameetrid mille väärtus on mäluobjekt.

Mälu objekt

Väli	KASUTUSALA	Kirjeldus
Puhvrid	Number	See on puhvrite poolt kasutatav mälu. See summa on märgitud Mb.
Vahemällu salvestatud	Number	See on süsteemi mällu salvestatud kogu mälu. See summa on märgitud Mb.
MemFree	Number	See on kogu vaba mälu, mida süsteem pole vahemällu salvestanud. See summa on märgitud Mb.
MemTotal	Number	See on süsteemi kogu mälu mälu. See summa on märgitud Mb.
MemUsed	Number	See on süsteemi poolt kasutatav mälu. See summa on märgitud Mb.
Vaheta vahetatud	Number	See on kogu vahemälu reserveeritud.
SwapFree	Number	See on kogu vaba mälu, mida süsteem pole vahemällu salvestanud. See summa on märgitud Mb.
Vaheta kokku	Number	See on kogu vahetusmälu reserveeritud.
SwapUsed	Number	See on süsteemi poolt kasutatav mälu, optimaalsetel süsteemidel peaks olema 0.
andmed	nöör	Süsteemi kuupäev.
hostname	nöör	Saatejuhi nimi.

Näita koormuse statistikat

Näita koormuse statistikat

Päringu näide:

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

GET /stats/system/load

Hankige CPU süsteemi koormuse kokkuvõte.

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
Last_1	Number	Koormussüsteemi kasutamine viimane.
Last_5	Number	Laadimissüsteemi kasutamine viimase viie minuti jooksul.
Last_15	Number	Koormussüsteemi kasutamine viimase fiveteen minutiga.
andmed	nöör	Süsteemi kuupäev.
hostname	nöör	Saatejuhi nimi.

Näita CPU statistikat

Näita CPU statistikat

Päringu näide:

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

GET /stats/system/cpu

Vastuse näide:

{
   "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
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
südamikud	Number	Protsessori südamike arv.
tühikäigul	Number	CPU ei kasuta ühtegi programmi.
iowait	Number	Sisend- või väljundprotsessis kasutatav protsessor.
irq	Number	CPU, mida kasutavad riistvaravälised häired.
kena	Number	CPU sõiduplaani prioriteet.
softirq	Number	Tarkvarakatkestuste poolt kasutatav protsessor.
sys	Number	Süsteemi kasutatav protsessor.
kasutus	Number	Kasutatav CPU.
kasutaja	Number	Kasutaja poolt kasutatav protsessor.
andmed	nöör	Süsteemi kuupäev.
hostname	nöör	Saatejuhi nimi.

Kuva ühenduste statistika

Kuva ühenduste statistika

Päringu näide:

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

GET /stats/system/connections

Hankige süsteemis praeguste ühenduste koguarv. Loendur võtab kokku mis tahes tüüpi jälgitavad ühendused: TAGATUD, ESTABLISED, SYN_SENT, TIME_WAIT, LISTEN…

Vastuse näide:

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

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
ühendused	Number	Jälgitud ühendused kokku.

Kuva põllumajandusettevõtete arv

Kuva põllumajandusettevõtete arv

Päringu näide:

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

GET /stats/farms/total

Näita süsteemis loodud talude koguarvu.

Vastuse näide:

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

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
number	Number	See on süsteemis olemasolevate põllumajandusettevõtete arv.

Näita talude statistikat

Näita talude statistikat

Päringu näide:

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

GET /stats/farms

Hankige kõikide süsteemide ühenduste ja konfiguratsiooni kokkuvõte.

Vastuse näide:

{
   "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"
      },
      {
         "established" : 0,
         "farmname" : "testGSLB",
         "pending" : 0,
         "profile" : "gslb",
         "status" : "up",
         "vip" : "192.168.10.31",
         "vport" : "53"
      }
   ]
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
asutatud	Number	Praegu loodud ühenduste koguarv.
farmname	nöör	Põllumajandusettevõtte nimi, kordumatu tunnus.
kuni	Number	Ootel olevate ühenduste arv.
profiil	nöör	Põllumajandusettevõtte tüüp. Võimalikud väärtused on: andmelink, l4xnat, http, https or gslb. Iga profiil on määratletud selle jaotises.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up, talu töötab; alla, talu on peatatud või vaja uuesti taaskäivitada, et viimaste muudatuste jõustumiseks tuleb talu uuesti alustada.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	nöör	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.

Näita põllumajandusstatistikat

Näita põllumajandusstatistikat

Päringu näide:

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

GET /stats/farms/<farmname>

Näitab praegust talu staatust, nende taustaprogrammi ja ühendusi. Iga põllumajandusettevõte reageerib sõltuvalt profiilist erineva objektiga.

HTTP põllumajandusettevõtte vastuse näide:

{
   "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"
      }
   ]
}

Reageerimisparameetrid HTTP taludes

Väli	KASUTUSALA	Kirjeldus
taustaprogrammid	Objekt []	Kuva taustaprogrammide teave.
istungid	Objekt []	Näita teavet seansside kohta.

Backend-objekt

Väli	KASUTUSALA	Kirjeldus
asutatud	Number	Kindlaksmääratud ühenduste koguarv.
id	Number	Taustaprogrammi unikaalne identifikaator.
ip	nöör	IP, kus tegelik teenus kuulab.
kuni	Number	Ootel olevate ühenduste arv.
port	Number	Sadam, kus tegelik teenus kuulab.
teenus	nöör	Unikaalse identifikaatorina kasutatav teenuse nimi.
staatus	nöör	Taustase staatus. Võimalikud väärtused on: up, backend on valmis ühenduste vastuvõtmiseks; alla, on teenus tuvastanud, et taustaprogramm ei tööta; FGDOWN, on taluvalvur taustaprogrammi keelanud, kuna talupidaja kontroll ei õnnestunud; hooldus, taustaprogramm on märgitud kui administraator pole ühenduste vastuvõtmiseks valmis, see valik on kasulik taustaprogrammi hooldustoimingute jaoks.

Seansi objekt

Väli	KASUTUSALA	Kirjeldus
klient	nöör	Kliendi kordumatu tunnus.
id	nöör	Kliendile määratud unikaalne tunnus.
teenus	nöör	Kliendile määratud teenuse kordumatu tunnus.
istung	nöör	Seansi kordumatu tunnus. See väärtus sõltub püsivuse tüübist.

GSLB talu vastuse näide:

{
   "backends" : [
      {
         "id" : 1,
         "ip" : "127.0.0.1",
         "port" : 53,
         "service" : "service1",
         "status" : "down"
      },
      {
         "id" : 2,
         "ip" : "192.168.55.40",
         "port" : 53,
         "service" : "service1",
         "status" : "down"
      },
      {
         "id" : 4,
         "ip" : "192.135.10.2",
         "port" : 53,
         "service" : "service1",
         "status" : "down"
      },
      {
         "id" : 1,
         "ip" : "127.0.0.1",
         "port" : 80,
         "service" : "prioServ",
         "status" : "down"
      },
      {
         "id" : 2,
         "ip" : "127.0.0.1",
         "port" : 80,
         "service" : "prioServ",
         "status" : "down"
      }
   ],
   "client" : {
      "edns_big" : 0,
      "edns_tc" : 0,
      "recvfail" : 0,
      "reqs" : 0,
      "sendfail" : 0,
      "tc" : 0
   },
   "description" : "List farm stats",
   "extended" : {
      "badvers" : 0,
      "dropped" : 0,
      "edns" : 0,
      "edns_clientsub" : 0,
      "formerr" : 0,
      "noerror" : 0,
      "notimp" : 0,
      "nxdomain" : 0,
      "refused" : 0,
      "v6" : 0
   },
   "server" : {
      "recvfail" : 0,
      "reqs" : 0,
      "sendfail" : 0
   }
}

Vastusparameetrid GSLB taludes

Väli	KASUTUSALA	Kirjeldus
taustaprogrammid	Objekt []	Näita taustaprogrammide kohta teavet.
klient	objekt	Kliendiga seotud statistika.
pikendatud	objekt	Laiendatud teave teenuse kohta.
server	objekt	Serveriga seotud statistika.

Backend-objekt

Väli	KASUTUSALA	Kirjeldus
id	Number	Taustaprogrammi unikaalne identifikaator.
ip	nöör	IP, kus tegelik teenus kuulab.
port	Number	Sadam, kus tegelik teenus kuulab.
teenus	nöör	Unikaalse identifikaatorina kasutatav teenuse nimi.
staatus	nöör	Taustase staatus. Võimalikud väärtused on: up, backend on valmis ühenduste vastuvõtmiseks; alla, on teenus tuvastanud, et taustaprogramm ei tööta; hooldus, taustaprogramm on märgitud kui administraator pole ühenduste vastuvõtmiseks valmis, see valik on kasulik taustaprogrammi hooldustoimingute jaoks.

Kliendi objekt

Väli	KASUTUSALA	Kirjeldus
edns_big	Number	Vastused, mis olid suuremad kui 512 baiti.
edns_tc	Number	Kliendi määratud laiendatud dns-puhvri suurus oli taotletud andmete jaoks liiga väike.
recvfail	Number	UDP-vigade arv, kus operatsioonisüsteem näitas, et vastuvõtmisel juhtus midagi halba.
reqs	Number	Serveriga töödeldud UDP-päringute koguarv.
sendfail	Number	UDP-vigade arv, kus operatsioonisüsteem osutas, et saatmisel oli midagi halba.
tc	Number	Vastused, mis olid kärbitud TC bitikomplektiga.

Laiendatud objekt

Väli	KASUTUSALA	Kirjeldus
badversid	Number	Taotlus, millel oli EDNS OPT-RR ja versioon, mida ei toetatud.
langes	Number	Vigastatud vormingu taotluste tühistamine.
edns	Number	Taotlus sisaldas EDNS OPT-RR.
edns_clientsub	Number	Edns_client_subnet valikule määratud edns-päringute alamhulk.
agr	Number	Taotlus oli halvasti vormindatud, kuid oli piisavalt mõistlik, et me saatisime vastuse rcode FORMERR'iga.
hirmus	Number	Edukad taotlused.
notimp	Number	Taotletud teenus, mida see deemon ei rakendanud, näiteks tsooni ülekande taotlused.
nxdomain	Number	Taotlus mitte-olemasoleva domeeninime järele.
keeldus	Number	Server jättis taotluse tagasi, sest server ei ole küsitava nime jaoks autoriteetne.
v6	Number	IPv6i kliendi taotlus.

Serveri objekt

Väli	KASUTUSALA	Kirjeldus
recvfail	Number	TCP-vigade arv, kus operatsioonisüsteem näitas, et vastuvõtmisel juhtus midagi halba.
reqs	Number	Serveriga töödeldud TCP-päringute koguarv.
sendfail	Number	TCP-vigade arv, kus operatsioonisüsteem osutas, et saatmisel on midagi halba.

L4xNAT talu vastuse näide:

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

Vastusparameetrid L4xNAT taludes

Vastuseks on võtmega JSON taustaprogrammid ja väärtustada objekti massiivi allpool toodud parameetritega.

Backend-objekt:

Väli	KASUTUSALA	Kirjeldus
asutatud	Number	Praegu loodud ühenduste koguarv.
id	Number	Taustaprogrammi unikaalne identifikaator.
ip	nöör	IP, kus tegelik teenus kuulab.
kuni	Number	Ootel olevate ühenduste arv.
port	Number	Sadam, kus tegelik teenus kuulab.
staatus	nöör	Taustase staatus. Võimalikud väärtused on: up, backend on valmis ühenduste vastuvõtmiseks; FGDOWNtalu eestkostja on avastanud, et taustaprogramm ei tööta; hooldus, taustaprogramm on märgitud kui administraator pole ühenduste vastuvõtmiseks valmis, see valik on kasulik taustaprogrammi hooldustoimingute jaoks.

Vastusparameetrid datalinkide taludes

Datalinki talude statistika ei ole tegelikult kättesaadav.

Näita mooduli olekut

Näita mooduli olekut

Päringu näide:

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

GET /stats/farms/modules

Hankige moodulite statistika kokkuvõte. See kõne näitab iga mooduli olekut, konfigureeritud arvu, kasvanduste arvu ja üles.

Moodulite määratlus on sisse lülitatud Põllumajandusettevõtted sektsiooni.

Vastuse näide:

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

Vastuse parameetrid

Vastuseks on JSON, millel on kolm võtit: dslb, gslb ja lllb.

Väli	KASUTUSALA	Kirjeldus
alla	Number	Peatatud talude arv. Süsteemihaldur peatab need talud.
summaarne	Number	Kokku põllumajandusettevõtete arv.
up	Number	Käimasolevate põllumajandusettevõtete arv.

Näita mooduli statistikat

Näita mooduli statistikat

Päringu näide:

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

GET /stats/farms/modules/<module>

Näita konkreetse mooduli põllumajandusettevõtete statistikat.

. \ T moodul parameeter on: lllb, gslb or dslb.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, mis sisaldab teavet moodulite talude kohta.

Väli	KASUTUSALA	Kirjeldus
asutatud	Number	Praegu loodud ühenduste koguarv.
farmname	nöör	Põllumajandusettevõtte nimi, põllumajandusettevõtete kordumatu tunnus.
kuni	Number	Ootel olevate ühenduste arv.
profiil	nöör	Põllumajandusettevõtte tüüp. Võimalikud väärtused on: andmelink, l4xnat, http, https or gslb. Iga profiil on defineeritud ise.
staatus	nöör	Talu staatus. Võimalikud väärtused on: up, talu töötab; alla, talu on peatatud või vaja uuesti taaskäivitada, et viimaste muudatuste jõustumiseks tuleb talu uuesti alustada.
vip	nöör	Fondi IP, kus virtuaalne teenus kuulab.
vport	nöör	Põllumajandusettevõtte sadam, kus virtuaalne teenus kuulab.

Järelevalve - graafikud

See osa on kasulik sisemise koormuse tasakaalustussüsteemi jälgimiseks, et avastada probleeme CPU kasutuse parameetrite, vahetusmälu, mälu mälu, kõigi konfigureeritud neworki liideste, koormuse ja kõvaketta salvestamise kaudu.

Samuti saate juurdepääsu iganädalasele, koole ja aastale.

Informatsiooniga graafikud vastatakse base64 formaadis.

Saada kättesaadavad graafikud

Saada kättesaadavad graafikud

Päringu näide:

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

GET /graphs

Näita objekti kõigi olemasolevate graafikutega süsteemis. See näitab võimalikku taotlust, mida saab teha.

Vastuse näide:

{
   "description" : "These are the possible graphs, you`ll be able to access to the daily, weekly, monthly or yearly graph",
   "farms" : [
      "l4farm",
      "newfarm",
      "gslbfarm",
      "nwl4farm",
      "httpweb"
   ],
   "interfaces" : [
      "eth0.1",
      "eth2",
      "eth1",
      "eth3",
      "bondiface",
      "eth0"
   ],
   "system" : [
      "cpu",
      "load",
      "ram",
      "swap",
      {
         "disk" : [
            "root/",
            "root/boot",
            "root/usr/local/zenloadbalancer/config",
            "root/var/log"
         ]
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSONi kolme tüüpi graafikud, talud, liidesed ja süsteem.

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete graafikute nimekiri.
liidesed	String []	Liideste loend, kus graafikud on saadaval.
süsteem	Objekt []	Süsteemide graafikute nimekiri. Massiivil on objekt, millel on massiiv, mis näitab ketta kinnituspunkte.

Süsteemi objekt:

Süsteemiobjekt sisaldab süsteemiga seotud massiiviloendit ja järgmise formaadiga ketasobjekti.

Väli	KASUTUSALA	Kirjeldus
ketas	String []	Selle massiivi väärtused on kõik olemas kinnituspunktid süsteemis, igaühel neist on olemas graafikud.

Näita graafikuid

Näita graafikuid

Taotluse näide talu kohta:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/farms/httpweb

Liidese päringu näide:

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

Ketta näitamise näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/system/disk/root/boot

GET /graphs/<graph>

Olemasolevad väärtused graafik See on:

Väärtus	Kirjeldus
farms/<farmname>	farmname, talu unikaalne identifikaator.
interfaces/<interface>	liides, liidese unikaalne identifikaator.
system/<system>	süsteemvõimalikud süsteemi graafikud on: cpu, koormus, RAM or vahetama.
system/disk/<mount point>	kinnituspunkt, on väärtuseks ketas objekt, mille tagastab kõne 'GET / graphs'.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
sagedus	nöör	Graafiku genereerimiseks kasutatud ajavahemik. Võimalikud väärtused on: iga päev, iga nädal, igakuine or aastas.
graafikud	nöör	Graafik 64-vormingus.

Näita sagedusgraafikut

Näita sagedusgraafikut

Taotluse näide talu kohta:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/farms/httpweb/daily

Liidese päringu näide:

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

Ketta näitamise näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/system/disk/root/boot/yearly

GET /graphs/<graph>/<frequency>

Olemasolevad väärtused graafik See on:

Väärtus	Kirjeldus
farms/<farmname>	farmname, talu unikaalne identifikaator.
interfaces/<interface>	liides, liidese unikaalne identifikaator.
system/<system>	süsteemvõimalikud süsteemi graafikud on: cpu, koormus, RAM or vahetama.
system/disk/<mount point>	kinnituspunkt, on väärtuseks ketas objekt, mille tagastab kõne 'GET / graphs'.

Olemasolevad väärtused sagedus See on:

Väli	KASUTUSALA	Kirjeldus
sagedus	nöör	Graafiku genereerimiseks kasutatud ajavahemik. Võimalikud väärtused on: iga päev, iga nädal, igakuine or aastas.

Vastuse näide:

{
    "description" : "Get farm graphs",
    "graph" : "PNG IN BASE 64"
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
graafikud	nöör	Graafik 64-vormingus.

IPDS

See moodul on a IPS (Sissetungi vältimise süsteem) ja IDS (Sissetungide avastamise süsteemi) süsteem, mis pakub kasutajale turvakihti. IPDS-moodul kontrollib liiklust vahetult enne, et jõuda koormuse tasakaalustamise mooduliteni LSLB or GSLB, kui liiklus avastatakse pahatahtlikuna, lükatakse see tagasi.

Ta rakendab turvaeeskirju süsteemile, mis määratletakse erineva iseloomuga objektina. Igaüks pakub lahendust välisele pahatahtlikule või kahtlasele tegevusele. See tööriist aitab süsteemi administraatoritel ähvardusi ja rünnakuid kontrollida.

Zevenetile kohaldatavad reeglid võivad olla mustad nimekirjad ja DoS.

IPDS - mustad nimekirjad

Mustlased võimaldab kasutajatel kasutada loendeid, et filtreerida või lubada liiklust vastavalt allikate IP-dele (Incomming liiklus).

On kahte tüüpi nimekirju:

1. Kaugjuhtimispuldid: loendid saadakse URL-ist, need nimekirjad ei ole modifitseeritavad ja neid saab alla laadida.
2. Kohalik: kasutajad saavad oma poliitikaga oma loendeid luua, eitama kui kaasatud IP-vasted siis lükatakse liiklus tagasi või võimaldama kui kaasatud IP-vasted siis liiklus on lubatud.

See moodul sisaldab eelsalvestatud Zevenet'i meeskonna poolt esitatud nimekirjad on nimekirja kantud põllumajandusettevõtetele. Lisaks saavad kasutajad luua oma isiklikke loendeid.

Samale talule saab rakendada mitmeid nimekirju, kui lähteteksti IP sobib mõnes loendis, liiklus on lubatud või keelatud sõltuvalt musta nimekirja poliitikast. Hetkel vastab IP-vastus siis, kui allikate IP-le ei tehta enam musti nimekirju.

Kui allika IP on kahes erinevas nimekirjas eitama ja võimaldama, siis alati lubatakse lubade andmise poliitikat esmalt.

Loetle kõik mustade nimekirjade reeglid

Loetle kõik mustad nimekirjad

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists

GET /ipds/blacklists

Loetle kõik kasutaja poolt loodud või süsteemile eelnevalt laaditud mustad nimekirjad, mida saab põllumajandusettevõtetele rakendada.

Vastuse näide:

{
   "description" : "Get black lists",
   "params" : [
      {
         "farms" : [],
         "name" : "china",
         "policy" : "deny",
         "preload" : "true",
         "type" : "local"
      },
      {
         "farms" : [],
         "name" : "russia",
         "policy" : "deny",
         "preload" : "true",
         "type" : "local"
      },
      {
         "farms" : [],
         "name" : "northkorea",
         "policy" : "deny",
         "preload" : "true",
         "type" : "local"
      },
      {
         "farms" : [
            "FarmHttp1",
            "FarmGslb1",
         ],
         "name" : "remoteList",
         "policy" : "deny",
         "preload" : "false",
         "type" : "remote"
      },
      {
         "farms" : [],
         "name" : "myWhiteList",
         "policy" : "allow",
         "preload" : "false",
         "type" : "local"
      },
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on mustade nimekirjade objektide rida, millest igaüks sisaldab allpool toodud võtmes atribuute.

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja.
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
eelkoormus	nöör	Võimalikud väärtused on: tõsi, must nimekiri on süsteemis eelsalvestatud; või vale, must nimekiri on loodud süsteemi administraatori poolt.
tüüp	nöör	Kui nimekiri on salvestatud ja kes seda säilitab. Väärtused on järgmised: kohalik, salvestatakse nimekiri kohalikus süsteemis ja seda saab muuta kohapeal või kauge, allalaaditakse loend kaugallikast a URL, Seda ei saa lokaalselt muuta, nii et muudatused tuleb teha kaugallikas.

Too mustade nimekirjade reegel

Too must nimekiri

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/loc

GET /ipds/blacklists/<name>

Näita musta nimekirja konfiguratsiooni ja kirjelduse parameetreid. nimi on mustade nimekirjade unikaalne identifikaator.

Vastuse parameetrid

Vastuse kohaliku loendi näide:

{
   "description" : "Get list loc",
   "params" : {
      "farms" : [],
      "name" : "loc",
      "policy" : "deny",
      "preload" : "false",
      "sources" : [
         {
            "id" : 0,
            "source" : "192.168.0.167"
         },
         {
            "id" : 1,
            "source" : "192.168.0.186"
         }
      ],
      "type" : "local"
   }
}

Kohalik musta nimekirja objekt:

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja.
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
eelkoormus	nöör	Võimalikud väärtused on: tõsi, must nimekiri on süsteemis eelsalvestatud; või vale, must nimekiri on loodud süsteemi administraatori poolt.
tüüp	nöör	Kui nimekiri on salvestatud ja kes seda säilitab. Väärtused on järgmised: kohalik, salvestatakse nimekiri süsteemi ja seda haldab süsteemiadministraator; või kauge, laaditakse nimekiri alla serveri urlist.
allikad	Objekt []	Loetelu IP-dest, mida loend kontrollib. Vastuvõetud allikavõrgu formaat: Võrgu aadress / mask natuke või IP

Vastuse kaugloendi näide:

{
   "description" : "Get list remoteList",
   "params" : {
      "day" : "thursday",
      "farms" : [
         "FarmHttp1",
         "FarmGslb1",
      ],
      "frequency" : "weekly",
      "name" : "remoteList",
      "policy" : "deny",
      "sources" : [
         {
            "id" : 0,
            "source" : "78.12.0.4"
         },
         {
            "id" : 1,
            "source" : "68.100.15.5"
         },
         {
            "id" : 2,
            "source" : "65.12.12.95"
         }
      ],
      "time" : {
         "hour" : 0,
         "minutes" : 0
      },
      "update_status" : "This list isn't downloaded yet.",
      "type" : "remote",
      "url" : "http://192.168.10.10/lists/test.txt"
   }
}

Musta musta nimekirja objekt:

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja.
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
eelkoormus	nöör	Võimalikud väärtused on: tõsi, must nimekiri on süsteemis eelsalvestatud; või vale, must nimekiri on loodud süsteemi administraatori poolt.
tüüp	nöör	Kui nimekiri on salvestatud ja kes seda säilitab. Väärtused on järgmised: kohalik, salvestatakse nimekiri süsteemi ja seda haldab süsteemiadministraator; või kauge, laaditakse loend kaugjuhtimispuldilt alla URL.
allikad	Objekt []	Allika kontrollige IP-sid. Kui nimekiri on tüüp kauge seejärel ei kuvata loendi sisu enne esimest allalaadimist.
uuenda staatust	nöör	Kohaliku süsteemi viimase eduka värskenduse loendi ja kuupäeva viimane allalaadimine.
URL	nöör	Kui kaugloend on alla laaditud. Kaugformaadiks peab olema ühe loend allikas võrgu / bitmaski või IP rea kohta.
sagedus	nöör	Kaugloendi uuendamise sagedus. Valikud on järgmised: iga päev, värskendage kõiki päevi üks kord või perioodiliselt frequency_type väli; iga nädal, uuendage kord nädalas; või igakuine, värskendage kord kuus.
frequency_type	nöör	See parameeter lõpetab sagedus iga päev, kui selle väärtus on iga päev. Võimalikud väärtused on: täpne. defineerige tund päevas; või periood, määrake päeva jooksul värskendamise aeg.
päev	String või number	See parameeter täiendab parameetrit sagedus millal frecuency väärtus ei iga nädal or igakuine. Kui frecuency is iga nädal see parameeter peab olema nädala kõrvalhommikul, teisipäev, kolmapäev, neljapäeval, reede, laupäev or pühapäev) kui sagedus väärtus ei igakuine siis peab see parameeter olema kuu päev (arv vahel 1 ja 31).
aeg	objekt	See on struktuur, mis sõltub väljadest sagedus.

Ajaobjekt päevase sageduse ja ajavahemiku sageduse jaoks

Väli	KASUTUSALA	Kirjeldus
periood	Number	Kui tihti nimekirja uuendatakse.
üksus	nöör	Perioodi üksus. Valikud on järgmised: protokoll, näidake, et loendit uuendatakse iga konfigureeritud minuti jooksul; või tundi, loendit uuendatakse iga konfigureeritud tunni jooksul.

Teiste sageduste ajaobjekt

Väli	KASUTUSALA	Kirjeldus
tund	Number	Tundi loendi uuendamiseks. Väärtus peab olema number 0 ja 23.
protokoll	Number	Nimekirja uuendamiseks minutid. Väärtus peab olema number 0 ja 59.

Allikate objekt

Väli	KASUTUSALA	Kirjeldus
id	Number	Allika unikaalne identifikaator loendis.
allikas	nöör	IP-aadressid või võrgusegmendid, mida loend kontrollib.

Looge musta nimekirja reegel

Loo uus must nimekiri

Kohaliku loendi näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"newListLoc", "type":"local", "policy":"allow"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists

Kaugloendi päringu näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"newListRem", "type":"remote", "url":"https://192.168.10.12/lists/test.txt"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists

POST /ipds/blacklists

Looge kasvandustes kasutatav must nimekiri. Mustad nimekirjad võivad olla kahte tüüpi:

1. Kohalik: allikaid lisab kasutaja. Nimekiri salvestatakse kohapeal.
2. Kaugjuhtimine: allikad saadakse kaugelt. Seda asukohta näitab URL. Toetatud kaugloendi formaat on üks Võrgu aadress / mask or IP rida rea ​​kohta.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.	tõsi
tüüp	nöör	Kui nimekiri on salvestatud ja kes seda hooldab. Väärtused on järgmised: kohalik, see salvestatakse haldussüsteemi süsteemi ja hooldusse; või kauge, loend on välja võetud teenusest a URL ja administraatori servcie hooldab loendit.	tõsi
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest. Vaikeväärtus on eitav.
URL	nöör	Kui kaugloend on alla laaditud. Kaugformaadiks peab olema ühe loend allikas vormingus rea kohta Võrgu aadress / mask or IP.	kehtib ka kaugloendi puhul

{
   "description" : "Post list list1",
   "params" : {
      "farms" : [],
      "name" : "newListLoc",
      "policy" : "deny",
      "preload" : "false",
      "type" : "local"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on mustade nimekirjade objektide massiiv, millest igaüks sisaldab järgmisi võtme atribuute.

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja.
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
eelkoormus	nöör	Võimalikud väärtused on: tõsi, must nimekiri on süsteemis eelsalvestatud; või vale, must nimekiri on loodud süsteemiadministraatorile.
tüüp	nöör	Kui nimekiri on salvestatud ja kes seda hooldab. Väärtused on järgmised: kohalik, see salvestatakse haldussüsteemi süsteemi ja hooldusse; või kauge, loend on välja võetud teenusest a URL ja administraatori servcie hooldab loendit.

Muuda musta nimekirja reeglit

Muuda musta nimekirja

Kohaliku loendi näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"policy":"allow","source":["78.12.0.4","68.100.15.5","65.12.12.95"]}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/whiteList

PUT /ipds/blacklists/<name>

Muuda musta nimekirja reegli konfiguratsiooni. nimi on mustade nimekirjade unikaalne identifikaator.

Kohaliku nimekirja parameetrite taotlemine:

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina. Ainult seda saab muuta nr eelkoormus nimekirju.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
allikas	String []	See on nimekiri IP-aadressidest või võrgusegmentidest, mida loend kontrollib. Muudatuste muutmiseks on vaja ainult allikat, vaadake dokumentatsiooni jaotist IPDS> mustad nimekirjad> musta nimekirja allika muutmine. Ainult allikaid on muudetud nr eelkoormus nimekirju.

Vastuse näide:

{
   "description" : "Modify list whiteList.",
   "params" : {
      "name" : "whiteList",
      "policy" : "allow",
      "preload" : "false",
      "type" : "local"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kaugloendi päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"name":"remoteList","url":"http://192.168.10.10/lists/test.txt","policy":"deny","frequency":"daily","frequency_type":"exact","time":{"hour":1,"minutes":0}}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem

Taotluse näidis nimekirja uuendamiseks iga 2 tundi:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"frequency":"daily","frequency_type":"period","time":{"period":2,"units":"hours"}}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem

Soovi näide nimekirja uuendamiseks kõikidel päevadel 2is: 00 AM:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"frequency":"daily","frequency_type":"exact","time":{"hour":2,"minutes":0}}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem

Taotluse näide kõigi esmaspäevade uuendamiseks aadressil 0: 00 AM:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"frequency":"weekly","day":"monday","time":{"hour":0,"minutes":0}}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem

Taotlusnäide kuu 1i värskendamiseks 12is: 00 PM:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"frequency":"monthly","day":"1","time":{"hour":12,"minutes":0}}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem

Küsi kaugloendi parameetreid

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja.
nimi	nöör	Mustade nimekirjade nimi. Seda kasutatakse unikaalse identifikaatorina.
poliitika	nöör	Allikale rakendatav tegevus. Valikud on järgmised: eitamablokeerige sisendliiklus nimekirja allikatest; või võimaldama aktsepteerima liikluse nimekirja allikatest.
URL	nöör	Kui kaugloend on alla laaditud.
sagedus	nöör	Kaugloendi uuendamise sagedus. Valikud on järgmised: iga päev, värskendage kõiki päevi, üks või mitu korda, see on näidatud frequency_type väli; iga nädal, uuendage kord nädalas; või igakuine, värskendage kord kuus.
frequency_type	nöör	See parameeter lõpetab sagedus iga päev, kui selle väärtus on iga päev. Võimalikud väärtused on: täpne. defineerige tund päevas; või periood, määrake päeva jooksul värskendamise aeg.
päev	String või number	See parameeter lõpetab sagedus kui selle väärtus on kord nädalas või kuus. Kui see on iganädalane, peab see parameeter olema nädalapäev (hommikul, teisipäev, kolmapäev, neljapäeval, reede, laupäev or pühapäev) muul juhul kui sagedus on igakuine, siis peab see parameeter olema kuupäev (number vahel 1 ja 31).
aeg	objekt	See on struktuur, mis sõltub väljadest sagedus.

Ajaperioodi objekt

Need on väljad, kui seadistatakse ajaperiood.

See on vajalik konfigureerimisel sagedus väärtusega iga päevja frequency_type väärtusega periood.

Väli	KASUTUSALA	Kirjeldus
periood	Number	Kui tihti nimekirja uuendatakse.
üksus	nöör	Perioodi üksus. Valikud on järgmised: protokoll or tundi, märkige loenduuenduste mõõtühik.

Täpne tundide objekt

Need on väljad, kus konfigureeritakse täpne tunniaeg.

Seda objekti kasutatakse koos järgmise konfiguratsiooniga:

sagedus väljal on väärtus iga päev ja frequency_type is täpne.

sagedus väljal on väärtus iga nädal ja päev on nädala päev, mil nimekirja uuendatakse.

sagedus väljal on väärtus igakuine ja päev on päevade arv, mil loend värskendatakse.

Väli	KASUTUSALA	Kirjeldus
tund	Number	Tundi loendi uuendamiseks. Väärtus peab olema number 0 ja 23.
protokoll	Number	Nimekirja uuendamiseks minutid. Väärtus peab olema number 0 ja 59.

Vastuse näide:

{
   "description" : "Modify list newListRem.",
   "params" : {
      "day": 1,
      "frequency" : "monthly",
      "name" : "newListRem",
      "policy" : "deny",
      "preload" : "false",
      "time" : {
         "hour" : 12,
         "minutes" : 0
      },
      "type" : "remote",
      "update_status" : "Sync fail. Last update: 2017-02-16 14:23:00",
      "url" : "https://192.168.10.12/lists/test.txt"
   }
}

Vastuse parameetrid

Vastuseks on kogu nimekirja konfiguratsioon. Lisateabe saamiseks vaadake vastuse näidet.

Värskenda musta nimekirja reeglit

Uuenda kaugem must nimekiri

Kaugloendi päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"update"}' 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/remoteList/actions

POST /ipds/blacklists/<name>/actions

Uuenda kaugloend, allalaadides allikad. nimi on mustade nimekirjade unikaalne identifikaator.

Küsi kaugloendi parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Loendisse saatmise toiming. See parameeter peab olema ajakohastama.	tõsi

Vastuse näide:

{
   "description" : "Update a remote list",
   "update" : "Sync OK. Last update: 2017-02-01 05:31:57"
}

Vastuse parameetrid

Vastus on allalaadimise olekuga json. Lisateabe saamiseks vaadake vastuse näidet.

Väli	KASUTUSALA	Kirjeldus	Nõutud
ajakohastama	nöör	Viimase loendi ja viimase eduka värskenduse kuupäeva viimane allalaadimine.

Kustuta mustade nimekirjade reegel

Kustuta mustade nimekirjade loend

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/remoteList

DELETE /ipds/blacklists/<name>

Kustutage antud must nimekiri. nimi on mustade nimekirjade unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete list 'remoteList'",
   "message" : "The list remoteList has been deleted successful.",
   "success" : "true"
}

Nimekirja allikas loetletakse allikas

Nimekirja allikas loetletakse allikas

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList

GET /ipds/blacklists/<name>/sources

Loetle musta nimekirja allikad. nimi on mustade nimekirjade unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Get localList sources",
   "params" : [
      {
         "id" : 0,
         "source" : "78.12.0.4"
      },
      {
         "id" : 1,
         "source" : "68.100.15.5"
      },
      {
         "id" : 2,
         "source" : "65.12.12.95"
      }
   ]
}

Vastuse parameetrid

Vastuseks on võtmega JSON parameetrid ja lähtefunktsiooni massiivi väärtuseks.

Allikasobjekt:

Väli	KASUTUSALA	Kirjeldus
id	Number	Allika unikaalne identifikaator loendis.
allikas	String []	IP-aadressid või võrgusegmendid, mida loend kontrollib.

Lisage mustale nimekirja allikas

Lisage mustale nimekirja allikas

Päringu näide:

curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"source":"192.168.3.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources

POST /ipds/blacklists/<name>/sources

Lükake must allikas uus allikas. Saadaval ainult kohalike nimekirjade ja eelsalvestamata nimekirjade puhul. nimi on mustade nimekirjade unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
allikas	nöör	IP-aadress või võrgusegment, mida loend kontrollib.	tõsi

Vastuse näide:

{
   "description" : "Post source to localList.",
   "message" : "Added 192.168.3.1 successful.",
   "params" : [
      {
         "id" : 0,
         "source" : "78.12.0.4"
      },
      {
         "id" : 1,
         "source" : "68.100.15.5"
      },
      {
         "id" : 2,
         "source" : "65.12.12.95"
      },
      {
         "id" : 3,
         "source" : "192.168.3.1"
      }
   ]
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda musta nimekirja allikat

Muuda musta nimekirja allikat

Päringu näide:

curl -k -X PUT -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"source":"192.168.3.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources/2

PUT /ipds/blacklists/<name>/sources/<id>

Muuda musta nimekirja allikat.

nimi on mustade nimekirjade unikaalne identifikaator. id on allika unikaalne identifikaator.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
allikas	nöör	IP-aadress või võrgusegment, mida loend kontrollib.	tõsi

Vastuse näide:

{
   "description" : "Put source into localList",
   "message" : "Source 2 has been modified successful.",
   "params" : {
         "id" : 2,
         "source" : "192.168.3.1"
    }
}

Vastuse parameetrid

Vastus on allikaga uuendatud. Lisateabe saamiseks vaadake vastuse näidet.

Kustuta musta nimekirja allikas

Kustuta musta nimekirja allikas

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources/2

DELETE /ipds/blacklists/<name>/sources/<id>

Eemaldage must nimekiri musta nimekirjast.

nimi on mustade nimekirjade unikaalne identifikaator. id on allika unikaalne identifikaator.

Vastuse näide:

{
   "description" : "Delete source from the list localList",
   "message" : "Source 2 has been deleted successful.",
   "success" : "true"
}

IPDS - DoS

DoS-i kaitsel on erinevad reeglid, mis sõltuvad kaitsereeglist, seda rakendatakse tasakaalustaja teisele osale. Nii on olemas süsteem reegleid, et ta kohaldab kõiki tasakaalustajaid. Ühendusele orienteeritud eeskirjad, mis on spetsiifilised talu TCP protokolliga töötamine. Enne reegli kohaldamist a talu, loo soovitud konfiguratsiooniga objekt. Seejärel rakendage seda kõikidele taludele, mida te seda vajate. The süsteem eeskirjadel on objekt juba loodud ja neil on ainult üks võimalik konfiguratsioon. Kui see on konfigureeritud, lubage see.

Farm DoS eeskirjad

Vajalik on luua objekt, enne kui talu reeglit rakendada.

limitec

Uue ühenduse piirväärtus sekundis ja allikas. Saadaval ainult taludes, kus töötab TCP protokoll.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.
piirama	Number	See on allikale uute ühenduste maksimaalne arv sekundis.
limit_burst	Number	See on lubatud uute ühenduste tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

limiidid

Piirake kokku vooluühendusi ühe allika kohta. Saadaval ainult taludes, kus töötab TCP protokoll.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.
limit_conns	Number	See on vooluühenduse maksimaalne arv allikast.

bogustcpflags

Kontrollige TCP protokolli. See reegel ei sisalda konfiguratsiooniparameetreid, et luua ainult objekt, mida saate kõigis taludes kasutada. Saadaval ainult taludes, kus töötab TCP protokoll.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.

limitrst

Piirata resetühenduse taotluse arvu sekundis. Saadaval ainult taludes, kus töötab TCP protokoll.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.
piirama	Number	See on lähtealuse taastamise taotluse maksimaalne arv sekundis.
limit_burst	Number	See on lähtestustaotluse lubatud tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

Süsteemi DoS reeglid

Süsteemi DoS reeglites pole objekti loodud.

sshbruteforce

Uue ssh-ühenduse piir.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus. Identifikaator on määratletud kui ssh_brute_force.
tabamust	Number	Varasemate allikate tabamuste arv kui ühendused on blokeeritud.
aeg	Number	Aeg sekundites, et nullida tabamust võidelda.
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

dropicmp

Süsteem kustutab icmpi taotluse.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus. Identifikaator on määratletud kui drop_icmp.
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

Loetlege kõik DoS-reeglite tüübid

Loetlege kõik DoS-reeglite tüübid

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/rules

GET /ipds/dos/rules

Näita DoS-reeglite loendit. Nad ei ole objektiks vaid selle määratlemiseks.

Igal reeglil on erinevad konfiguratsiooniparameetrid

Vastuse näide:

{
   "description" : "Get DoS settings.",
   "params" : {
      "farm" : [
         {
            "description" : "Connection limit per seconds.",
            "rule" : "limitsec"
         },
         {
            "description" : "Total connections limit per source IP.",
            "rule" : "limitconns"
         },
         {
            "description" : "Check bogus TCP flags.",
            "rule" : "bogustcpflags"
         },
         {
            "description" : "Limit RST request per second.",
            "rule" : "limitrst"
         }
      ],
      "system" : [
         {
            "description" : "SSH brute force.",
            "rule" : "sshbruteforce"
         },
         {
            "description" : "Drop icmp packets",
            "rule" : "dropicmp"
         }
      ]
   }
}

Vastuse parameetrid

JSON-vastusel on kaks massiivi talu ja süsteem. Iga massiiviüksus on süsteemi tüüp, mida kohaldatakse süsteemi talu suhtes.

Väli	KASUTUSALA	Kirjeldus
kirjeldus	nöör	Reegli lühikirjeldus.
välistada	nöör	tüüp reegli kordumatu tunnus.

Loetle kõik DoS-reeglid

Loetlege kõik DoS objektid

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos

GET /ipds/dos

Kuva kõigi olemasolevate DoS objektide konfiguratsioon.

Vastuse näide:

{
   "description" : "Get DoS settings.",
   "params" : [
      {
         "farms" : [],
         "limit_conns" : 10,
         "name" : "limitConnHttp",
         "rule" : "limitconns",
         "type" : "farm"
      },
      {
         "farms" : [],
         "limit" : 2,
         "limit_burst" : 2,
         "name" : "limitUsers",
         "rule" : "limitsec",
         "type" : "farm"
      },
      {
         "hits" : 5,
         "name" : "ssh_brute_force",
         "port" : 22,
         "rule" : "sshbruteforce",
         "status" : "down",
         "time" : 180,
         "type" : "system"
      },
      {
         "name" : "drop_icmp",
         "rule" : "dropicmp",
         "status" : "down",
         "type" : "system"
      },
      {
         "farms" : [],
         "name" : "tcpAuth",
         "rule" : "bogustcpflags",
         "type" : "farm"
      },
      {
         "farms" : [],
         "limit" : 2,
         "limit_burst" : 2,
         "name" : "dos4",
         "rule" : "limitrst",
         "type" : "farm"
      },
   ]
}

Vastuse parameetrid

Vastus on massiiv koos kõigi olemasolevate DoS objektidega.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.
välistada	nöör	See on tüübieeskirjade tunnus.
tüüp	nöör	Võimalikud väärtused on: talu, reegel kehtib põllumajandusettevõtete kohta; või süsteem, reegel kehtib süsteemi kohta.

Lisaks sõltub objekt reeglist, et objekt sisaldab järgmisi parameetreid

limitec

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
piirama	Number	See on allikale uute ühenduste maksimaalne arv sekundis.
limit_burst	Number	See on lubatud uute ühenduste tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

limiidid

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
limit_conns	Number	See on vooluühenduse maksimaalne arv allikast.

bogustcpflags

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.

limitrst

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
piirama	Number	See on lähtealuse taastamise taotluse maksimaalne arv sekundis.
limit_burst	Number	See on lähtestustaotluse lubatud tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

sshbruteforce

Väli	KASUTUSALA	Kirjeldus
tabamust	Number	Varasemate allikate tabamuste arv kui ühendused on blokeeritud.
aeg	Number	Aeg sekundites, et nullida tabamust võidelda.
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

dropicmp

Väli	KASUTUSALA	Kirjeldus
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

Too reegli DoS

Too reegli DoS

Põllumajandusettevõtte eeskirja taotlemise näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/limitConnHttp

Süsteemi reegli soovide näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/ssh_brute_force

GET /ipds/dos/<name>

Igal DoS-objektil võib olla erinev konfiguratsioon. nimi on DoS reegli kordumatu tunnus.

Põllumajandusettevõtte reegli vastuse näide:

{
   "description" : "Get DoS limitConnHttp settings",
   "params" : {
      "farms" : [],
      "limit_conns" : 10,
      "name" : "limitConnHttp",
      "rule" : "limitconns",
      "type" : "farm"
   }
}

Süsteemi reegli vastuse näide:

{
   "description" : "Get DoS ssh_brute_force settings",
   "params" : {
      "hits" : 5,
      "name" : "ssh_brute_force",
      "port" : 22,
      "rule" : "sshbruteforce",
      "status" : "down",
      "time" : 180,
      "type" : "system"
   }
}

Vastuse parameetrid

Vastus on massiiv koos kõigi olemasolevate DoS objektidega.

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on objekti reegli kordumatu tunnus.
välistada	nöör	See on tüübieeskirjade tunnus.
tüüp	nöör	Võimalikud väärtused on: talu, reegel kehtib põllumajandusettevõtete kohta; või süsteem, reegel kehtib süsteemi kohta.

Lisaks sõltub objekt reeglist, et objekt sisaldab järgmisi parameetreid

limitec

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
piirama	Number	See on allikale uute ühenduste maksimaalne arv sekundis.
limit_burst	Number	See on lubatud uute ühenduste tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

limiidid

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
limit_conns	Number	See on vooluühenduse maksimaalne arv allikast.

bogustcpflags

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.

limitrst

Väli	KASUTUSALA	Kirjeldus
talud	String []	Põllumajandusettevõtted, kus kohaldatakse reeglit.
piirama	Number	See on lähtealuse taastamise taotluse maksimaalne arv sekundis.
limit_burst	Number	See on lähtestustaotluse lubatud tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

sshbruteforce

Väli	KASUTUSALA	Kirjeldus
tabamust	Number	Varasemate allikate tabamuste arv kui ühendused on blokeeritud.
aeg	Number	Aeg sekundites, et nullida tabamust võidelda.
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

dropicmp

Väli	KASUTUSALA	Kirjeldus
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

Loo DoS reegel

Loo DoS reegel

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"name":"limitUsers", "rule":"limitsec"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos

POST /ipds/dos

Looge DoS-objekt, et seda kasutada taludes vastavalt vajadusele.

Igal DoS-objektil võib olla erinev konfiguratsioon.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
nimi	nöör	See on objekti reegli kordumatu tunnus.	tõsi
välistada	nöör	See on tüübieeskirjade tunnus. Valikud on järgmised: limiidid, limitec, limitrst or bogustcpflags.	tõsi

Vastuse näide:

{
   "description" : "Post a DoS rule",
   "params" : {
      "farms" : [],
      "limit" : 2,
      "limit_burst" : 2,
      "name" : "limitUsers",
      "rule" : "limitsec",
      "type" : "farm"
   }
}

Vastuse parameetrid

Vastus on loodud reegli vaikimisi konfigureeritud json. Lisateabe saamiseks vaadake vastuse näidet.

Muuda DoS reeglit

Muuda DoS reeglit

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"hits":"10","status":"up","time":"100"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/ssh_brute_force

PUT /ipds/dos/<name>

Muuda DoS reeglit. nimi on DoS reegli kordumatu tunnus.

Taotlege parameetreid

Iga reegli tüüp võib olla erinev parameeter. Muudetavad parameetrid on järgmised:

limitec

Väli	KASUTUSALA	Kirjeldus
piirama	Number	See on allikale uute ühenduste maksimaalne arv sekundis.
limit_burst	Number	See on lubatud uute ühenduste tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

limiidid

Väli	KASUTUSALA	Kirjeldus
limit_conns	Number	See on vooluühenduse maksimaalne arv allikast.

bogustcpflags

Ei ole parameetreid.

limitrst

Väli	KASUTUSALA	Kirjeldus
piirama	Number	See on lähtealuse taastamise taotluse maksimaalne arv sekundis.
limit_burst	Number	See on lähtestustaotluse lubatud tipp. Sarivõte taastub, kui mööduvad “piir” sekundid.

sshbruteforce

Väli	KASUTUSALA	Kirjeldus
tabamust	Number	Varasemate allikate tabamuste arv kui ühendused on blokeeritud.
aeg	Number	Aeg sekundites, et nullida tabamust võidelda.
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

dropicmp

Väli	KASUTUSALA	Kirjeldus
staatus	nöör	Näita reegli olekut, võimalikud väärtused on: up süsteem langeb icmpi taotlused; või alla süsteem lubab icmp taotlusi.

Vastuse näide:

{
   "description" : "Put DoS rule settings",
   "params" : {
      "hits" : 10,
      "name" : "ssh_brute_force",
      "port" : 22,
      "rule" : "sshbruteforce",
      "status" : "up",
      "time" : 100,
      "type" : "system"
   },
   "success" : "true"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kustutage DoS reegel

Kustutage DoS reegel

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/limitConnHttp

DELETE /ipds/dos/<name>

Süsteemi reegleid ei saa kustutada. Selle keelamiseks asetage olek alla. nimi on DoS reegli kordumatu tunnus.

Vastuse näide:

{
   "description" : "Delete DoS rule",
   "message" : "Deleted limitConnHttp successful.",
   "success" : "true"
}

süsteem

Süsteemi valikud pakuvad sulle võimalust kohandada tasakaalustaja ja globaalsete parameetrite teenuseid.

Näita versiooni

Näita versiooni

Päringu näide:

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

GET /system/version

Näita teavet toote versiooni kohta.

Vastuse näide:

{
   "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"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
device_version	nöör	Rakenduse versioon. Näita ka hüperviisi, kui see on virtuaalne masin.
hostname	nöör	Hosti nimi.
kernel_version	nöör	Linuxi tuuma versioon.
system_date	nöör	Süsteemi kuupäev.
zevenet_version	nöör	Zevenet versioon.

Kuva DNS

Kuva DNS

Päringu näide:

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

GET /system/dns

Näita DNS-teenuse konfiguratsiooni.

Vastuse näide:

{
   "description" : "Get dns",
   "params" : {
      "primary" : "8.8.8.8",
      "secondary" : null
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
esmane	nöör	Süsteemis konfigureeritud esmane DNS.
kesk-	nöör	Süsteemis konfigureeritud sekundaarne DNS.

Muuda DNS-i

Muuda DNS-i

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"primary":"8.8.4.4","secondary":"8.8.8.8"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/dns

POST /system/dns

Muuda DNS-teenuse konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
esmane	nöör	Süsteemis konfigureeritud esmane DNS.
kesk-	nöör	Süsteemis konfigureeritud sekundaarne DNS.

Vastuse näide:

{
   "description" : "Post dns",
   "params" : {
      "primary" : "8.8.4.4",
      "secondary" : "8.8.8.8"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Näita SSH

Näita SSH

Päringu näide:

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

GET /system/ssh

Näita SSH-teenuse konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
kuulama	nöör	IP-süsteem, kus SSH-teenus kuulab. The märk * kasutatakse kõigi konfigureeritud IP-de kuulamiseks.
port	nöör	SSH teenuse jaoks konfigureeritud port.

Vastuse näide:

{
   "description" : "Get ssh",
   "params" : {
      "listen" : "*",
      "port" : "22"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda SSH

Muuda SSH

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"listen":"192.168.100.241","port":"22"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ssh

POST /system/ssh

Muuda SSH-teenuse konfiguratsiooni.

Taotlege parameetreid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
kuulama	nöör	IP-süsteem, kus SSH-teenus kuulab. The märk * kasutatakse kõigi konfigureeritud IP-de kuulamiseks.
port	nöör	SSH teenuse jaoks konfigureeritud port.

Vastuse näide:

{
   "description" : "Post ssh",
   "params" : {
      "listen" : "192.168.100.241",
      "port" : "22"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Näita SNMP-d

Näita SNMP-d

Päringu näide:

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

GET /system/snmp

Näita SNMP teenuse konfiguratsiooni.

Vastuse näide:

{
   "description" : "Get snmp",
   "params" : {
      "community" : "public",
      "ip" : "*",
      "port" : "161",
      "scope" : "0.0.0.0/0",
      "status" : "false"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
kogukond	nöör	Kogukonna nimi. Kasutatakse ainult lugemisega ühendust.
ip	nöör	Liides IP, kus SNMP teenus töötab. Kõiki liideseid on võimalik turvaliselt kasutada märk *.
port	nöör	Port, kus SNMP teenus töötab.
ulatus	nöör	IP või alamvõrk, millel on juurdepääs (IP / bit). Lubatud kliendi IP-dele juurdepääs SNMPD-teenusele, kui soovite lubada juurdepääsu ainult ühele IP-le, kasutage bitti “/ 32”.
staatus	nöör	SNMP teenuse olek. Võimalikud väärtused on: tõsi, teenus töötab; või vale, teenus peatatakse.

Muuda SNMP-d

Muuda SNMP-d

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"ip":"192.168.100.241","port":"170","scope":"0.0.0.0/0","status":"true","community":"public"}'  
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/snmp

POST /system/snmp

Muuda SNMP teenuse konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
kogukond	nöör	Kogukonna nimi. Kasutatakse ainult lugemisega ühendust.
ip	nöör	Liides IP, kus SNMP teenus töötab. Kõiki liideseid on võimalik turvaliselt kasutada märk *.
port	nöör	Port, kus SNMP teenus töötab.
ulatus	nöör	IP või alamvõrk, millel on juurdepääs (IP / bit). Lubatud kliendi IP-dele juurdepääs SNMPD-teenusele, kui soovite lubada juurdepääsu ainult ühele IP-le, kasutage bitti “/ 32”.
staatus	nöör	SNMP teenuse olek. Võimalikud väärtused on: tõsi, teenus töötab; või vale, teenus peatatakse.

Vastuse näide:

{
   "description" : "Post snmp",
   "params" : {
      "community" : "public",
      "ip" : "192.168.100.241",
      "port" : "170",
      "scope" : "0.0.0.0/0",
      "status" : "true"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Loa litsents

Loa litsents

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/license/txt

GET /system/license/<format>

Näita Zevenet-litsentsi vormingus. Kättesaadav formaat väärtused html or txt.

Näita NTP-d

Näita NTP-d

Päringu näide:

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

GET /system/ntp

Näita NTP-teenuse konfiguratsiooni.

Vastuse näide:

{
   "description" : "Get ntp",
   "params" : {
      "server" : "pool.ntp.org"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
server	nöör	Server, kus NTP klient taotleb.

Muuda NTP-d

Muuda NTP-d

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"server":"pool.ntp.org"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ntp

POST /system/ntp

Muuda NTP-teenuse konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
server	nöör	Server, kus NTP klient taotleb.

Vastuse näide:

{
   "description" : "Post ntp",
   "params" : "pool.ntp.org"
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Kuva HTTP server

Kuva HTTP server

Päringu näide:

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

GET /system/http

Näita HTTP-teenuse konfiguratsiooni. See on koht, kus Zevenet API ja GUI töötavad.

Vastuse näide:

{
   "description" : "Get http",
   "params" : {
      "ip" : "*",
      "port" : "444"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on allpool toodud parameetrid.

Väli	KASUTUSALA	Kirjeldus
ip	nöör	IP, kus HTTP server kuulab. The märk * kasutatakse kõigi konfigureeritud IP-de kuulamiseks.
port	nöör	Port, kus HTTP teenus kuulab.

Muuda HTTP serverit

Muuda HTTP serverit

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"ip":"192.168.100.241","port":"80"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/http

POST /system/http

Muuda HTTP-teenuse konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
ip	nöör	IP, kus HTTP server kuulab. The märk * kasutatakse kõigi konfigureeritud IP-de kuulamiseks.
port	nöör	Port, kus HTTP teenus kuulab.

Vastuse näide:

{
   "description" : "Post http",
   "params" : {
      "ip" : "192.168.100.241",
      "port" : "80"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Loetle kõik kasutajad

Loetle kõik kasutajad

Päringu näide:

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

GET /system/users

Loetlege süsteemi kasutajad.

Vastuse näide:

{
   "description" : "Get users",
   "params" : [
      {
         "status" : "true",
         "user" : "root"
      },
      {
         "status" : "true",
         "user" : "zapi"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on järgmised parameetrid.

Väli	KASUTUSALA	Kirjeldus
staatus	nöör	Kasutaja olek. Võimalikud väärtused on: tõsi, kasutaja on aktiveeritud; või mitte vale, kasutaja on desaktiveeritud.
kasutaja	nöör	Kasutajanimi.

Zapi kasutaja allalaadimine

Zapi kasutaja allalaadimine

Päringu näide:

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

GET /system/users/zapi

Näita zapi kasutaja konfiguratsiooni. Need parameetrid on vajalikud Zevenet'i teenuste kasutamiseks zapi kaudu.

Vastuse näide:

{
   "description" : "Zapi user configuration.",
   "params" : {
      "key" : "root",
      "status" : "true"
   }
}

Vastuse parameetrid

Vastuseks on JSON-objekt, millel on järgmised parameetrid.

Väli	KASUTUSALA	Kirjeldus
võti	nöör	Zapi autentimise võti. See on parameeter ZAPI_KEY kasutatakse zapi kõnede puhul.
staatus	nöör	Zapi kasutaja staatus. Kui selle väärtus on tõsi, on võimalik kasutada zapi; või mitte vale, zapi on desaktiveeritud ja seda ei ole võimalik saata.

Muuda zapi kasutaja konfiguratsiooni

Muuda zapi kasutaja konfiguratsiooni

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
 -d '{"key":"newzapikey","status":"enable","newpassword":"password1234"}' 
 https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users/zapi

POST /system/users/zapi

Muuda zapi kasutaja konfiguratsiooni. Need parameetrid on vajalikud Zevenet'i teenuste kasutamiseks zapi kaudu.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
võti	nöör	Zapi autentimise võti. See on parameeter ZAPI_KEY kasutatakse zapi kõnede puhul.
uus salasõna	nöör	Zapi kasutaja uus parool.
staatus	nöör	Zapi kasutaja staatus. Kui selle väärtus on tõsi, on võimalik kasutada zapi; või mitte vale, zapi on desaktiveeritud ja seda ei ole võimalik saata.

Vastuse näide:

{
   "description" : "Zapi user settings.",
   "message" : "Settings was changed successful.",
   "params" : {
      "key" : "newzapikey",
      "newpassword" : "password1234",
      "status" : "enable"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Muuda root parooli

Muuda root parooli

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
{"password":"admin","newpassword":"alwaysisbetterastrongpass"} 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users/root

POST /system/users/root

Muuda root parooli. Seda kasutajat kasutatakse juurdepääsuks zevenet-teenustele GUI kaudu

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
parool	nöör	Praegune juurkasutaja parool.	tõsi
uus salasõna	nöör	Juurkasutaja uus parool.	tõsi

Vastuse näide:

{
   "description" : "User settings.",
   "message" : "Settings was changed succesful.",
   "params" : {
      "newpassword" : "alwaysisbetterastrongpass",
      "password" : "admin"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Loendige logifailid

Loendige logifailid

Päringu näide:

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

GET /system/logs

Loetlege olemasolevad logifailid.

Vastuse näide:

{
   "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"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON koos logifaili hulgaga. Iga objekti parameetrid on:

Väli	KASUTUSALA	Kirjeldus
andmed	nöör	Viimase faili muutmise kuupäev.
fail	nöör	Logifailide nimi. Seda kasutatakse logi kordumatu identifikaatorina.

Laadige alla logifail

Laadige alla logifailid

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/logs/syslog.2.gz > log.gz

GET /system/logs/<file>

Laadige alla logifail, mis sisaldab GET-i taotluse ajal loetletud logifaile.

fail on logifaili unikaalne identifikaator.

Süsteem - varukoopiad

Varundamise suvandi abil saate salvestada praeguse süsteemi konfiguratsiooni ja selle alla laadida.

Selles jaotises saate luua, taastada, üles laadida ja alla laadida varukoopiaid.

Loendage varukoopiad

Loendage varukoopiad

Päringu näide:

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

GET /system/backup

Vastuse näide:

{
   "description" : "Get backups",
   "params" : [
      {
         "date" : "Fri Feb  3 06:01:04 2017",
         "name" : "newbackup"
      },
      {
         "date" : "Fri Feb  3 05:50:48 2017",
         "name" : "firstConf"
      }
   ]
}

Vastuse parameetrid

Vastuseks on JSON koos hulga varukoopiatega. Iga massiivi elemendi parameetrid on:

Väli	KASUTUSALA	Kirjeldus
andmed	nöör	Viimase muudatuse kuupäev.
nimi	nöör	See on unikaalse identifikaatorina kasutatav failinimi. Faili laiend on .tar.gz.

Loo varukoopia

Loo varukoopia

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
 -d '{"name":"firstConf"}' 
 https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup

POST /system/backup

Looge praeguse konfiguratsiooni süsteemi konfiguratsiooni varukoopia.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
nimi	nöör	See on unikaalse identifikaatorina kasutatav failinimi. Faili laiend on .tar.gz.

Vastuse näide:

{
   "description" : "Create a backups",
   "message" : "Backup firstConf was created successful.",
   "params" : "firstConf"
}

Laadige alla varukoopia

Laadige alla varukoopia

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
 https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf > ~/zevenetConf.tar.gz

Varufail on TAR GZ formaadis.

GET /system/backup/<name>

Laadige alla süsteemi konfiguratsiooni varukoopia. nimi on varukoopia kordumatu tunnus.

Laadige varukoopia üles

Laadige varukoopia üles

Päringu näide:

curl -k -X PUT -H 'Content-Type: text/plain' 
--data-binary @/opt/1mar.tar.gz -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/newbackup

PUT /system/backup/<name>

Laadige kohalikule salvestatud varukoopia Zevenetile. nimi on varukoopia kordumatu tunnus, mis salvestatakse Zevenetisse.

Taotlege parameetreid

Varukoopia üleslaadimiseks on vaja kasutada –data-binary.

Vastuse näide:

{
   "description" : "Upload a backup",
   "message" : "Backup newbackup was created successful.",
   "params" : "newbackup"
}

Kustuta varukoopia

Kustuta varukoopia

Päringu näide:

curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf

DELETE /system/backup/<name>

Kustutage varundifail Zevenetist. nimi on varukoopia kordumatu tunnus.

Vastuse näide:

{
   "description" : "Delete backup firstConf'",
   "message" : "The list firstConf has been deleted successful.",
   "success" : "true"
}

Rakenda varukoopia

Rakenda varukoopia

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"apply"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf/actions

POST /system/backup/<name>/actions

Taastage konfigureerimine varukoopiafailist. nimi on varukoopia kordumatu tunnus.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Varukonfiguratsiooni taastamiseks peab väärtus olema kohaldada.

Vastuse näide:

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

Süsteem - teated

Teated moodustavad kaks elementi: Saatja meetod ja tüüp. \ t hoiatada.

Hoiatusosas saate valida, millist tüüpi teate soovite. Tegelikult keskenduvad hoiatused taust- või klastri staatusele, nii et tasakaalustaja saadab teate, kui mõned lülitid.

Meetodi osas saate valida, millist saatjat kasutatakse, kui Zevenet peab teate saatma.

Kuva hoiatuse olek

Kuva hoiatuse olek

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts

GET /system/notifications/alerts

Loetlege kõik olekutüübid.

Vastuse näide:

{
   "description" : "Get notifications alert status",
   "params" : [
      {
         "alert" : "backends",
         "status" : "disabled"
      },
      {
         "alert" : "cluster",
         "status" : "disabled"
      }
   ]
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
hoiatada	nöör	Hoiatuse tüüp, seda kasutatakse hoiatuse kordumatu identifikaatorina. Saadaolevad märguanded on järgmised: backendteatage, millal staatuse taustaprogramm muutub; või klastrisaatke teade, kui klastri põhisõlm lülitub teise sõlme.
staatus	nöör	Näita, kas hoiatus on blokeeritud, süsteem sündmuse toimumise ajal teadet ei saada; või lubatud, saadab süsteem hoiatuse, kui tuvastatakse oleku muutus.

Hankige teavitushäired

Hankige teavitushäired

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends

GET /system/notifications/alerts/<alert>

Näita teatise tüübi konfiguratsiooni.

hoiatada on hoiatuse kordumatu tunnus.

Vastuse näide:

{
   "description" : "Get notifications alert backends settings",
   "params" : {
      "avoidflappingtime" : 5,
      "prefix" : "",
      "status" : "disabled"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
vältimine	Number	Mõnikord on taustaprogrammid saadaval või mitte lühikese aja jooksul, see väli võimaldab konfigureerida teatamiste vältimiseks aega, kui taustaprogramm muutub, kui see ajaperiood lõpeb, kui taustaprogramm seda alustab, kui see algab, siis teade saadetakse.
eesliide	nöör	See on e-kirja teema eesliide, mille süsteem saadab sellist tüüpi hoiatusteate jaoks.
staatus	nöör	Näita, kas hoiatus on blokeeritud, süsteem sündmuse toimumise ajal teadet ei saada; või lubatud, saadab süsteem hoiatuse, kui tuvastatakse oleku muutus.

Muuda teate hoiatust

Muuda teate hoiatusi

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
{"avoidflappingtime":10,"prefix":"[backend alert]"} 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends

POST /system/notifications/alerts/<alert>

hoiatada on hoiatuse kordumatu tunnus.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
vältimine	Number	Mõnikord on taustaprogrammid saadaval või mitte lühikese aja jooksul, see väli võimaldab konfigureerida teatamiste vältimiseks aega, kui taustaprogramm muutub, kui see ajaperiood lõpeb, kui taustaprogramm seda alustab, kui see algab, siis teade saadetakse. See parameeter ei ole klastrite hoiatustes, klastril on oma aeg.
eesliide	nöör	See on e-kirja teema eesliide, mille süsteem saadab sellist tüüpi hoiatusteate jaoks.

Vastuse näide:

{
   "description" : "Set notifications alert backends",
   "params" : {
      "avoidflappingtime" : 10,
      "prefix" : "[backend alert]"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Luba hoiatused

Luba hoiatused

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
{"action":"enable"} 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends/actions

POST /system/notifications/alerts/<alert>/actions

Teatise tüübi teatiste lubamine või keelamine.

hoiatada on hoiatuse kordumatu tunnus.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Hoiatuste jaoks rakendatavad toimingud on järgmised blokeeritud, süsteem sündmuse toimumise ajal teadet ei saada; või lubatud, saadab süsteem hoiatuse, kui tuvastatakse oleku muutus.

Vastuse näide:

{
   "description" : "Set notifications alert backends actions",
   "params" : {
      "action" : "enable"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Too e-posti konfiguratsioon

Too e-posti konfiguratsioon

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email

GET /system/notifications/methods/email

Kuva kõik e-posti saatja konfiguratsioonid.

Märkus: e-kirjade saatmiseks kasutatav SMTP port on TCP 25 isegi siis, kui TLS on lubatud.

Vastuse näide:

{
   "description" : "Get notifications email methods",
   "params" : {
      "from" : "user@zevenet.com",
      "method" : "email",
      "password" : "******",
      "server" : "smtp.gmail.com",
      "tls" : "true",
      "to" : "adminuser@zevenet.net",
      "user" : "user@zevenet.com"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
Alates	nöör	E-posti konto, mis saadab e-posti, kuvatakse see konto SMTP päises Alates: ja seda kasutatakse, kui vastuvõtja vastab e-kirjale.
meetod	nöör	See on meetodi kordumatu tunnus. Tegelikult on saadaval meetod e-mail.
parool	nöör	Parool on kasutaja SMTP-konto on vajalik, kui server vajab SMTP autentimist.
server	nöör	E-posti kaudu saadetakse SMTP-server.
tls	nöör	Luba TLS-i valideerimine e-posti saatmiseks, see omadus kasutab STARTTLS-i ja seda funktsiooni tuleb SMTP-serveris toetada. Mõned SMTP-serverid nõuavad selle lubamist. Võimalikud väärtused on: tõsiTLS valideerimine on lubatud e-posti saatmiseks; või vale, e-posti saatmine ei kasuta TLS-i valideerimist.
et	nöör	E-posti konto, mis võtab vastu meili, kuvatakse see konto SMTP päises To.
kasutaja	nöör	E-posti konto, millel on lubatud e-kirju saata, on see konto vajalik, kui server vajab SMTP autentimist.

Muuda e-posti konfiguratsiooni

Muuda e-posti konfiguratsiooni

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json'  -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"from":"user@zevenet.com","password":"verystrongpass","server":"smtp.gmail.com","to":"adminuser@zevenet.net","tls":"true","user":"user@zevenet.com"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email

POST /system/notifications/methods/email

Muuda e-posti saatja meetodi konfiguratsiooni.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
Alates	nöör	E-posti konto, mis saadab e-posti, kuvatakse see konto SMTP päises Alates: ja seda kasutatakse, kui vastuvõtja vastab e-kirjale.
parool	nöör	Parool on kasutaja SMTP-konto on vajalik, kui server vajab SMTP autentimist.
server	nöör	E-posti kaudu saadetakse SMTP-server.
tls	nöör	Luba TLS-i valideerimine e-posti saatmiseks, see omadus kasutab STARTTLS-i ja seda funktsiooni tuleb SMTP-serveris toetada. Mõned SMTP-serverid nõuavad selle lubamist. Võimalikud väärtused on: tõsiTLS valideerimine on lubatud e-posti saatmiseks; või vale, e-posti saatmine ei kasuta TLS-i valideerimist.
et	nöör	E-posti konto, mis võtab vastu meili, kuvatakse see konto SMTP päises To.
kasutaja	nöör	E-posti konto, millel on lubatud e-kirju saata, on see konto vajalik, kui server vajab SMTP autentimist.

Vastuse näide:

{
   "description" : "Get notifications email methods",
   "params" : {
      "from" : "user@zevenet.com",
      "method" : "email",
      "password" : "verystrongpass",
      "server" : "smtp.gmail.com",
      "tls" : "true",
      "to" : "adminuser@zevenet.net",
      "user" : "user@zevenet.com"
   }
}

Vastuse parameetrid

Vastuseks on kõigi taotletud väärtuste värskendaja. Lisateabe saamiseks vaadake vastuse näidet.

Saada testpost

Saada testpost

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json'  -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"test"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email/actions

POST /system/notifications/methods/email/actions

Saada testimiseks e-posti konfiguratsiooniga testpost.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
tegevus	nöör	Test-posti saatmise väärtus on test.

Vastuse näide:

{
   "description" : "Send test mail",
   "message" : "Test mail sent successful.",
   "success" : "true"
}

Laadige tugi alla

Laadige tugi alla

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/supportsave > supportsave.tar.gz

GET /system/supportsave

Hankige süsteemi oleku kujutis koos kogu süsteemi konfiguratsiooniga ja protsessiga. See toetab seda, et on vaja leida probleeme või toetada abi.

Süsteem - klaster

Klastriks on põhisõlme tehtud element, et see haldab ühendusi, mis on pööratud tagurpidi, ja varusõlm, mis kontrollib kaptenit, on valmis vahetama sõlme, kui see läheb alla.

Oleku vahetamisel taastab varusõlm kogu ühenduse oleku ise. Niisiis, klient ei tuvastanud teenuse katkestust.

See laseb koormuse tasakaalustaja kõrgel kättesaadavusel. Nii et kui Zevenetis on mõni probleem, jätkab teenus üleslaaditud konfiguratsiooniga tööd.

Näita klastri konfiguratsiooni

Näita klastri konfiguratsiooni

Päringu näide:

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

GET /system/cluster

Kuva kogu klastri konfiguratsioon.

Vastus BODY:

{
   "description" : "Show the cluster configuration",
   "params" : {
      "check_interval" : 5,
      "failback" : "disabled",
      "interface" : "eth0",
      "nodes" : [
         {
            "ip" : "192.168.100.241",
            "name" : "canoDEV4100",
            "node" : "local"
         },
         {
            "ip" : "192.168.100.240",
            "name" : "maqvir",
            "node" : "remote"
         }
      ]
   }
}

Vastuse parameetrid

Vastus on JSON-objekt, millel on klastri konfiguratsioon, ja massiiv koos selle sõlmedega.

Klastriobjekt:

Väli	KASUTUSALA	Kirjeldus
check_interval	Number	See on ooteaeg kahe sõlme oleku kontrollimise vahel.
tagasisidet	nöör	Millisel sõlmes on meister. Väärtused võivad olla a nimi sõlm, et eelistada sõlme; või blokeeritud, kui ükskõik milline sõlm võib olla kapten ja ükski neist ei ole prioriteet.
liides	nöör	Liides, kus sõlme IP on konfigureeritud.
sõlmed	Objekt []	Klastri sõlmed.

Sõlme objekt:

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Sõlmes on IP seadistatud sõlme oleku kontrollimiseks ja teabe replikatsiooni teostamiseks.
nimi	nöör	See on sõlme hostinimi ja seda kasutatakse sõlme unikaalse identifikaatorina.
sõlme	nöör	Võimalikud väärtused on: kohalik, kui sõlm on zapi päring; või kauge, Kui teine ​​sõlme on konfigureeritud.

Klastri lubamine

Klastri lubamine

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"local_ip":"192.168.100.241","remote_ip":"192.168.100.240","remote_password":"admin"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

POST /system/cluster

Kas klastril on kaks tasakaalustajat.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
remote_ip	nöör	Klastri juurde kuuluv kaugserveri IP.	tõsi
local_ip	nöör	Klastri juurde kuuluv kohaliku peremehe IP.	tõsi
remote_password	nöör	Kaasakasutaja parool serveri tasakaalustamiseks.	tõsi

Vastus BODY:

{
   "description" : "Enabling cluster",
   "message" : "Cluster enabled successfully",
   "success" : "true"
}

Klastri konfiguratsiooni muutmine

Klastri konfiguratsiooni muutmine

Päringu näide:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"check_interval":4,"failback":"disabled"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

PUT /system/cluster

Seadistage klastri töörežiimi parameetrid.

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus
check_interval	Number	See on ooteaeg kahe sõlme oleku kontrollimise vahel.
tagasisidet	nöör	Millisel sõlmes on meister. Väärtused võivad olla a nimi sõlm, et eelistada sõlme; või blokeeritud, kui ükskõik milline sõlm võib olla kapten ja ükski neist ei ole prioriteet.

Vastus BODY:

{
   "description" : "Modifying the cluster configuration",
   "params" : {
      "check_interval" : "4",
      "failback" : "disabled"
   }
}

Keela klaster

Keela klaster

Päringu näide:

curl -k -X DELETE -H 'Content-Type: application/json' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

DELETE /system/cluster

Eemaldage klaster.

Vastus BODY:

{
   "description" : "Disabling cluster",
   "message" : "Cluster disabled successfully",
   "success" : "true"
}

Hooldusrežiim

Hooldusrežiim

Päringu näide:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"maintenance","status":"enable"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/actions

POST /system/cluster/actions

Muutke kohaliku klastri sõlme hooldusrežiimiks.

Vastus BODY:

{
   "description" : "Setting maintenance mode",
   "message" : "Local cluster node changed to maintenance mode successfully",
   "success" : "true"
}

Taotlege parameetreid

Väli	KASUTUSALA	Kirjeldus	Nõutud
tegevus	nöör	Klastri suhtes rakendatav tegevus. Olemasolev tegevus on hooldus.	tõsi
staatus	nöör	Olek sõlmimiseks, võimalikud väärtused võimaldama, pange see hooldusrežiimi; või keelatapange sõlme kättesaadavaks.	tõsi

Näita sõlmede olekut

Näita sõlmede olekut

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/nodes

GET /system/cluster/nodes

Näita kõigi sõlmede olekut.

Vastus BODY:

{
   "description" : "Cluster nodes status",
   "params" : [
      {
         "ip" : "192.168.100.241",
         "message" : "Node online and active",
         "name" : "canoDEV4100",
         "node" : "local",
         "role" : "master",
         "status" : "ok"
      },
      {
         "ip" : "192.168.100.240",
         "message" : "Node online and passive",
         "name" : "maqvir",
         "node" : "remote",
         "role" : "backup",
         "status" : "ok"
      }
   ]
}

Vastuse parameetrid

Vastuseks on võtmega JSON param ja hinnatakse sõlme olekobjekti massiivi.

Sõlme olekobjekt

Väli	KASUTUSALA	Kirjeldus
ip	nöör	Sõlmes on IP seadistatud sõlme oleku kontrollimiseks ja teabe replikatsiooni teostamiseks.
nimi	nöör	See on sõlme hostinimi ja seda kasutatakse sõlme unikaalse identifikaatorina.
sõlme	nöör	Võimalikud väärtused on: kohalik, kui sõlm on zapi päring; või kauge, Kui teine ​​sõlme on konfigureeritud.
sõnum	nöör	Kirjeldav sõnum, mis näitab sõlme olekut ja töörežiimi.
roll	nöör	Selle sõlme tegelik töörežiim. Võimalikud väärtused on: meisterSee haldab sidemeid taustaprogrammide ja klientide vahel; või backup, see sõlmes on vastanud põhiolekuühendustele ja põhikonfiguratsioonile ning see kontrollib, et põhiteenindused toimiksid.
staatus	nöör	Märkige, kas mõni klastri protsess ei toimi.

Näita kohaliku klastri staatust

Näita kohaliku klastri staatust

Päringu näide:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/nodes/localhost

GET /system/cluster/nodes/localhost

Näita kohaliku sõlme olekut.

Vastus BODY:

{
   "description" : "Cluster status for localhost",
   "params" : {
      "message" : "Node online and active",
      "name" : "canoDEV4100",
      "role" : "master",
      "status" : "ok"
   }
}

Vastuse parameetrid

Väli	KASUTUSALA	Kirjeldus
sõnum	nöör	Kirjeldav sõnum, mis näitab sõlme olekut ja töörežiimi.
nimi	nöör	See on sõlme hostinimi ja seda kasutatakse sõlme unikaalse identifikaatorina.
roll	nöör	Selle sõlme tegelik töörežiim. Võimalikud väärtused on: meisterSee haldab sidemeid taustaprogrammide ja klientide vahel; või backup, see sõlmes on vastanud põhiolekuühendustele ja põhikonfiguratsioonile ning see kontrollib, et põhiteenindused toimiksid.
staatus	nöör	Märkige, kas mõni klastri protsess ei toimi.