Zevenet API v3.1 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.1 / zapi.cgi / (URI_path), kus zevenet_server on IP, kus HTTP teenus kuulab.
URI_path
määratleb toimingu või toimingu. Tema käitumine ja tema 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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/zapi.cgi/certificates/example.pem
POST /certificates/<file>
Laadige üles HTMPS-kuulajaga HTTP-põllumajandusettevõtete PEM-sertifikaat.
Nõuab parameetrit --tcp-nodelay
ja --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.1/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"
}
Nimekiri Ciphers
Nimekiri Ciphers
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/ciphers
GET /ciphers
Loetlege HTTPSi talu poolt kasutatavad šifrid.
. SSL-i mahalaadimine chiper on saadaval ainult siis, kui protsessor seda toetab.
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" : "Get the ciphers available",
"params" : [
{
"ciphers" : "all",
"description" : "All"
},
{
"ciphers" : "highsecurity",
"description" : "High security"
},
{
"ciphers" : "customsecurity",
"description" : "Custom security"
},
{
"ciphers" : "ssloffloading",
"description" : "SSL offloading"
}
]
}
Vastuse parameetrid
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
parameetrid | Objekt [] | Sertifikaadi objektide loend. |
Sertifikaadi objekt
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
salakirjad | nöör | Seda kasutatakse unikaalse identifikaatorina. |
kirjeldus | nöör | Sõbralik nimi. |
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.1/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 staatus. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on üles ja kõik taustaprogrammid on kättesaamatud või hooldus; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; hooldus, talu on üles ja seal on tagapõhi, kuid peaaegu tagaplaan on hooldusrežiimis; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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.1/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.1/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.1/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" : [],
"rbl" : [
"protection_ssh"
]
},
"params" : {
"certlist" : [
{
"file" : "zencert.pem",
"id" : 1
}
],
"cipherc" : "ALL",
"ciphers" : "all",
"contimeout" : 20,
"disable_sslv2" : "true",
"disable_sslv3" : "false",
"disable_tlsv1" : "false",
"disable_tlsv1_1" : "true",
"disable_tlsv1_2" : "false",
"error414" : "Request URI is too long.",
"error500" : "An internal server error occurred. Please try again later.",
"error501" : "This method may not be used.",
"error503" : "The service is not available. Please try again later.",
"httpverb" : "MSRPCext",
"ignore_100_continue" : "true",
"listener" : "https",
"reqtimeout" : 30,
"restimeout" : 45,
"resurrectime" : 10,
"rewritelocation" : "enabled",
"status" : "up",
"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. |
rbl | String [] | Põllumajandusettevõtte suhtes kohaldatakse RBL-eeskirju. |
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 šifrid aktsepteeritakse; kõrge turvalisusaktsepteeritakse ainult kõrge turvalisusega šifreid; tollikindlust, laaditakse ainult šifrid cipherc valdkonnas aktsepteeritakse; või ssloffloadingSee annab krüpteerimistöö protsessile, see kood sõltub protsessorist. |
contimeout | Number | Kui kaua talu ootab TCP ühendus backendiga sekundites. |
disable_sslv2 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad SSL-i turvaprotokolli versiooni 2, ei ole lubatud; või vale kui protokoll SSLv2 on lubatud. |
disable_sslv3 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad SSL-i turvaprotokolli versiooni 3, ei ole lubatud; või vale kui protokoll SSLv3 on lubatud. |
disable_tlsv1 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1, ei ole lubatud; või vale kui protokoll TLSv1 on lubatud. |
disable_tlsv1_1 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1.1, ei ole lubatud; või vale kui protokoll TLSv1.1 on lubatud. |
disable_tlsv1_2 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1.2, ei ole lubatud; või vale kui protokoll TLSv1.2 on lubatud. |
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: standardHTTPaktsepteeritud 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. |
ignore_100_continue | nöör | Kui sellel väljal on väärtus tõsi the,en 100 jätkub HTTP peatükki ignoreeritakse; kui väärtus on vale, 100 jätkub päis on protsess. |
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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on üles ja kõik taustaprogrammid on kättesaamatud või hooldus; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; hooldus, talu on üles ja seal on tagapõhi, kuid peaaegu tagaplaan on hooldusrežiimis; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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õimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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,"ignore_100_continue":"true",
"restimeout":47,"resurrectime":12,"reqtimeout":32,"rewritelocation":"enabled","httpverb":"standardHTTP",
"error414":"Message error 414","error500":"Message error 500","error501":"Message error 501",
"error503":"Message error 503","listener":"https","ciphers":"customsecurity","disable_sslv2":"true",
"disable_sslv3":"false","disable_tlsv1":"false","disable_tlsv1_1":"true","disable_tlsv1_2":"false",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP
PUT /farms/<farmname>
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. |
disable_sslv2 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad SSL-i turvaprotokolli versiooni 2, ei ole lubatud; või vale kui protokoll SSLv2 on lubatud. |
disable_sslv3 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad SSL-i turvaprotokolli versiooni 3, ei ole lubatud; või vale kui protokoll SSLv3 on lubatud. |
disable_tlsv1 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1, ei ole lubatud; või vale kui protokoll TLSv1 on lubatud. |
disable_tlsv1_1 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1.1, ei ole lubatud; või vale kui protokoll TLSv1.1 on lubatud. |
disable_tlsv1_2 | nöör | Ainult https kuulaja. Kui sellel väljal on väärtus tõsi ühendused, mis kasutavad TLS-i turvaprotokolli versiooni 1.2, ei ole lubatud; või vale kui |
ü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: standardHTTPaktsepteeritud 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. |
ignore_100_continue | nöör | Kui sellel väljal on väärtus tõsi the,en 100 jätkub HTTP peatükki ignoreeritakse; kui väärtus on vale, 100 jätkub päis on protsess. |
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-väärtusega kuulaja. Kasutatakse SSL-ühenduste poolt aktsepteeritud šifrite loendi koostamiseks, et SSL-ühendust tugevdada. Valikud on järgmised: kõik, kõik šifrid aktsepteeritakse; kõrge turvalisusaktsepteeritakse ainult kõrge turvalisusega šifreid; tollikindlust, laaditakse ainult šifrid cipherc valdkonnas aktsepteeritakse; või ssloffloadingSee annab krüpteerimistöö protsessile, see kood sõltub protsessorist. |
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,
"disable_sslv2" : "true",
"disable_sslv3" : "false",
"disable_tlsv1" : "false",
"disable_tlsv1_1" : "true",
"disable_tlsv1_2" : "false",
"error414" : "Message error 414",
"error500" : "Message error 500",
"error501" : "Message error 501",
"error503" : "Message error 503",
"httpverb" : "standardHTTP",
"ignore_100_continue" : "true",
"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.1/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.1/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.1/zapi.cgi/farms/httpFarm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists|rbl>
Rakenda põllumajandusettevõttele must nimekiri, DoS või RBL reegel.
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.1/zapi.cgi/farms/httpFarm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists|rbl>/<name>
Eemaldage mustal nimekirjal, DoS-il või RBL-reeglil antud talust, kasutades oma idenfikaatorit 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.
Too teenus ID-ga
Too teenus ID-ga
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/farms/cookiefarm/services/serv
GET /farms/<farmname>/services/<id>
Näita kõiki antud teenuse konfiguratsioone.
Vastuse näide:
{
"description" : "Get services of a farm",
"services" : {
"backends" : [
{
"id" : 0,
"ip" : "192.168.100.254",
"port" : 80,
"status" : "up",
"timeout" : 20,
"weight" : null
},
{
"id" : 0,
"ip" : "192.168.100.254",
"port" : 80,
"status" : "up",
"timeout" : null,
"weight" : null
}
],
"cookiedomain" : "zevenet.cpm",
"cookieinsert" : "true",
"cookiename" : "peasocookie",
"cookiepath" : "/patfh",
"cookiettl" : 20,
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "check_tcp -H HOST -p PORT",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "serv",
"leastresp" : "false",
"persistence" : "COOKIE",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "JSESSIONID",
"ttl" : 18,
"urlp" : "(?i)^/music$",
"vhost" : ""
}
}
Vastuse parameetrid
Vastus on JSON-objekt, mille formaat on allpool.
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õimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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. |
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.1/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.1/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.1/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.1/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.1/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.1/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õimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/zapi.cgi/farms/FarmHTTP/service/service1/backends/1
PUT /farms/<farmname>/services/<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","mode":"cut"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/httpfarm/services/newsrv/backends/0/maintenance
PUT /farms/<farmname>/services/<id>/backends/<id>/maintenance
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 | Nõutud |
---|---|---|---|
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. | |
režiimis | nöör | Valige hooldusrežiim. Saadaval olevad valikud on järgmised: äravool, taustaprogramm ei aktsepteeri uusi ühendusi, kuid jätkab praeguste ühenduste haldamist; või lõigatud, suletakse praegused ühendused. | Kui seda välja ei ole määratud, on vaikerežiim äravool. |
Vastuse näide:
{
"description" : "Set service backend status",
"params" : {
"action" : "maintenance",
"mode" : "cut"
}
}
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.1/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õiksid L4xNAT-farmid siduda terve rea porde, mitte ainult ühte virtuaalset porti, nagu seda kasutatakse teiste 7. kihi profiilidega. Selleks, et saaksite L4xNAT-i farmides valida virtuaalse pordi vahemiku või konkreetse virtuaalse pordi, on kohustuslik valida protokolli tüüp. Muul juhul kuulab farm kõiki virtuaalse IP-i sadamaid (tähistatud tähega *). Kui TCP- või UDP-protokoll on valitud, saab määrata pordi, mitu pordi ',' vahel asuvat pordi vahemikku ':' või kõik pordid, millel on '*'. Kehtiv on ka nende kõigi kombinatsioon.
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.1/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" : "undefined",
"weight" : 1
},
{
"id" : 1,
"ip" : "192.168.55.41",
"port" : "88",
"priority" : 3,
"status" : "undefined",
"weight" : 2
}
],
"description" : "List farm l4farm",
"ipds" : {
"blacklists" : [],
"dos" : [],
"rbl" : [
"protection_ssh"
]
},
"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. |
rbl | String [] | Põllumajandusettevõtte suhtes kohaldatakse RBL-eeskirju. |
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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on üles ja kõik taustaprogrammid on kättesaamatud või hooldus; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; hooldus, talu on üles ja seal on tagapõhi, kuid peaaegu tagaplaan on hooldusrežiimis; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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õimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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.1/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.1/zapi.cgi/farms/l4Farm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists|rbl>
Rakenda kasvandustele musti nimekirju, DoS või RBL reegleid.
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.1/zapi.cgi/farms/l4Farm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists|rbl>/<name>
Eemaldage IPDS-mooduli must nimekiri, DoS-i või RBL-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.1/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õimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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","mode":"cut"}'
https://<zenlb_server>:444/zapi/v3.1/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. |
režiimis | nöör | Valige hooldusrežiim. Saadaval olevad valikud on järgmised: äravool, taustaprogramm ei aktsepteeri uusi ühendusi, kuid jätkab praeguste ühenduste haldamist; või lõigatud, suletakse praegused ühendused. |
Vastuse näide:
{
"description" : "Set backend status",
"params" : {
"action" : "maintenance",
"mode" : "cut"
}
}
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.1/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.1/zapi.cgi/farms/gslbfarm
GET /farms/<farmname>
Näita kõiki antud talu konfiguratsioone.
Vastuse näide:
{
"description" : "List farm gslbfarm",
"ipds" : {
"blacklists" : [],
"dos" : [],
"rbl" : [
"protection_ssh"
]
},
"params" : {
"status" : "needed restart",
"vip" : "192.168.100.155",
"vport" : 60
},
"services" : [
{
"algorithm" : "roundrobin",
"backends" : [
{
"id" : 1,
"ip" : "127.0.0.1",
"port" : 53,
"status" : "up"
},
{
"id" : 2,
"ip" : "192.168.55.40",
"port" : 53,
"status" : "up"
},
{
"id" : 4,
"ip" : "192.135.10.2",
"port" : 53,
"status" : "up"
}
],
"deftcpport" : 53,
"fgenabled" : "true",
"fgscript" : "check_tcp",
"fgtimecheck" : 5,
"id" : "service1"
},
{
"algorithm" : "prio",
"backends" : [
{
"id" : 1,
"ip" : "127.0.0.1",
"port" : 80,
"status" : "up"
},
{
"id" : 2,
"ip" : "127.0.0.1",
"port" : 80,
"status" : "up"
}
],
"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. |
rbl | String [] | Põllumajandusettevõtte suhtes kohaldatakse RBL-eeskirju. |
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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on ülespoole ja kõik taustaprogrammid on kättesaamatud; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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. |
port | Number | Taustaprogrammi sadam, kus tegelik teenus kuulab. |
staatus | nöör | Taustase staatus. Võimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus on avastanud, et taustaprogramm ei tööta; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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.1/zapi.cgi/farms/gslbFarm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists|rbl>
Rakenda põllumajandusettevõttele must nimekiri, DoS või RBL reegel.
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.1/zapi.cgi/farms/gslbFarm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists|rbl>/<name>
Eemaldage mustal nimekirjal, DoS-il või RBL-reeglil antud talust, kasutades oma idenfikaatorit 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.1/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.1/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.1/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.1/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.1/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",
"port":53,
"status":"up"
},
{
"id" : 2,
"ip" : "192.168.55.40",
"port":53,
"status":"up"
}
]
}
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. |
staatus | nöör | Taustase staatus. Võimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus on avastanud, et taustaprogramm ei tööta; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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.1/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.1/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.1/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.1/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:
- NS. Name Server tüüpi kirje, mis delegeerib DNS-tsooni antud autoriteetsete nimeserverite kasutamiseks.
- A. Aadressi tüübi kirje, mis tagastab hostile IPv4i aadressi.
- CNAME. Kanooniline nimetüübi kirje, see esindab antud nime varjunime.
- 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.
- AAAA. Aadressi tüübi kirje, mis tagastab hostile IPv6i aadressi.
- MX. E-posti vahetuse tüübi kirje kaardistab domeeninime selle domeeni sõnumiedastusagentide loendisse.
- SRV. Teenusepakkuja tüübi kirje, üldistatud teenuse asukoha kirje, mida kasutatakse uuemate protokollide asemel protokolli-spetsiifiliste kirjete, nagu MX, loomiseks.
- 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.
- 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.
- 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.1/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.1/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.1/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.1/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.1/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,
"status" : "undefined",
"weight" : 2
},
{
"id" : 1,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"status" : "undefined",
"weight" : 1
}
],
"description" : "List farm dlink",
"params" : {
"algorithm" : "weight",
"status" : "down",
"vip" : "192.168.100.199"
}
}
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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on ülespoole ja kõik taustaprogrammid on kättesaamatud; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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 |
staatus | nöör | Taustase staatus. Võimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus on avastanud, et taustaprogramm ei tööta; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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.1/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,
"status" : "undefined",
"weight" : 2
},
{
"id" : 7,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"status" : "undefined",
"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. |
staatus | nöör | Taustase staatus. Võimalikud väärtused on: up, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus on avastanud, et taustaprogramm ei tööta; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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.1/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 |
---|---|---|
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. Vaikeväärtus on 1. |
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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:
Võrgu liidese tugi baasi draiverites iga ori kiiruse ja dupleksi saamiseks.
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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",
"interface_virtual" : null
},
{
"floating_ip" : "192.168.100.41",
"interface" : "eth0",
"interface_virtual" : "eth0:virtiface"
},
{
"floating_ip" : null,
"interface" : "eth0.1",
"interface_virtual" : null
},
{
"floating_ip" : null,
"interface" : "eth1",
"interface_virtual" : null
}
]
}
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. |
interface_virtual | nöör | Liidese varjamiseks kasutatava ujuva IP virtuaalse liidese nimi. |
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.1/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.41",
"interface" : "eth0",
"interface_virtual" : "eth0:virtiface"
}
}
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. |
interface_virtual | nöör | Liidese varjamiseks kasutatava ujuva IP virtuaalse liidese nimi. |
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on üles ja kõik taustaprogrammid on kättesaamatud või hooldus; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; hooldus, talu on üles ja seal on tagapõhi, kuid peaaegu tagaplaan on hooldusrežiimis; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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.1/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, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus on avastanud, et taustaprogramm ei tööta; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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" : "down"
},
{
"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, talu töötab ja taustaprogramm on valmis ühenduste vastuvõtmiseks; alla, talu töötab ja teenus 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; defineerimata, pole taustaprogrammi olekut kontrollitud. |
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.1/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" : {
"critical" : 0,
"down" : 1,
"problem" : 0,
"total" : 2,
"up" : 1
},
"gslb" : {
"critical" : 0,
"down" : 0,
"problem" : 0,
"total" : 1,
"up" : 1
},
"lslb" : {
"critical" : 0,
"down" : 2,
"problem" : 0,
"total" : 4,
"up" : 2
}
}
}
Vastuse parameetrid
Vastuseks on JSON, millel on kolm võtit: dslb, gslb ja lllb.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
kriitiline | Number | Kriitilises seisundis olevate põllumajandusettevõtete arv. Talu on kriitiline, kui see on üles ehitatud ja kõik taustaprogrammid on kättesaamatud (alla või hooldus). |
alla | Number | Peatatud talude arv. Talumajapidamised peatavad süsteemiadministraator. |
probleem | Number | Probleemse seisundiga põllumajandusettevõtete arv. Talu on probleemiks, kui see on üles ehitatud ja peaaegu tagaplaan on allapoole. |
summaarne | Number | Kokku põllumajandusettevõtete arv. |
up | Number | Käimasolevate põllumajandusettevõtete arv. Siin kuvatakse hooldatud ja vajadus talu staatuse taaskäivitamiseks. |
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.1/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. Olemasolevad oleku väärtused on järgmised: alla, talu ei tööta; vaja uuesti taaskäivitada, talu on üles, kuid see ootab taaskäivitamist; kriitiline, talu on üles ja kõik taustaprogrammid on kättesaamatud või hooldus; probleem, talu on ülespoole ja seal on mõni tagaplaanil kättesaamatu, kuid peaaegu tagaplaanil on staatus; hooldus, talu on üles ja seal on tagapõhi, kuid peaaegu tagaplaan on hooldusrežiimis; up, talu on üles kasvanud ja kõik tagapõhjad on edukad. |
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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, DoS or RBL.
Loetle kõik ipds reeglid
Nimekiri ipds reeglid
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds
GET /ipds
Loetlege kõik ipds reeglid, mis süsteemist väljuvad.
Vastuse näide:
{
"description" : "List the available IPDS rules.",
"params" : [
{
"name" : "dosrst",
"rule" : "dos",
"type" : "farm"
},
{
"name" : "ssh_brute_force",
"rule" : "dos",
"type" : "system"
},
{
"name" : "geo_IL_israel",
"rule" : "blacklist"
},
{
"name" : "geo_ME_montenegro",
"rule" : "blacklist"
},
{
"name" : "sip",
"rule" : "rbl"
},
{
"name" : "ssh",
"rule" : "rbl"
}
]
}
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 |
---|---|---|
nimi | nöör | IPDS reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
välistada | nöör | See on ipds reegli olemus. See võib olla Musta Nimekirja, dos or rbl. |
tüüp | nöör | See väli kuvatakse dos reeglites ja see määrab, kas reegel on süsteem, see kehtib tasakaalustaja kohta; või talu, kehtivad eeskirjad talu kohta. |
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:
- Kaugjuhtimispuldid: loendid saadakse URL-ist, need nimekirjad ei ole modifitseeritavad ja neid saab alla laadida.
- 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, üks tüüp eitama ja muud tüüpi võimaldama, siis alati hinnatakse kõigepealt lubamispoliitikat.
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.1/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",
"status" : "down",
"type" : "local"
},
{
"farms" : [],
"name" : "russia",
"policy" : "deny",
"preload" : "true",
"status" : "down",
"type" : "local"
},
{
"farms" : [],
"name" : "northkorea",
"policy" : "deny",
"preload" : "true",
"status" : "down",
"type" : "local"
},
{
"farms" : [
"FarmHttp1",
"FarmGslb1",
],
"name" : "remoteList",
"policy" : "deny",
"preload" : "false",
"status" : "up",
"type" : "remote"
},
{
"farms" : [],
"name" : "myWhiteList",
"policy" : "allow",
"preload" : "false",
"status" : "down",
"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. |
staatus | nöör | Võimalikud väärtused on: up, aktiveeritakse must nimekiri ja blokeeritakse (või lubatakse) nimekirja allikate liiklus; või alla, tegelikult reegel ei tööta ja see ei ole liikluse filtreerimine. |
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.1/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"
}
],
"status" : "up",
"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. |
staatus | nöör | Võimalikud väärtused on: up, aktiveeritakse must nimekiri ja blokeeritakse (või lubatakse) nimekirja allikate liiklus; või alla, tegelikult reegel ei tööta ja see ei ole liikluse filtreerimine. |
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
},
"status" : "up",
"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. |
staatus | nöör | Võimalikud väärtused on: up, aktiveeritakse must nimekiri ja blokeeritakse (või lubatakse) nimekirja allikate liiklus; või alla, tegelikult reegel ei tööta ja see ei ole liikluse filtreerimine. |
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.1/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.1/zapi.cgi/ipds/blacklists
POST /ipds/blacklists
Looge kasvandustes kasutatav must nimekiri. Mustad nimekirjad võivad olla kahte tüüpi:
- Kohalik: allikaid lisab kasutaja. Nimekiri salvestatakse kohapeal.
- 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.1/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 ainult allikas 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.1/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.1/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.1/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.1/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.1/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.
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.1/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.1/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.1/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.1/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.1/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"
}
Rakenda musta nimekirja reeglile toimingut
Rakenda anction
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.1/zapi.cgi/ipds/blacklists/remoteList/actions
POST /ipds/blacklists/<name>/actions
Rakenda musta nimekirja toimingut. nimi on mustade nimekirjade unikaalne identifikaator.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus | Nõutud |
---|---|---|---|
tegevus | nöör | Musta nimekirja reegli rakendamiseks soovitud toiming. Olemasolevad väärtused on järgmised: algus, tegutseb see kõikidel põllumajandusettevõtetel, kus seda rakendatakse; peatus, see peatab musta farmi nimekirja kõikides farmides, kus rakendatakse musta nimekirja reeglit, liiklust ei blokeerita ega lubata; ajakohastama, saab seda toimingut rakendada ainult kauge mustad nimekirjad, see toiming uuendab allika nimekirja kaugjuhtimispuldilt URL. | 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. |
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 | Võimalikud väärtused on: up, aktiveeritakse DoS reegel ja filtreeritakse liiklust; või alla, reegel ei tööta ja see ei filtreeri liiklust. |
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.1/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"
},
]
}
}
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.1/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",
"status" : "down",
"type" : "farm"
},
{
"farms" : [],
"limit" : 2,
"limit_burst" : 2,
"name" : "limitUsers",
"rule" : "limitsec",
"status" : "down"
"type" : "farm"
},
{
"hits" : 5,
"name" : "ssh_brute_force",
"port" : 22,
"rule" : "sshbruteforce",
"status" : "down",
"time" : 180,
"type" : "system"
},
{
"farms" : [],
"name" : "tcpAuth",
"rule" : "bogustcpflags",
"status" : "down",
"type" : "farm"
},
{
"farms" : [],
"limit" : 2,
"limit_burst" : 2,
"name" : "dos4",
"rule" : "limitrst",
"status" : "down",
"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. |
staatus | nöör | Võimalikud väärtused on: up, aktiveeritakse DoS reegel ja filtreeritakse liiklust; või alla, reegel ei tööta ja see ei filtreeri liiklust. |
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. |
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.1/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.1/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",
"status" : "down",
"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. |
staatus | nöör | Võimalikud väärtused on: up, aktiveeritakse DoS reegel ja filtreeritakse liiklust; või alla, reegel ei tööta ja see ei filtreeri liiklust. |
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. |
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.1/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.1/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. |
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.1/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"
}
Rakenda DoS reeglitele anction
Rakenda anction
Kaugloendi päringu näide:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"start"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/dos/conns_maximum/actions
POST /ipds/dos/<name>/actions
Rakenda dos reeglile toiming. nimi on dos reegli kordumatu tunnus.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus | Nõutud |
---|---|---|---|
tegevus | nöör | DoS reegli rakendamiseks soovitud toiming. Olemasolevad väärtused on järgmised: algus, tegutseb see DoS-reeglina kõikides taludes, kus seda rakendatakse; peatus, desaktiveerib see kõigi talude DoS-i, kus rakendatakse DoS-reeglit, liiklust ei blokeerita ega lubata; restart, lähtestage DoS reegel kõigi oma talude jaoks. | tõsi |
Vastuse näide:
{
"description" : "Apply a action to a DoS rule",
"params" : {
"action" : "start"
}
}
Vastuse parameetrid
Kui konfiguratsioonis ei ole probleeme, tagastab zapi soovitud toimingu.
IPDS - RBL
RBLReaalajas mustade aukude nimekirjad võimaldavad luua turvalise süsteemi delegeerimise, ajakohastatud turvasüsteemi hooldamise tüütu ülesande. RBL kontrollib koormuse tasakaalustaja sisendliiklust välise andmebaasi kaudu DNS-protokolli kaudu. DNS-serveri omanik vastutab kvaliteediallikate ajakohastamise ja pakkumise eest. DNS-andmebaasis oleva IP-allika sisendliiklus langeb.
RBL-teenusega töötamiseks lisatakse esimesed DNS-domeenid, iga DNS-domeen sisaldab spetsiifilist providoride nimekirja, mis sorteerib allika erinevate kriteeriumide jaoks kui realiseeritud rünnaku tüüpi või rünnaku tõsidust.
Kui DNS-domeenid on loodud, on vaja luua reegli konfiguratsiooniga RBL-reegel. Seejärel ühendatakse DNS-domeenid RBL-reegliga. Iga reegel võib uurida erinevaid domeene.
Viimati rakendage RBL-reeglit kõigile soovitud taludele.
Loetle kõik RBL-reeglid
Loetle kõik RBL-reeglid
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl
GET /ipds/rbl
Loetlege kõik koormuse tasakaalustaja RBL reeglid.
Vastuse näide:
{
"description" : "Get RBL rules",
"params" : [
{
"cache_size" : 8192,
"cache_time" : 3600,
"domains" : [
"ssh.rbl.zevenet.com",
"ssh.blocklist.de"
],
"farms" : [
"sshL4farm"
],
"local_traffic" : "false",
"log_level" : 4,
"name" : "protection_ssh",
"only_logging" : "true",
"queue_size" : 64538,
"status" : "down",
"threadmax" : 700
},
{
"cache_size" : 2048,
"cache_time" : 7200,
"domains" : [],
"farms" : [],
"local_traffic" : "true",
"log_level" : 4,
"name" : "sip",
"only_logging" : "true",
"queue_size" : 32269,
"status" : "down",
"threadmax" : 400
},
{
"cache_size" : 8192,
"cache_time" : 3600,
"domains" : [],
"farms" : [
"webAPP"
],
"local_traffic" : "false",
"log_level" : 4,
"name" : "web_attacks",
"only_logging" : "true",
"queue_size" : 64538,
"status" : "down",
"threadmax" : 700
}
]
}
Vastuse parameetrid
Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on RBL-objektide massiiv, millest igaüks sisaldab allpool toodud võtmes atribuute.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
Domeenid | String [] | See on nimekiri kõigist domeenidest, mida reegel taotleb. |
talud | String [] | Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
staatus | nöör | Näita RBL reegli olekut. Selle väärtus võib olla alla, kui reegel ei tööta; või up see reegel töötab. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Too RBL reegel
Too RBL reegel
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/protection_ssh
GET /ipds/rbl/<name>
Näita RBL konfiguratsiooni ja selle kirjelduse parameetreid. nimi on RBL reegli kordumatu tunnus.
Vastuse parameetrid
Vastuse näide:
{
"description" : "Get RBL protection_ssh",
"params" : {
"cache_size" : 8192,
"cache_time" : 3600,
"domains" : [
"ssh.zevenet.com",
"ssh.blocklist.de"
],
"farms" : [
"sshL4farm"
],
"local_traffic" : "false",
"log_level" : 4,
"name" : "protection_ssh",
"only_logging" : "true",
"queue_size" : 64538,
"status" : "down",
"threadmax" : 700
}
}
RBL reegli objekt:
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
Domeenid | String [] | See on nimekiri kõigist domeenidest, mida reegel taotleb. |
talud | String [] | Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
staatus | nöör | Näita RBL reegli olekut. Selle väärtus võib olla alla, kui reegel ei tööta; või up see reegel töötab. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Looge RBL reegel
Looge uus RBL reegel
Päringu näide:
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"all"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl
POST /ipds/rbl
Looge põllumajandusettevõtetes kasutatav RBL-reegel.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus | Nõutud |
---|---|---|---|
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. | tõsi |
{
"description" : "Create a RBL rule.",
"params" : {
"cache_size" : 8192,
"cache_time" : 3600,
"domains" : [],
"farms" : [],
"local_traffic" : "false",
"log_level" : 4,
"name" : "all",
"only_logging" : "true",
"queue_size" : 64538,
"status" : "down",
"threadmax" : 700
}
}
Vastuse parameetrid
Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on RBL-objektide massiiv, millest igaüks sisaldab järgmisi võtme atribuute.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
Domeenid | String [] | See on nimekiri kõigist domeenidest, mida reegel taotleb. |
talud | String [] | Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
staatus | nöör | Näita RBL reegli olekut. Selle väärtus võib olla alla, kui reegel ei tööta; või up see reegel töötab. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Muuda RBL reeglit
Muuda RBL reeglit
Päringu näide:
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"all_reported","cache_size":16384, "cache_time":180000, "queue_size":32269, "threadmax":500, "local_traffic":"true", "log_level":4, "only_logging":"true"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/all
PUT /ipds/rule/<name>
Muuda RBL reegli konfiguratsiooni. nimi on RBL reegli kordumatu tunnus.
Taotlege parameetreid:
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Vastuse näide:
{
"description" : "Modify RBL rule all.",
"params" : {
"cache_size" : 16384,
"cache_time" : 180000,
"domains" : [],
"farms" : [],
"local_traffic" : "true",
"log_level" : 4,
"name" : "all",
"only_logging" : "true",
"queue_size" : 32269,
"status" : "down",
"threadmax" : 500
}
}
Vastuse parameetrid
Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on RBL-objektide massiiv, millest igaüks sisaldab järgmisi võtme atribuute.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
Domeenid | String [] | See on nimekiri kõigist domeenidest, mida reegel taotleb. |
talud | String [] | Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
staatus | nöör | Näita RBL reegli olekut. Selle väärtus võib olla alla, kui reegel ei tööta; või up see reegel töötab. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Kopeerige RBL-reegel
Kopeerige RBL-reegel
Päringu näide:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"copied_rule"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/all_reported
POST /ipds/rule/<name>
Uue reegli loomiseks kopeerige RBL-reegel. nimi on RBL reegli kordumatu tunnus.
Taotlege parameetreid:
Väli | KASUTUSALA | Kirjeldus | nõutav |
---|---|---|---|
nimi | nöör | RBL reegli nimi uue reegli jaoks. Seda kasutatakse unikaalse identifikaatorina. | tõsi |
Vastuse näide:
{
"description" : "Copy a RBL rule.",
"params" : {
"cache_size" : 16384,
"cache_time" : 180000,
"domains" : [],
"farms" : [],
"local_traffic" : "true",
"log_level" : 4,
"name" : "copied_rule",
"only_logging" : "true",
"queue_size" : 32269,
"status" : "down",
"threadmax" : 500
}
}
Vastuse parameetrid
Vastuseks on JSON-objekt, mille klahv on seatud parameetrid. Selle väärtus on RBL-objektide massiiv, millest igaüks sisaldab järgmisi võtme atribuute.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
vahemälu suurus | Number | IP-allika arv, mida RBL-reegel saab vahemällu salvestada. |
vahemälu_aeg | Number | See on aeg (sekundites), et IP-allikas blokeeritakse. |
Domeenid | String [] | See on nimekiri kõigist domeenidest, mida reegel taotleb. |
talud | String [] | Põllumajandusettevõtete nimekiri, kus kasutatakse musta nimekirja. |
local_traffic | nöör | Kui sellel väljal on väärtus tõsiRBL reegel uurib liiklust eravõrgu segmentidest; või kui selle väärtus on vale RBL reegel ignoreerib liiklust eravõrgu segmentidest. Avalik DNS ei blokeeri kohalikku liiklust. |
log_level | Number | See on raskusastme tase. Selle väärtus võib olla 0i ja 7i vahel, olles 0i hädaolukord ja 7i silumine. |
nimi | nöör | RBL reegli nimi. Seda kasutatakse unikaalse identifikaatorina. |
only_logging | nöör | Kui väärtus on tõsi, kui domeenis on IP-i vaste, logitakse see sisse; või kui sellel väljal on väärtus valeKui domeenis on IP-aadress, logitakse IP ja pakett langeb. |
queue_size | Number | See on pakettide arv, mida reegel võib järjekorras hoida. |
staatus | nöör | Näita RBL reegli olekut. Selle väärtus võib olla alla, kui reegel ei tööta; või up see reegel töötab. |
threadmax | nöör | See on pakettide arv, mida reegel saab DNS-serveritele samaaegselt küsida. Selle maksimaalne väärtus on 700. Kui sisendpakettide arv on suurem kui threadmax, võetakse järgmised paketid automaatselt vastu. |
Kustuta RBL-reegel
Kustuta RBL
Päringu näide:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/sip
DELETE /ipds/rbl/<name>
Kustutage antud RBL reegel. nimi on RBL reegli kordumatu tunnus.
Vastuse näide:
{
"description" : "Delete RBL 'sip'",
"message" : "The rule sip has been deleted successful.",
"success" : "true"
}
Loetle kõik RBL-domeenid
Loetle kõik RBL-domeenid
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/domains
GET /ipds/rbl/domains
Loetle kõik kasutatavad domeenid, mis on seotud RBL eeskirjadega.
Vastuse näide:
{
"description" : "Get RBL domains",
"params" : {
"preloaded" : [
{
"domain" : "all.rbl.zevenet.com",
"id" : 0
},
{
"domain" : "ssh.rbl.zevenet.com",
"id" : 1
},
{
"domain" : "sip.rbl.zevenet.com",
"id" : 2
}
],
"user" : [
{
"domain" : "zen.spamhaus.org",
"id" : 0
},
{
"domain" : "web.dnsbl.sorbs.net",
"id" : 1
}
]
}
}
Vastuse parameetrid
Vastuseks on võtmega JSON parameetrid ja kaks tüüpi domeenide loendit väärtuseks.
Allikasobjekt:
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
eelsalvestatud | Objekt [] | See on nimekiri Zevenet meeskonna lisatud domeenidest. |
kasutaja | Objekt [] | See on koormuse tasakaalustaja administraatori poolt lisatud domeenide loend. |
eelsalvestatud ja kasutajaobjekt:
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
id | Number [] | See on domeeni identifikaator. |
domeen | String [] | See on domeen, kus rbl-reegel pärineb. |
Lisage domeen
Lisage domeen
Päringu näide:
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"domain":"web.dnsbl.sorbs.net"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/domains
POST /ipds/rbl/domains
Lisage kasutaja domeeni loendisse uus domeen.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus | Nõutud |
---|---|---|---|
domeen | nöör | See on RBL-provintsi tsoon, kus RBL-reegel teeb päringuid. | tõsi |
Vastuse näide:
{
"description" : "Post a RBL domain.",
"message" : "",
"params" : {
"domains" : [
"zen.spamhaus.org",
"sip.blocklist.de",
"web.dnsbl.sorbs.net"
]
}
}
Vastuse parameetrid
Vastuseks on json koos kõigi koormuse tasakaalustaja administraatori poolt lisatud domeenidega.
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
Domeenid | String [] | See on koormuse tasakaalustaja administraatori poolt lisatud domeenide loend. |
Domeeni muutmine
Domeeni muutmine
Päringu näide:
curl -k -X PUT -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"domain":"ssh.blocklist.de"}'
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/domains/2
PUT /ipds/rbl/domains/<id>
Muutke domeeni või kasutaja domeenide loendit mõne muu parameetrina saadetud kujul.
id on domeeni kasutaja identifikaator.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
domeen | nöör | See on domeen, mis asendab URI-sse saadetud domeeni. |
Vastuse näide:
{
"description" : "Replace a domain",
"message" : "RBL domain ssh.blocklist.de has been modified successful.",
"params" : {
"domains" : [
{
"domain" : "zen.spamhaus.org",
"id" : 0
},
{
"domain" : "web.dnsbl.sorbs.net",
"id" : 1
},
{
"domain" : "ssh.blocklist.de",
"id" : 2
}
]
}
}
Vastuse parameetrid
Vastuseks on json koos kõigi koormuse tasakaalustaja administraatori poolt lisatud domeenidega.
Kasutaja domeeni objekt:
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
id | Number [] | See on domeeni identifikaator. |
domeen | String [] | See on domeen, kus rbl-reegel pärineb. |
Domeeni kustutamine
Domeeni kustutamine
Päringu näide:
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/domains/1
DELETE /ipds/rbl/domains/<id>
Domeeni kustutamine kasutaja domeenide loendist.
id on domeeni kasutaja identifikaator, mida see kustutatakse.
Vastuse näide:
{
"description" : "Delete a RBL domain.",
"message" : "RBL domain web.dnsbl.sorbs.net has been deleted successful.",
"success" : "true"
}
Rakendage RBL reeglis toimingut
Rakenda toiming
Päringu näide:
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"stop"}' https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/ipds/rbl/<name>/action
POST ipds/rbl/<name>/actions
Rakendage RBL-i talule toimingut, vaadake tegevuste tabeli Taotlusparameetrid. Meetme rakendamiseks reeglile on vajalik, et reeglit rakendataks peaaegu ühele põllumajandusettevõttele.
nimi on RBL reegli kordumatu tunnus.
Taotlege parameetreid
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
tegevus | nöör | Rakenda soovitud toiming. Toimingud on järgmised: peatus, RBL-reegel peatatakse ja liikluse etteantud põllumajandusettevõtted, kus seda rakendatakse, reeglit ei tühistata. alguskäivitatakse RBL-reegel ja kogu liiklus edasi nende põllumajandusettevõtete ees, kus seda reeglit rakendatakse. |
Vastuse näide:
{
"description" : "Apply a action to a RBL rule",
"params" : {
"action" : "start"
}
}
Vastuse parameetrid
Kui konfiguratsioonis ei ole probleeme, tagastab zapi soovitud toimingu.
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.1/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.1/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.1/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.1/zapi.cgi/system/ssh
GET /system/ssh
Näita SSH-teenuse konfiguratsiooni.
Vastuse näide:
{
"description" : "Get ssh",
"params" : {
"listen" : "*",
"port" : "22"
}
}
Vastuse parameetrid
Väli | KASUTUSALA | Kirjeldus |
---|---|---|
kuulama | nöör | IP-süsteem, kus SSH-teenus kuulab. The märk * kasutatakse kõigi seadistatud IP-de kuulamiseks. <$ |
port | nöör | SSH teenuse jaoks konfigureeritud port. |
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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. |
Näita logifailide ridu
Näita logifailide ridu
Päringu näide:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/zapi.cgi/system/logs/kern.log/lines/2
GET /system/logs/<file>/lines/<lines>
Loetlege mitu logifaili rida. URI param fail on logifail lugemisest. Liinid on finaali näitavate ridade arv.
Vastuse näide:
{
"description" : "Show a log file",
"log" : [
"Aug 28 09:44:00 maq2 kernel: [258451.740173] Netfilter messages via NETLINK v0.30.\n",
"Aug 28 09:44:00 maq2 kernel: [258451.775666] ctnetlink v0.93: registering with nfnetlink.\n"
]
}
Vastuse parameetrid
Vastuseks on JSON koos logifaili hulgaga. Võti on log ja selle väärtus on massiiv koos taotletud ridade arvuga.
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.1/zapi.cgi/system/logs/syslog.2.gz > log.gz
GET /system/logs/<file>
Laadige alla logifail saadavalolevate logifailide kohta, mis on loetletud GET-taotluse ajal.
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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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 kasutatavad toimingud on järgmised disabld, süsteem sündmuse toimumise ajal teadet ei saada; või võimaldama, 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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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.1/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. |