Zevenet API v3 Reference

ZAPI (Zevenet Application Programming Interface) er værktøjet til systemadministrator til at kontrollere Zevenet load balancer adfærd.

Det er nødvendigt at aktivere zapi-brugeren fra web-grænsefladen, før den bruges, System / Brugere.

Når zapi-brugeren er oprettet, er det muligt at sende anmodning til URL'en, https: //zevenet_server: 444 / ZAPI / v3 / zapi.cgi /URI_path.

zevenet_server er den IP, hvor HTTP-tjenesten lytter.

URI_path definerer objektet eller handlingen. Dets opførsel og dens parametre vil blive defineret inden for hver enkelt dokumen- tationsafdeling.

De verb som bruges i denne API vil være GET, POST, PUT or SLET. En PUT- eller POST-anmodning har altid brug for næsten en parameter, selvom dette ikke behøver nogen krævet parameter.

Certifikater

Zevenet understøtter cetificates i PEM format til at bruge dem med dine HTTP gårde med HTTPS lytter. Hvis du vil lære mere om, hvordan du opretter pem-certifikater, kan du besøge følgende artikel: GENERERENDE CERTIFIKATER I PEM FORMAT

Angiv alle certifikater

Angiv alle certifikater

Forespørgselseksempel:

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

GET /certificates

Angiv alle CSR- og PEM-certifikater i certifikatbutikken. Disse certifikater kan bruges sammen med HTTPS-bedrifter.

Svaret bliver et JSON objekt med en nøgle indstillet til params. Værdien af dette vil være en række certifikatobjekter, der hver indeholder nøgleattributterne nedenfor.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
params	Objekt []	Liste over certifikatobjekter.

Certifikatobjekt

Field	Type	Beskrivelse
CN	String	Domæne fælles navn.
skabelse	String	Oprettelsesdato.
udløb	String	Udløbsdato.
fil	String	Certifikatets filnavn, unikt id.
udsteder	String	Certified Authority, der underskriver certifikatet.
typen	String	CSR eller certifikat.

Download certifikat

Download certifikat

Forespørgselseksempel:

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

GET /certificates/<file>

Download et certifikat, der er installeret i certifikatbutikken, brug filnavnet i anmodningen til at identificere det.

Svaret vil indeholde overskrifterne angivet nedenfor med oplysninger om filen. Svarets krop er indholdet af filen.

Svar overskrifter:

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

Vis certifikatoplysninger

Vis certifikatoplysninger

Forespørgselseksempel:

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

GET /certificates/<file>/info

Vis alle de oplysninger, der er indeholdt i et givet certifikat i certifikatbutikken, herunder underskrifter, det er påkrævet, at filnavnet skal referere.

Svar eksempel:

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:
...

Vis aktiveringsattestoplysninger

Vis aktiveringsattestoplysninger

Forespørgselseksempel:

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

GET /certificates/activation

Vis alle de oplysninger, der er inkluderet i aktiveringsattesten, herunder underskrifter, dette certifikat er gemt i certifikatbutikken. Hvis aktiveringscertifikatet er slettet, deaktiveres produktet.

Slet et certifikat

Slet et certifikat

Forespørgselseksempel:

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

DELETE /certificates/<file>

Slet et certifikat efter filnavn i certifikatbutikken.

Svar eksempel:

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

Slet aktiveringscertifikatet

Slet aktiveringscertifikatet

Forespørgselseksempel:

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

DELETE /certificates/activation

Slet aktiveringsattesten, der er installeret i certifikatbutikken. Hvis dette certifikat er slettet, er belastningsbalancen deaktiveret.

Svar eksempel:

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

Opret et CSR-certifikat

Opret et CSR-certifikat

Forespørgselseksempel:

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

POST /certificates

Opret en certifikatsigneringsforespørgsel (CSR-fil).

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
navn	String	Certifikat ID navn.	sand
FQDN	String	Det fuldt kvalificerede domænenavn på din server.	sand
division	String	Opdelingen af din organisation, der håndterer certifikatet.	sand
organisation	String	Det juridiske navn på din organisation.	sand
lokalitet	String	Byen, hvor din organisation er placeret.	sand
tilstand	String	Den stat / region, hvor din organisation er placeret.	sand
land	String	ISO-koden med to bogstaver for det land, hvor din organisation er placeret.	sand
post	String	En e-mail-adresse bruges til at kontakte din organisation.	sand

Svar eksempel:

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

Upload et certifikat

Upload et certifikat

Forespørgselseksempel:

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

POST /certificates/<file>

Upload et PEM-certifikat til HTTP-bedrifter med HTTPS-lytteren.

Kræver parameteren --tcp-nodelayog --data-binary at uploade filen i binær tilstand.

Anmod URI-parametre

Field	Type	Beskrivelse	påkrævet
fil	String	Certifikatfilnavn for at uploade og gemme i certifikatbutikken.	sand

Svar eksempel:

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

Upload et aktiveringscertifikat

Upload et aktiveringscertifikat

Forespørgselseksempel:

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

POST /certificates/activation

Upload et aktiveringscertifikat med PEM-format, dette certifikat er nødvendigt for at aktivere alle funktionaliteter. Dette certifikat er gemt i certifikatbutikken, hvis aktiveringscertifikatet findes i certifikatbutikken, overskrives det forrige certifikat.

Svar eksempel:

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

Gårde

Zevenet er i stand til at styre trafikken på tre forskellige måder, hver vej styres af et andet modul, Local Service load balancer eller LSLB modul, Global Service Load Balancer eller GSLB modul og Datalink Service Load Balancer eller DSLB modul.

Alle moduler arbejder med Farm Profile-konceptet, en Farm Profile er en gruppe af parametre klar til at gøre en særlig handling med netværkstrafik. Det er vigtigt at forstå, hvad der kan gøre hver gårdsprofil for at opnå de bedste resultater fra Zevenet ADC.

LSLB: Dette modul er i stand til at arbejde med http l4xnat profil gårde. Det fungerer som en web-omvendt proxy eller router
GSLB: Dette modul er i stand til at arbejde med GSLB profil gård. Det fungerer som Domain Name Server
DSLB: Dette modul er i stand til at arbejde med data link profil gård. Det fungerer som en gateway.

Liste over alle gårde

Liste over alle gårde

Forespørgselseksempel:

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

GET /farms

Liste over alle tilgængelige gårde

Svaret bliver et JSON objekt med en nøgle indstillet til params. Værdien af dette vil være en række af genbrugsgenstande, der hver især indeholder nøgleattributterne nedenfor.

Farm Object

Field	Type	Beskrivelse
farmname	String	Farm beskrivende navn. Den bruges som unik identifikator.
profil	String	Profiltype, de tilgængelige profiler er: http, https or l4xnat til LSLB modul, GSLB for GLSB modul og data link til DSLB modul
status	String	Farm status, status tilgængelige værdier er: up, gården løber eller ned, gården er stoppet
vip	String	Virtual IP hvor gården modtager trafik
VPort	String	Virtuel port, hvor gården modtager trafik, port tilgængelige værdier er: et portnummer for http [s], l4xnat og gslb profiler, en gruppe af porte adskilt af “,” eller et portområde adskilt af “:” for l4xnat profiler, i l4xnat kan begge separatorværdier (“,” og “:”) bruges i samme felt.

Svar eksempel:

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

Slet en gård

Slet en gård

Forespørgselseksempel:

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

DELETE /farms/<farmname>

Slet en gård gennem sin bedrifts navn identifikator.

Svar eksempel:

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

Indstil en handling i en gård

Indstil en handling i en gård

Forespørgselseksempel:

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

PUT /farms/<farmname>/actions

Anvend en handling på en gård, se tabellen Forespørgselsparametre for handlinger.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	Indstil den ønskede handling. Handlingerne er: stoppe, bliver gården stoppet. starte, gården bliver startet og genstart, gården stoppes og startes automatisk.

Svar eksempel:

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

Response parametre

Hvis der ikke er nogen problemer i konfigurationen, returnerer zapi den ønskede handling.

HTTP Farms

HTTP-profil er et avanceret lag 7-belastningsbalancering (eller Application Delivery Controller) med proxy-specialegenskaber. Denne profil indeholder nogle funktioner som HTTPS-lag 7 belastningsbalancering kombineret med SSL offload acceleration. Denne profil er adecuated for webtjenester (inkluderet webapplikationsservere) og alle applikationsprotokoller baseret på HTTP- og HTTPS-protokoller som WebDav, RDP over HTTP, ICA over HTTP osv. For at konfigurere denne gårdsprofil, en virtuel IP-adresse og en Virtual TCP-port vil blive påkrævet.

Hent gården ved navn

Hent gården ved navn

Forespørgselseksempel:

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

GET /farms/<farmname>

Vis alle konfigurationer om en given gård.

Svar eksempel:

{
   "description" : "List farm httpFarm",
   "ipds" : {
      "blacklists" : [
         "rem"
      ],
      "dos" : []
   },
   "params" : {
      "certlist" : [
         {
            "file" : "zencert.pem",
            "id" : 1
         }
      ],
      "cipherc" : "ALL",
      "ciphers" : "all",
      "contimeout" : 20,
      "error414" : "Request URI is too long.",
      "error500" : "An internal server error occurred. Please try again later.",
      "error501" : "This method may not be used.",
      "error503" : "The service is not available. Please try again later.",
      "httpverb" : "MSRPCext",
      "listener" : "https",
      "reqtimeout" : 30,
      "restimeout" : 45,
      "resurrectime" : 10,
      "rewritelocation" : "enabled",
      "status" : "down",
      "vip" : "192.168.100.211",
      "vport" : 200
   },
   "services" : [
      {
         "backends" : [],
         "cookiedomain" : "",
         "cookieinsert" : "false",
         "cookiename" : "",
         "cookiepath" : "",
         "cookiettl" : 0,
         "fgenabled" : "false",
         "fglog" : "false",
         "fgscript" : "",
         "fgtimecheck" : 5,
         "httpsb" : "false",
         "id" : "service3",
         "leastresp" : "false",
         "persistence" : "",
         "redirect" : "",
         "redirecttype" : "",
         "sessionid" : "",
         "ttl" : 0,
         "urlp" : "",
         "vhost" : ""
      },
      {
         "backends" : [
            {
               "id" : 0,
               "ip" : "192.168.0.168",
               "port" : 80,
               "status" : "up",
               "timeout" : null,
               "weight" : null
            }
         ],
         "cookiedomain" : "",
         "cookieinsert" : "false",
         "cookiename" : "",
         "cookiepath" : "",
         "cookiettl" : 0,
         "fgenabled" : "false",
         "fglog" : "false",
         "fgscript" : "tcp_check",
         "fgtimecheck" : 5,
         "httpsb" : "false",
         "id" : "srv",
         "leastresp" : "false",
         "persistence" : "",
         "redirect" : "",
         "redirecttype" : "",
         "sessionid" : "",
         "ttl" : 0,
         "urlp" : "",
         "vhost" : ""
      },
   ]
}

Response parametre

Svaret vil være et JSON objekt med nedenstående format.

Farm Object:

Field	Type	Beskrivelse
IPDS	Object	Liste over IPDS regler anvendt på denne gård.
params	Object	Parametre for gårdskonfiguration.
tjenester	Objekt[]	Array med alle tjenester skabt i denne gård og dens konfiguration.

IPDS-objekt:

Field	Type	Beskrivelse
sortlister	Snor[]	Blacklist regler anvendes på gården.
dos	Snor[]	DoS regler gælder for gården.

Parametre objekt for HTTP gårde:

Field	Type	Beskrivelse
certlist	Objekt[]	Kun i https profil. Certifikatliste aktiveret på gården, i pem-format, er det tilladt at tilføje mere end ét pem certifikat til samme gård til SNI support. lytter med https værdi er påkrævet. Ethvert certifikat i certifikatbutikken kan bruges her.
cipherc	String	Kun i https-lytteren. Dette er den tilladte tilpassede liste over cifre, der accepteres af SSL-forbindelsen, hvilket er en streng i samme format som i OpenSSL-cifre. Denne attribut bruges kun når ciphers feltet har værdien sutomsikkerhed.
ciphers	String	Kun i lytter med https værdi. Bruges til at opbygge en liste over cifre accepteret af SSL-forbindelser for at hærde SSL-forbindelsen. Indstillingerne er: alle, vil alle cifre blive accepteret highsecurity, kun cifre for høj sikkerhed vil blive accepteret, eller customsecurity, kun cifre indlæst i cipherc feltet accepteres.
contimeout	nummer	Hvor længe gården skal vente på en TCP-forbindelse til backend på sekunder.
error414	String	Personlig besked til reaktion med 414 HTTP fejlkode.
error500	String	Personlig besked til reaktion med 500 HTTP fejlkode.
error501	String	Personlig besked til reaktion med 501 HTTP fejlkode.
error503	String	Personlig besked til reaktion med 503 HTTP fejlkode.
httpverb	String	Dette felt angiver de operationer, der vil blive tilladt for HTTP-klientanmodningerne. tilgængelige værdier er: standardHTTP, accepterede http-forespørgsler GET, POST, HEAD. extendedHTTP, accepteret tidligere http-anmodninger plus PUT, DELETE. standardWebDAV, accepteret tidligere http-anmodninger plus LOCK, UNLOCK, PROPFIND, PROPPATCH, SØG, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV accepteret tidligere http-anmodninger plus SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT, eller MSRPCext, accepteret tidligere http-anmodninger plus RPC_IN_DATA, RPC_OUT_DATA. Bemærk, at disse værdier er følsomme.
lytter	String	En lytter definerer, hvordan gården skal spille med forespørgsler fra klienterne. Indstillingerne er: http for ikke sikret protokol eller https for sikret protokol.
reqtimeout	nummer	Hvor lang tid går gården til at vente på en klientanmodning om få sekunder.
restimeout	nummer	Hvor lang tid går gården til at vente på et svar fra backends i sekunder.
resurrectime	nummer	Perioden for at komme ud af en faldet reel server, efter denne periode kontrollerer belastningsbalanceren, om den virkelige server lever, i sekunder.
rewritelocation	String	Hvis det er aktiveret, er bedriften tvunget til at ændre placeringen: og indholdssted: overskrifter i svar til klienter med den virtuelle vært. Indstillingerne er: aktiveret, aktiveret deaktiveret, inaktiveret eller aktiveret-backends kun backend-adressen er sammenlignet.
status	String	Farm status. De mulige værdier er: upgården går; ned, gården er stoppet eller nødvendige genstart, gården skal genstartes for at de seneste ændringer kan træde i kraft.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste lytter.

Certlist objekt:

Field	Type	Beskrivelse
fil	String	Certifikatets navn, referencer til certifikatet i certifikatbutikken.
id	nummer	Certifikat-id, rækkefølgen på listen, den første, bruges som standard, hvis den virtuelle værtsoverskrift ikke stemmer overens med CN-feltet i certifikatet. Bruges til SNI.

Servicesobjekt for HTTP-bedrifter:

Field	Type	Beskrivelse
backends	Objekt[]	Backends defineret i tjenesten.
cookiedomain	String	Cookie insertion vil blive udført, hvis domæne matcher i cookie indholdet. Aktiver cookieinsert Felt er påkrævet.
cookieinsert	String	Det gør det muligt at indsætte cookie til backends klæbrig sessioner. Indstillingerne er sand, vil profilen søge efter den givne cookie i feltet cookiename, hvis den ikke findes, tilføjes denne cookie, falsk, er der ikke taget skridt.
cookiename	String	Cookie-navnet (session-id) vil blive brugt til at identificere den klæbende proces til bagsiden. Aktiver cookieinsert Felt er påkrævet.
cookiepath	String	Det styrer cookie path værdien for den givne cookie. Aktiver cookieinsert Felt er påkrævet.
cookiettl	nummer	Det er den maksimale levetid for en cookie i sekunder. Aktiver cookieinsert Felt er påkrævet.
fgenabled	String	Aktivér brug af værge. sand Farm Guardian er aktiveret og kontrollerer backends status, falsk gårdsholderen er deaktiveret og kontrollerer ikke backends status. I HTTP-profiler udføres en check_tcp som standard, selvom værger er deaktiveret.
fglog	String	Aktiver brugen af logfiler i gården. sand aktiveret, falsk, handicappet. fgenabled er nødvendigt.
fgscript	String	Kommandoen, som gårdsholderen vil bruge til at kontrollere ryggenes sundhed. sand aktiveret, falsk, handicappet. fgenabled er nødvendigt.
fgtimecheck	nummer	gårdens værge kontrollerer hvert 'timetocheck' sekund af backendens sundhedsstatus. fgenabled er nødvendigt.
httpsb	String	Denne parameter angiver til gården, at backends-servere defineret i den aktuelle tjeneste bruger HTTPS-sproget, og derefter bliver dataene krypteret før, for at blive sendt. sand, sender profilen trafikken i HTTPS-protokollen til bagsiden, falsk, sender profilen trafikken i HTTP-protokollen til bagsiden.
id	String	Tjenestens navn, det kan ikke ændres, når tjenesten er oprettet.
leastresp	String	Det muliggør den mindst responderende balance metode. sand frecuently profilen kontrollerer hvilken backend tager mindre tid til at reagere for at sende flere forbindelser til denne, falsk profilen kontrollerer ikke, hvilken backend der tager kortere tid at svare.
udholdenhed	String	Denne parameter definerer, hvordan HTTP-tjenesten skal klare klientsessionen. Indstillingerne er: "" tom streng, ingen handling er taget, IP persistenssessionen udføres i bunden af klientens IP, GRUNDLÆGGENDE Persistenssessionen udføres i bunden af BASIC headers, URL persistenssessionen udføres i basis af et felt i URI'en, PARM persistenssessionen udføres i basis af en værdi i slutningen af URI'et, COOKIE Persistenssessionen udføres i bunden af et cookie navn, denne cookie skal oprettes af bagsiden og HEADER, er persistenssessionen udført i bunden af et overskriftsnavn.
omdirigere	String	Den opfører sig som en speciel backend, da klientens anmodning besvares ved omdirigering til en ny webadresse automatisk. Hvis omdirigering er konfigureret, vil anmodningen ikke blive videresendt til backend, en omdirigering vil blive besvaret til klienten i stedet.
redirecttype	String	Hvordan omdirigering vil blive gjort, to muligheder: standard, er url taget som en absolut vært og vej til omdirigering til, append, vil den oprindelige forespørgselssti eller URI blive tilføjet til værten og den sti, du har angivet med standardindstillingen. Hvis omdirigere feltet er ikke konfigureret, dette felt vil være en tom streng.
Sessions ID	String	Det er tilgængeligt, hvis udholdenhed feltet er URL, COOKIE eller HEADER, vil parameterværdien søges af gården i http-overskriften og administrere klientsessionen.
ttl	nummer	Kun med vedholdenhed. Denne værdi angiver den maksimale levetid for en inaktiv klientsession (maks. Sessionsalder) i sekunder.
urlp	String	Giver mulighed for at bestemme en webtjeneste vedrørende den webadresse, som klienten anmoder om gennem et bestemt webadressemønster, som vil blive kontrolleret syntaktisk. PCRE regulære udtryk understøttes.
vhost	String	Det specificerer betingelsen bestemt af domænenavnet via den samme virtuelle IP og port defineret af en HTTP-gård. PCRE regulære udtryk understøttes.

Backend-objekt til HTTP-bedrifter:

Field	Type	Beskrivelse
id	nummer	Backend-id i den givne tjeneste.
ip	String	Backend's IP, hvor den rigtige tjeneste kører.
port	nummer	Backends havn, hvor den rigtige service kører.
status	String	Backend status. Værdien kan være: up backend er klar til at modtage forbindelser, vedligeholdelse backend er markeret som ikke klar til modtagelse af forbindelser, denne mulighed er nyttig til backend's vedligeholdelsesopgaver.
timeout	nummer	Det er backend-timeouten at svare på en bestemt anmodning om sekunder. Hvis null system bruger global parameter Backends timeout.
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server, backend med højere vægtværdi modtager flere forbindelser. Standardværdi null, ikke speciel vægt, der bruges til denne backend.

Opret en ny gård

Opret en ny gård

Forespørgselseksempel:

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

POST /farms

Opret en ny HTTP-bedrift.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
farmname	String	Farm beskrivende navn. Den bruges som unik identifikator.	sand
profil	String	Profilen til den oprettede Farm. For http gårde er http.	sand
vip	String	IP af gården, hvor den virtuelle service vil løbe. Den angivne IP skal konfigureres i systemet og UP	sand
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste skal lytte. Samme virtuelle port og virtuel IP må ikke bruges af en anden gård.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en gård

Ændre en gård

Forespørgselseksempel:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"contimeout":22,"newfarmname":"FarmHTTP2","vip":"178.62.126.152","vport":88, 
"restimeout":47,"resurrectime":12,"reqtimeout":32,"rewritelocation":"enabled","httpverb":"standardHTTP", 
"error414":"Message error 414","error500":"Message error 500","error501":"Message error 501", 
"error503":"Message error 503","listener":"https","ciphers":"customsecurity",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP

PUT /farms/<farmname>

Rediger globale parametre for en given HTTP-bedrift.

Anmod om parametre

Field	Type	Beskrivelse
contimeout	nummer	Hvor længe går gården at vente på en forbindelse til backend på få sekunder.
restimeout	nummer	Hvor lang tid går gården til at vente på et svar fra backends i sekunder.
resurrectime	nummer	Denne værdi i sekunder er perioden for at komme ud af en sortlistet backend og kontrollere, om den er i live.
reqtimeout	nummer	Hvor lang tid går gården til at vente på en klientanmodning om få sekunder.
rewritelocation	String	Hvis det er aktiveret, er bedriften tvunget til at ændre placeringen: og indholdssted: overskrifter i svar til klienter med den virtuelle vært. Indstillingerne er: aktiveret, aktiveret deaktiveret, inaktiveret eller aktiveret-backends kun backend-adressen er sammenlignet.
httpverb	String	Dette felt angiver de operationer, der vil blive tilladt for HTTP-klientanmodningerne. tilgængelige værdier er: standardHTTP, accepterede http-forespørgsler GET, POST, HEAD. extendedHTTP, accepteret tidligere http-anmodninger plus PUT, DELETE. standardWebDAV, accepteret tidligere http-anmodninger plus LOCK, UNLOCK, PROPFIND, PROPPATCH, SØG, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV accepteret tidligere http-anmodninger plus SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT, eller MSRPCext, accepteret tidligere http-anmodninger plus RPC_IN_DATA, RPC_OUT_DATA. Bemærk, at disse værdier er følsomme.
error414	String	Personlig meddelelsesfejl 414.
error500	String	Personlig meddelelsesfejl 500.
error501	String	Personlig meddelelsesfejl 501.
error503	String	Personlig meddelelsesfejl 503.
lytter	String	En lytter definerer, hvordan gården skal spille med forespørgsler fra klienterne. Indstillingerne er: http for ikke sikret protokol eller https for sikret protokol.
ciphers	String	Kun i https-lytteren. Dette felt bruges til at opbygge en liste over cifre accepteret af SSL-forbindelser for at hærde SSL-forbindelsen. Indstillingerne er: alle, vil alle cifre blive accepteret highsecurity, kun cifre for høj sikkerhed vil blive accepteret, eller customsecurity, kun cifre indlæst i cipherc feltet accepteres.
cipherc	String	Kun i https-lytteren. Dette er den tilladte tilpassede liste over cifre, der accepteres af SSL-forbindelsen, hvilket er en streng i samme format som i OpenSSL-cifre. Denne attribut bruges kun når ciphers feltet har værdien sutomsikkerhed.
newfarmname	String	Den nye gårds navn. Gården skal stoppes.
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste lytter.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter, skal denne IP konfigureres og op i systemet.

Svar eksempel:

{
   "description" : "Modify farm FarmHTTP",
   "params" : {
      "cipherc" : "TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*",
      "ciphers" : "customsecurity",
      "contimeout" : 22,
      "error414" : "Message error 414",
      "error500" : "Message error 500",
      "error501" : "Message error 501",
      "error503" : "Message error 503",
      "httpverb" : "standardHTTP",
      "listener" : "https",
      "newfarmname" : "FarmHTTP",
      "reqtimeout" : 32,
      "restimeout" : 47,
      "resurrectime" : 12,
      "rewritelocation" : "enabled",
      "vip" : "178.62.126.152",
      "vport" : 88
   }
}

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Tilføj et certifikat

Tilføj et certifikat

Forespørgselseksempel:

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

POST /farms/<farmname>/certificates

Inkluder et tilgængeligt PEM-certifikat på SNI-listen eller certlist array af en HTTP gård med en HTTPS lytter. Det anvendte certifikat skal allerede uploades i systemet, se Certifikater> Liste over alle certifikater for listen over tilgængelige certifikater.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
fil	String	certifikatfilnavn, tidligere skal certifikatet uploades i systemet.	sand

Svar eksempel:

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

Slet et certifikat

Slet et certifikat

Forespørgselseksempel:

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

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

Slet certifikatet med det valgte filnavn fra certlisten i HTTP-gården med HTTPS-lytteren. Certifikatet slettes ikke i certifikatbutikken.

Svar eksempel:

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

Tilføj en IPDS-regel

Tilføj en IPDS-regel

Forespørgselseksempel:

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

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

Anvend en sortliste eller DoS-regel til gården.

Anmod om parametre

Field	Type	Beskrivelse
navn	String	IPDS-reglenavn, der bruges som unik identifikator.

Svar eksempel:

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

Fjern en IPDS-regel

Fjern en IPDS-regel

Forespørgselseksempel:

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

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

Fjern en sortliste eller DoS-regel fra en given gård ved hjælp af dens idenficator navn.

Svar eksempel:

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

HTTP - Services

Tjenesterne inden for en HTTP-profilgård leverer en indholdskoblingsmetode til at levere flere webtjenester med forskellige egenskaber, backends eller endog persistensmetoder gennem nogle deterministiske betingelser, der anvendes af gårdkernen for at matche den korrekte service for hver klientanmodning. Denne service definition vil blive brugt af gården for at bestemme backends servere, der kunne levere svaret til klienten.

Inside serviceobjekt er der to slags værdier: service relateret og farmguardian relateret.

Farmguardian bruges til avanceret overvågningstilstand bagtil og er helt tilpasset til dine egne scripts til den aktuelle service. Når et problem opdages af farmguardian deaktiveres den reelle server automatisk og markeres som sortlistet.

For en komplet beskrivelse af Serviceobjekt i en HTTP-gård henvises til HTTP Farms> Hent gård ved navn> Table Services-objekt til HTTP-gårde

Opret en ny tjeneste

Opret en ny tjeneste

Forespørgselseksempel:

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

POST /farms/<farmname>/services

Opret en tjeneste i en given HTTP-profil Farm. Gården har brug for en genstart for at anvende denne ændring.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
id	String	Servicenavn, der bruges som unik identifikator. Kun alfanumeriske værdier er tilladt.	sand

Svar eksempel:

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

Ændre en tjeneste

Ændre en tjeneste

Forespørgselseksempel:

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

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

Ændre parametrene for en tjeneste i en HTTP-profil. id er tjenesten unikke identifikator, som vil blive ændret.

Anmod om parametre

Field	Type	Beskrivelse
vhost	String	Angiver tilstanden bestemt af domænenavnet via den samme virtuelle IP og port defineret af en HTTP-profil gård. PCRE regulære udtryk understøttes.
urlp	String	Giver mulighed for at bestemme en webtjeneste vedrørende den webadresse, som klienten anmoder om gennem et bestemt webadressemønster, som vil blive kontrolleret syntaktisk. PCRE regulære udtryk understøttes.
omdirigere	String	Det fungerer som en speciel backend, klientens anmodning besvares ved omdirigering til en ny webadresse automatisk.
redirecttype	String	Hvordan omdirigering vil ske, to muligheder: standard, er url taget som en absolut vært og vej til omdirigering til, append, vil den oprindelige forespørgselssti eller URI blive tilføjet til værten og stien, du har angivet i omdirigere Mark. Denne opførsel gælder kun hvis omdirigere er ikke en tom værdi.
cookieinsert	String	Det gør det muligt at indsætte cookie til backends klæbrig sessioner. Indstillingerne er sand, vil profilen søge efter den givne cookie i feltet cookiename, hvis den ikke findes, tilføjes denne cookie, falsk, indsætnings cookie er deaktiveret.
cookiename	String	Cookie-navnet (session-id) vil blive brugt til at identificere den klæbende proces til bagsiden. Aktiver cookieinsert Felt er påkrævet.
cookiedomain	String	Cookie insertion vil blive udført, hvis domæne matcher i cookie indholdet. Aktiver cookieinsert Felt er påkrævet.
cookiepath	String	Den administrerer cookiesti-værdien for den givne cookie, hvis URI i klientanmodningen eller backend-svaret ikke stemmer overens med cookiepath, anvendes ikke persistensmetoden til cookieindsættelse. Aktiver cookieinsert Felt er påkrævet.
cookiettl	nummer	Det er den maksimale levetid for en cookie i sekunder. Aktiver cookieinsert Felt er påkrævet.
udholdenhed	String	Denne parameter definerer, hvordan HTTP-tjenesten skal klare klientsessionen. Indstillingerne er: "" tom streng, ingen handling er taget, IP persistenssessionen udføres i bunden af klientens IP, GRUNDLÆGGENDE Persistenssessionen udføres i bunden af BASIC headers, URL persistenssessionen udføres i basis af et felt i URI'en, PARM vedholdenhedssessionen udføres i basis af en værdi adskilt af “;” i slutningen af URI, COOKIE Persistenssessionen udføres i bunden af et cookie navn, denne cookie skal oprettes af bagsiden og HEADER, er persistenssessionen udført i bunden af et overskriftsnavn.
ttl	nummer	Kun med vedholdenhed. Den maksimale levetid for en inaktiv klientsession (maks. Sessionsalder) i sekunder.
Sessions ID	String	Det er tilgængeligt, hvis udholdenhed feltet er URL, COOKIE or HEADER, vil parameterværdien blive søgt af profilen i http-headeren og vil klare klientsessionen.
leastresp	String	Det muliggør den mindst responderende balance metode. sand, selv om profilen kontrollerer hvilken backend der tager mindre tid til at reagere for at sende flere forbindelser til dette, falsk, profil kontrollerer ikke, hvilken backend der tager kortere tid at svare.
httpsb	String	Det angiver til gården, at backends-serverne defineret i den aktuelle tjeneste bruger HTTPS-sproget, og derefter bliver dataene krypteret før at blive sendt. sand, sender profilen trafikken i HTTPS-protokollen til bagsiden, falsk, sender profilen trafikken i HTTP-protokollen til bagsiden.

Svar eksempel:

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

Response Parametre

Svaret vil være en json med ønskede parametre opdateret og status felt med nødvendige genstart værdi. Genstart handling skal tages for at kunne anvende ændringerne.

Ændr bedriftsmægler

Ændr bedriftsmægler

Forespørgselseksempel:

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

PUT /farms/<farmname>/fg

Ændre parametrene for bedriftsmagten i den givne HTTP-profil.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
fgtimecheck	nummer	Gårdens værge vil kontrollere backends sundhedsstatus hvert 'timetocheck'-sekund.
fgscript	String	Kommandoen, som gårdhavevogter vil køre for at kontrollere backends sundhedstilstand
fgenabled	String	Det gør det muligt for værge i den angivne tjeneste. sand gårdsholder skal bruges til kontrol af backends status, falsk gårdsholder bliver deaktiveret
fglog	String	Aktiver brugen af logfiler i gården. sand gårdsholder skal logge enhver handling, falsk gårdsbeskytter ikke logge nogen handling, anbefales det at aktivere fglog kun til fejlfinding.
tjeneste	String	Servicenavn, der bruges som unik identifikator.	sand

Svar eksempel:

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

Flyt tjenester

Flyt tjenester

Forespørgselseksempel:

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

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

Disse handlinger flytter den givne tjeneste op eller ned i servicelisten. Denne mulighed er nyttig, hvis det er nødvendigt at ændre prioriteringsordren, bemærk at tjenester evalueres i samme rækkefølge, som vises. Denne handling genstarter gården automatisk.

id er tjenesten unikke identifikator, som vil blive ændret.

Forespørgselsparametre

Field	Type	Beskrivelse	påkrævet
position	nummer	Placering hvor vil være tjenesten. Første position har indekset 0.	sand

Svar eksempel:

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

Slet en tjeneste

Slet en tjeneste

Forespørgselseksempel:

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

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

Slet en given tjeneste for en http-profil. id er tjenesten unikke identifikator, som vil blive slettet.

Svar eksempel:

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

HTTP - Services - Backends

Angiv backends

Angiv backends

Forespørgselseksempel:

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

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

Få listen over backends i en tjeneste. id er tjenesten unikke identifikator.

Svar eksempel:

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

Response Parametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse
id	nummer	unikke identifikator for backend i tjenesten. Denne identifikator genereres af systemet.
ip	String	Backends IP, hvor den rigtige tjeneste lytter.
port	nummer	Backends havn, hvor den rigtige tjeneste lytter.
timeout	nummer	Det er backend-timeouten at svare på en bestemt anmodning om sekunder.
vægt	nummer	Det er vægtværdien for den aktuelle backend.
status	String	Backend status. Værdien kan være: up backend er klar til at modtage forbindelser, vedligeholdelse backend er markeret som ikke klar til modtagelse af forbindelser, denne mulighed er nyttig til backend's vedligeholdelsesopgaver.

Opret en ny backend

Opret en ny backend

Forespørgselseksempel:

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

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

Opret en ny backend i en given HTTP-profil. id er tjenesten unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	Backends IP, hvor den rigtige tjeneste lytter.	sand
port	nummer	Backends havn, hvor den rigtige tjeneste lytter.	sand
timeout	nummer	Det er backend timeout at svare på en bestemt anmodning.
vægt	nummer	Det er vægtværdien for den aktuelle backend.

Svar eksempel:

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

Response Parametre

Svaret vil være en json med ønskede parametre opdateret og status felt med nødvendige genstart værdi, hvis bedriften skal genstartes. Genstart handling skal tages for at kunne anvende ændringerne.

Rediger en backend

Rediger en backend

Forespørgselseksempel:

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

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

Ændre parametrene for en backend i en tjeneste af en HTTP-profil.

Fornavn id er tjenesten unikke identifikator, næste id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	Backends IP, hvor den rigtige tjeneste lytter.
port	nummer	Backends havn, hvor den rigtige tjeneste lytter.
timeout	nummer	Det er backend-timeouten at svare på en bestemt anmodning om sekunder.
vægt	nummer	Det er vægtværdien for den aktuelle backend.

Svar eksempel:

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

Response Parametre

Backend i vedligeholdelse

Backend i vedligeholdelse

Forespørgselseksempel:

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

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

Indstil en given handling i en backend på en HTTP-gård, beskrives tilgængelige handlinger nedenfor.

Fornavn id er tjenesten unikke identifikator, næste id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	Indstil den ønskede handling. Handlingerne er: up backend er klar til at modtage klientanmodninger, vedligeholdelse backend er ikke klar til at modtage klientanmodninger. Denne handling er nyttig til at stoppe backend-serveren uden at påvirke klienterne.

Svar eksempel:

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

Slet en backend

Slet en backend

Forespørgselseksempel:

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

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

Slet en given backend i en tjeneste af en HTTP-profil.

Fornavn id er tjenesten unikke identifikator, næste id er backend unikke identifikator.

Svar eksempel:

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

L4xNAT Farms

L4xNAT profil gården giver mulighed for at oprette en L4 gård med en meget høj ydeevne og langt mere samtidige forbindelser end load balancer kerner i lag 7 som HTTP gårdsprofiler. Det forbedrede lag 4-forbedring modvirker den avancerede indholdshåndtering, som lag 7-profiler kunne klare.

Derudover kunne L4xNAT gårde binde en række porte, ikke kun en virtuel port, som bruges sammen med andre lag 7 profiler. For at kunne vælge en række virtuelle porte eller en bestemt virtuel port i L4xNAT gårde, er det obligatorisk at vælge en protokol type. I andre tilfælde vil gården lytte på alle havne fra den virtuelle IP (angivet med et tegn ''). Når en TCP- eller UDP-protokol er valgt, vil den være tilgængelig for at angive en port, flere porte mellem ',' porte spænder mellem ':' eller alle porte med ''. En kombination af dem alle vil også være gyldig.

Hent gården ved navn

Hent gården ved navn

Forespørgselseksempel:

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

GET /farms/<farmname>

Vis alle konfigurationer om en given gård.

Response Body:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående format.

Farm Object:

Field	Type	Beskrivelse
IPDS	Object	Liste over IPDS regler anvendt på denne gård.
params	Object	Parametre for gårdskonfiguration.
backends	Objekt[]	Alle rigtige servere skabt i denne gård og dens konfiguration.

IPDS-objekt:

Field	Type	Beskrivelse
sortlister	Snor[]	Sorte listeregler anvendes på gården.
dos	Snor[]	DoS regler gælder for gården.

Parametre objekt for L4xNAT gårde:

Field	Type	Beskrivelse
algoritme	String	Type lastbalanceringsalgoritme anvendt i gården. Indstillingerne er: leastconn forbindelse altid til den mindst forbindelses server, vægt forbindelse lineær forsendelse efter vægt, Prio forbindelser altid til den mest tilgængelige prio.
lytter	String	En lytter definerer, hvordan gården skal lege med anmodningerne fra klienterne. informationsfelt, kan det ikke ændres.
nattype	String	Hvordan belastningsbalancelaget 4-kernen skal fungere. Indstillingerne er: NAT også kaldet sNAT-tilstand, svarer bagenden til belastningsbalanceren for at sende svaret til klienten, DNAT backend vil reagere direkte på klienten, load balancer skal konfigureres som gateway i backend serveren.
udholdenhed	String	Den samme ip-adresse vil blive forbundet til den samme server. Indstillingerne er: "" tom værdi, persistens er deaktiveret, ip Persistens er aktiveret gennem, oprindelse IP bruges som unik ID i session.
protokol	String	Protokol skal afbalanceres ved lag 4. Indstillingerne er: alle profilen vil indlæse balance enhver L4-protokol, tcp belastningsbalanceren vil kun afbalancere TCP L4-protokollen, uDP belastningsbalanceren vil kun balancere UDP L4-protokollen, tår belastningsbalanceren vil kun balancere SIP- eller VoIP L7-protokollen, ftp belastningsbalanceren vil kun balancere FTP L7-protokollen, tftp belastningsbalanceren vil kun balancere TFTP L7-protokollen.
status	String	Farm status. De mulige værdier er: up gården løber og fanger trafik, ned gården er nede og ikke fanger nogen trafik.
ttl	nummer	Denne feltværdi angiver det antal sekunder, som persistensen mellem klientkilden og bagenden tildeles, i sekunder. Persistens skal konfigureres.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	String	Havnen på gården, hvor den virtuelle tjeneste lytter. En unik port kan specificeres, en rækkeport kan specificeres med separator : og flere porte kan specificeres med separator ,.
fgenabled	String	Gør det muligt at bruge husmor. sand farm guard er aktiveret, falsk gårdsbeskytter er deaktiveret.
fglog	String	Gør det muligt at anvende logfiler i gården. fgenabled skal være aktiveret.
fgscript	String	Kommandoen, som gårdsholderen vil kontrollere. De tilgængelige kommandoer findes i libexec-stien. fgenabled skal være aktiveret.
fgtimecheck	nummer	Gårdens værge kontrollerer hvert 'timetocheck'-sekund. fgenabled skal være aktiveret.

Backend objekt til L4xNAT gårde:

Field	Type	Beskrivelse
id	nummer	ID for at identificere backend i gården.
ip	String	Backends IP, hvor den rigtige tjeneste lytter.
port	nummer	Backends havn, hvor den rigtige tjeneste lytter. Tom værdi accepteres, og den bruger den samme konfiguration end virtuel port (er).
status	String	Backend status. Værdien kan være: up backend er klar til at modtage forbindelser, vedligeholdelse backend er ikke klar til at modtage forbindelser.
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Forbindelser er altid til den mest tilgængelige prio, hvor 1 er mest prioriteret.
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server. Backends med mere vægt får flere forbindelser.

Opret en ny gård

Opret en ny gård

Forespørgselseksempel:

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

POST /farms

Opret en ny L4xNAT gård.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
farmname	String	Landbrugsnavn, entydigt identifikator.	sand
profil	String	Profilen til den oprettede Farm. For L4xNAT gårde er l4xnat, informationsbesked, kan denne værdi ikke ændres	sand
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.	sand
VPort	String	Havnen på gården, hvor den virtuelle tjeneste lytter. L4xNAT gårde tillader multiport adskilt af , eller interval port adskilt af :.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en gård

Ændre en gård

Forespørgselseksempel:

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

PUT /farms/<farmname>

Rediger konfigurationen af en L4xNAT gård.

Anmod om parametre

Field	Type	Beskrivelse
newfarmname	String	Den nye gårds navn. Gården skal stoppes.
algoritme	String	Type lastbalanceringsalgoritme anvendt i gården. Indstillingerne er: leastconn forbindelse altid til den mindst forbindelses server, vægt forbindelse lineær forsendelse efter vægt, Prio forbindelser altid til den mest tilgængelige prio.
lytter	String	En lytter definerer, hvordan gården skal lege med anmodningerne fra klienterne. informationsfelt, kan det ikke ændres.
nattype	String	Hvordan belastningsbalancelaget 4-kernen skal fungere. Indstillingerne er: NAT også kaldet sNAT-tilstand, svarer bagenden til belastningsbalanceren for at sende svaret til klienten, DNAT backend vil reagere direkte på klienten, load balancer skal konfigureres som gateway i backend serveren.
udholdenhed	String	Den samme ip-adresse vil blive forbundet til den samme server. Indstillingerne er: "" tom værdi, persistens er deaktiveret, ip Persistens er aktiveret gennem, oprindelse IP bruges som unik ID i session.
protokol	String	Protokol skal afbalanceres ved lag 4. Indstillingerne er: alle profilen vil indlæse balance enhver L4-protokol, tcp belastningsbalanceren vil kun afbalancere TCP L4-protokollen, uDP belastningsbalanceren vil kun balancere UDP L4-protokollen, tår belastningsbalanceren vil kun balancere SIP- eller VoIP L7-protokollen, ftp belastningsbalanceren vil kun balancere FTP L7-protokollen, tftp belastningsbalanceren vil kun balancere TFTP L7-protokollen.
ttl	nummer	Denne feltværdi angiver det antal sekunder, som persistensen mellem klientkilden og bagenden tildeles, i sekunder. Persistens skal konfigureres.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	String	Havnen på gården, hvor den virtuelle tjeneste lytter. En unik port kan specificeres, en rækkeport kan specificeres med separator : og flere porte kan specificeres med separator ,.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændr bedriftsmægler

Ændr bedriftsmægler

Forespørgselseksempel:

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

PUT /farms/<farmname>/fg

Ændre parametrene for gårdens værge i en L4xNAT-tjeneste.

Anmod om parametre

Field	Type	Beskrivelse
fgenabled	String	Gør det muligt at bruge husmor. sand farm guard er aktiveret, falsk gårdsbeskytter er deaktiveret.
fglog	String	Gør det muligt at anvende logfiler i gården. fgenabled skal være aktiveret.
fgscript	String	Kommandoen, som gårdsholderen vil kontrollere. De tilgængelige kommandoer findes i libexec-stien. fgenabled skal være aktiveret.
fgtimecheck	nummer	Gårdens værge kontrollerer hvert 'timetocheck'-sekund. fgenabled skal være aktiveret.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Tilføj en IPDS-regel

Tilføj en IPDS-regel

Forespørgselseksempel:

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

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

Anvend en sortliste eller DoS-regel til en gård.

Anmod om parametre

Field	Type	Beskrivelse
navn	String	IPDS-reglenavn, der bruges som unik identifikator.

Svar eksempel:

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

Fjern en IPDS-regel

Fjern en IPDS-regel

Forespørgselseksempel:

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

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

Fjern en sortliste eller DoS-regel af IPDS-modul fra en given gård ved hjælp af dens idenficator navn.

Svar eksempel:

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

L4xNAT - Backends

Angiv backends

Angiv backends

Forespørgselseksempel:

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

GET /farms/<farmname>/backends

Få listen over backends i en tjeneste.

Svar eksempel:

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

Response Parametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse
id	nummer	ID for at identificere backend i gården.
ip	String	Backends IP, hvor den rigtige tjeneste lytter.
port	nummer	Backends havn, hvor den rigtige tjeneste lytter. Tom værdi accepteres, og den bruger den samme konfiguration end virtuel port (er).
status	String	Backend status. Værdien kan være: up backend er klar til at modtage forbindelser, vedligeholdelse backend er ikke klar til at modtage forbindelser.
max_conns	nummer	Det er det maksimale antal samtidige forbindelse til backend. Hvis dette felt har værdien 0, har backend ikke konfigureret nogen forbindelsesgrænse.
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Forbindelser er altid til den mest tilgængelige prio, hvor 1 er mest prioriteret.
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server. Backends med mere vægt får flere forbindelser.

Opret en ny backend

Opret en ny backend

Forespørgselseksempel:

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

POST /farms/<farmname>/backends

Opret en ny backend i en given L4xNAT Farm.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	Backends IP, hvor den rigtige tjeneste lytter.	sand
port	nummer	Backends havn, hvor den rigtige tjeneste lytter. Tom værdi accepteres, og den bruger den samme konfiguration end virtuel port (er).
max_conns	nummer	Det er det maksimale antal samtidige forbindelse til backend. Hvis dette felt har værdien 0, har backend ikke konfigureret nogen forbindelsesgrænse.
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Forbindelser er altid til den mest tilgængelige prio, hvor 1 er mest prioriteret. Standardværdien er 1.
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server. Backends med mere vægt får flere forbindelser. Standardværdien er 1.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger en backend

Rediger en backend

Forespørgselseksempel:

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

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

Ændre parametrene for en backend i en tjeneste af en L4xNAT Farm. id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	Backends IP, hvor den rigtige tjeneste lytter.
port	nummer	Backends havn, hvor den rigtige tjeneste lytter. Tom værdi accepteres, og den bruger den samme konfiguration end virtuel port (er).
max_conns	nummer	Det er det maksimale antal samtidige forbindelse til backend. Hvis dette felt har værdien 0, har backend ikke konfigureret nogen forbindelsesgrænse.
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Forbindelser er altid til den mest tilgængelige prio, hvor 1 er mest prioriteret.
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server. Backends med mere vægt får flere forbindelser.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Backend i vedligeholdelse

Backend i vedligeholdelse

Forespørgselseksempel:

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

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

Indstil en given handling i en backend på en L4xNAT gård. id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	Indstil den ønskede handling. Handlingerne er: up backend er klar til at modtage klientanmodninger, vedligeholdelse backend er ikke klar til at modtage klientanmodninger. Denne handling er nyttig til at stoppe backend-serveren uden at påvirke klienterne.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en backend

Slet en backend

Forespørgselseksempel:

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

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

Slet en given backend i en tjeneste af en L4xNAT Farm.

id er backend unikke identifikator.

Svar eksempel:

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

GSLB Farms

Den globale servicebelastningsbalancering, der almindeligvis hedder GSLB, gør det muligt at oprette en belastningsbalanceringstjeneste baseret på DNS-servicehierarkisk arkitektur. Denne slags gård giver en autoritativ eneste DNS med belastningsbalanceringsalgoritmer og servicetilstandsdetektering ved DNS-applikationslag.

Hent gården ved navn

Hent gården ved navn

Forespørgselseksempel:

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

GET /farms/<farmname>

Vis alle konfigurationer om en given gård.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående format.

Farm Object:

Field	Type	Beskrivelse
IPDS	Object	Liste over IPDS regler anvendt på denne gård.
params	Object	Parametre for gårdskonfiguration.
tjenester	Objekt[]	Array med alle tjenester skabt i denne gård og dens konfiguration.
zoner	Objekt[]	Array med alle zoner oprettet i denne gård og dens konfiguration.

IPDS-objekt:

Field	Type	Beskrivelse
sortlister	Snor[]	Sorte lister anvendes til gården.
dos	Snor[]	DoS regler gælder for gården.

Parameter objekt for GSLB gårde:

Field	Type	Beskrivelse
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste lytter.
status	String	Farm status. De mulige værdier er: upgården går; ned, gården er stoppet eller nødvendige genstart, gården skal genstartes for at de seneste ændringer kan træde i kraft.

Serviceobjekt for GSLB gårde:

Field	Type	Beskrivelse
backends	Objekt[]	Backends defineret i tjenesten.
fgenabled	String	Aktivér brug af værge. sand Farm Guardian er aktiveret og kontrollerer backends status, falsk gårdsholderen er deaktiveret og kontrollerer ikke backends status. I GSLB-profiler udføres en tcp-check som standard, selvom værger er deaktiveret.
fgscript	String	Kommandoen, som gårdsholderen vil bruge til at kontrollere ryggenes sundhed. sand aktiveret, falsk, handicappet. fgenabled er nødvendigt.
fgtimecheck	nummer	Gårdens værge vil kontrollere hvert 'timetocheck' sekund af backendens sundhedsstatus. fgenabled er nødvendigt.
id	String	Servicenavn, der bruges som unik identifikator.
algoritme	String	Type belastningsbalanceringsalgoritme anvendt i tjenesten. Indstillingerne er: runde Robin, som vil afbalancere forbindelser mellem alle backends, eller Prio som sender alle forbindelser til den første tilgængelige backend.
deftcpport	nummer	Standard TCP port sundhedskontrol. Dette er den sundhedskontrol TCP-port, som tjenesten skal kontrollere for at bestemme, at backend-tjenesten lever. En tom værdi er deaktiveret.

Backend objekt til GSLB gårde:

Field	Type	Beskrivelse
id	nummer	Unik identifikator for backend i tjenesten. Denne identifikator genereres af systemet.
ip	String	Backends IP, hvor den rigtige tjeneste lytter.

Zone objekt:

Field	Type	Beskrivelse
id	nummer	Zones navn bruges som en unik detektor.
defnamesv	String	Dette vil være startpunktets rodnavneserver, der vil være tilgængelig som DNS-posten Start of Authority (SOA).
ressourcer	Objekt[]	Ressourcer defineret i zonen.

Ressource objekt:

Field	Type	Beskrivelse
id	nummer	Unik identifikator for ressourcen i zonen.
rname	String	Resource-navnet er det nick, som DNS-tjenesten oversætter til de rigtige data i feltet rdata.
ttl	nummer	Den tid til live (valgfri) værdi for den aktuelle post, som det er nødvendigt for at bestemme hvor lang tid det aktuelle navn vil blive cachelagret.
typen	String	DNS-posttype. Indstillingerne er: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). For mere information, se på GSLB - Zones - Ressourcer sektion.
rdata	String	Det er de rigtige data, der kræves af posttypen, inputværdien afhænger af typen af ressourcenavn, rname og ressourcetypen, typen.

Opret en ny gård

Opret en ny gård

Forespørgselseksempel:

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

POST /farms

Opret en ny GSLB gård.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
farmname	String	Farmens navn, unikke identifikator for gården.	sand
profil	String	Profilen til den oprettede Farm. For GSLB gårde er GSLB.	sand
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.	sand
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste lytter.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en gård

Ændre en gård

Forespørgselseksempel:

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

PUT /farms/<farmname>

Rediger konfigurationen af en GSLB farm.

Anmod om parametre

Field	Type	Beskrivelse
newfarmname	String	Den nye gårds navn. Gården skal stoppes for at udføre denne ændring.
VPort	nummer	Havnen på gården, hvor den virtuelle tjeneste lytter.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Tilføj en IPDS-regel

Tilføj en IPDS-regel

Forespørgselseksempel:

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

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

Anvend en sortliste eller DoS-regel til gården.

Anmod om parametre

Field	Type	Beskrivelse
navn	String	IPDS-reglenavn, der bruges som unik identifikator.

Svar eksempel:

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

Fjern en IPDS-regel

Fjern en IPDS-regel

Forespørgselseksempel:

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

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

Fjern en sortliste eller DoS-regel fra en given gård ved hjælp af dens idenficator navn.

Svar eksempel:

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

GSLB - Services

En GSLB-tjeneste repræsenterer en gruppe af ægte servere og en tilknyttet algoritme, der skal bruges til dem. For at oprette en ny tjeneste skal du angive et gyldigt identifikationsnavn og den ønskede algoritme, der skal bruges.

De tilgængelige tjenester er:

Round Robin: lige deling. En lige ligevægt i trafikken til alle aktive reelle servere. For hver indkommende forbindelse tildeler balanceren den næste runde robins ægte server for at levere anmodningen.

Prioritet: Tilslutninger altid til den mest tilgængelige prio. Afbalancere alle forbindelser til samme højeste prioritetsserver. Hvis denne server er nede, skifter forbindelserne til næste højeste server. Med denne algoritme kan du opbygge en Active-Pasive Cluster-tjeneste med flere rigtige servere.

Services genstand for GSLB gårde

Field	Type	Beskrivelse
backends	Objekt[]	Backends defineret i tjenesten.
fgenabled	String	Aktivér brug af værge. sand Farm Guardian er aktiveret og kontrollerer backends status, falsk gårdsholderen er deaktiveret og kontrollerer ikke backends status. I GSLB-profiler udføres en tcp-check som standard, selvom værger er deaktiveret.
fgscript	String	Kommandoen, som gårdsholderen vil bruge til at kontrollere ryggenes sundhed. sand aktiveret, falsk, handicappet. fgenabled er nødvendigt.
fgtimecheck	nummer	Gårdens værge vil kontrollere hver 'timetocheck' sekunder af backendens sundhedsstatus. fgenabled er nødvendigt.
id	String	Servicenavn, der bruges som unik identifikator.
algoritme	String	Type belastningsbalanceringsalgoritme anvendt i tjenesten. Indstillingerne er: runde Robin, som vil afbalancere forbindelser mellem alle backends, eller Prio som sender alle forbindelser til den første tilgængelige backend.
deftcpport	String	Standard TCP port sundhedskontrol. Dette er den sundhedskontrol TCP-port, som tjenesten skal kontrollere for at bestemme, at backend-tjenesten lever. En tom værdi er deaktiveret.

Opret en ny tjeneste

Opret en ny tjeneste

Forespørgselseksempel:

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

POST /farms/<farmname>/services

Opret en tjeneste i en given GSLB Farm. Gården skal genstartes for at anvende denne ændring.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
id	String	Servicenavn, der bruges som unik identifikator.	sand
algoritme	String	Type belastningsbalanceringsalgoritme anvendt i tjenesten. Indstillingerne er: runde Robin, som vil afbalancere forbindelser mellem alle backends, eller Prio som sender alle forbindelser til den første tilgængelige backend.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en tjeneste

Ændre en tjeneste

Forespørgselseksempel:

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

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

Ændre parametrene for en tjeneste i en GSLB Farm. id er tjenesten unikke identifikator, som vil blive ændret.

Anmod om parametre

Field	Type	Beskrivelse
deftcpport	nummer	Dette er den sundhedskontrol TCP-port, som tjenesten skal kontrollere for at bestemme, at backend-tjenesten lever.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændr bedriftsmægler

Ændr bedriftsmægler

Forespørgselseksempel:

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

PUT /farms/<farmname>/fg

Ændre parametrene for gårdens værge i en GSLB-tjeneste.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
fgenabled	String	Aktivér brug af værge. sand Farm Guardian er aktiveret og kontrollerer backends status, falsk gårdsholderen er deaktiveret og kontrollerer ikke backends status. I GSLB-profiler udføres en tcp-check som standard, selvom fgenabled er deaktiveret.
fgscript	String	Kommandoen, som gårdsholderen vil bruge til at kontrollere ryggenes sundhed. sand aktiveret, falsk, handicappet.	sandt hvis fgenabled er aktiveret.
fgtimecheck	nummer	Gårdens værge vil kontrollere hver 'timetocheck' sekunder af backendens sundhedsstatus. fgenabled er nødvendigt.
tjeneste	String	Tjenesteidentifikatoren, id, hvilken farm vogter vil ændre.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en tjeneste

Slet en tjeneste

Forespørgselseksempel:

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

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

Slet en given tjeneste hos en GSLB Farm. id er tjenesten unikke identifikator, som vil blive slettet.

Svar eksempel:

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

GSLB - Services - Backends

Dette afsnit styrer den reelle service liste, der er knyttet til en tjeneste.

Angiv backends

Angiv backends

Forespørgselseksempel:

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

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

Få listen over backends i en tjeneste. id er tjenesten unikke identifikator.

Svar eksempel:

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

Response Parametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse
id	nummer	Unik identifikator for backend i tjenesten. Denne identifikator genereres af systemet.
ip	String	IP af backend, hvor den rigtige tjeneste lytter.

Opret en ny backend

Opret en ny backend

Forespørgselseksempel:

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

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

Opret en ny backend i en given tjeneste i en GSLB Farm. id er tjenesten unikke identifikator, hvor backend vil blive tilføjet.

De prioriterede tjenester har 2 backends som maximun, den aktive vært og den passive vært.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	IP af backend, hvor den rigtige tjeneste lytter.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger en backend

Rediger en backend

Forespørgselseksempel:

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

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

Ændre parametrene for en backend i en tjeneste af en GSLB Farm.

Bemærk i PUT over det første id er tjenesten unikke identifikator og næste id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP af backend, hvor den rigtige tjeneste lytter.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en backend

Slet en backend

Forespørgselseksempel:

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

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

Slet en given backend i en tjeneste af en GSLB Farm

Svar eksempel:

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

GSLB - Zones

GSLB-sektionsafsnittet beskriver DNS-domænenavnet, underdomænerne, aliaserne osv., Som skal bruges til at generere en komplet DNS-zone med yderligere belastningsbalanceringsoptegnelser ved hjælp af de definerede tjenester.

Opret zone

Opret zone

Forespørgselseksempel:

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

POST /farms/<farmname>/zones

Opret en DNS-zone.

Forespørgselsparametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse	påkrævet
id	nummer	Zones navn bruges som en unik detektor.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en zone

Ændre en zone

Forespørgselseksempel:

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

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

Ændre parametrene i en zone. id er zonen unikke identifikator, som vil blive ændret.

Forespørgselsparametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse
defnamesv	String	Dette vil være startpunktets rodnavneserver, der vil være tilgængelig som DNS-posten Start of Authority (SOA).

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en zone

Slet en zone

Forespørgselseksempel:

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

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

Slet en given zone i en GSLB Farm.

Svar eksempel:

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

GSLB - Zones - Ressourcer

Ressourcer defineret som DNS-tjenesten løser anmodninger. De mulige DNS-ressourcer i Zevenet lastbalancer er:

NS. Navn Server type rekord, det delegerer en DNS-zone til at bruge de givne autoritative navneservere.
A. Adressetype-rekord, det returnerer en IPv4-adresse til en vært.
CNAME. Kanonisk navn type rekord, det repræsenterer et alias af et givet navn.
DYNA. Dynamisk adressetype rekord, returnerer den en dynamisk adresse angivet af en GSLB-tjeneste, der allerede er oprettet inden for gårdskonfigurationen ifølge algoritmen valgt til en sådan tjeneste.
AAAA. Adressetype-rekord, det returnerer en IPv6-adresse til en vært.
MX. Mail udveksling typepost, kort et domænenavn til en liste over meddelelsesoverførselsagenter for det pågældende domæne.
SRV. Service locator type rekord, Generalized service location record, der bruges til nyere protokoller i stedet for at oprette protokollespecifikke poster som MX.
TXT. Tekst type rekord, den bruges til at gemme tekstbaseret information, der kan tages, når det er nødvendigt. Vi ser sædvanligvis TXT-poster, der bruges til at holde SPF-data og verificere domæneejerskab.
PTR. Pointer record, peger på et kanonisk navn. I modsætning til en CNAME stopper DNS-behandling, og kun navnet returneres. Den mest almindelige anvendelse er at implementere reverse DNS opslag.
NAPTR. Navngivningsautoritetspeger, Tillader regelmæssig ekspressionbaseret omskrivning af domænenavne, som derefter kan bruges som URI'er, yderligere domænenavne til opslag osv.

Liste over ressourcerne

Liste over ressourcerne

Forespørgselseksempel:

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

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

Få listen over ressourcer i en zone. id er zonen unikke identifikator.

Svar eksempel:

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

Response Parametre

Dette opkald returnerer et ressourceobjekt array med bellow parametrene.

Field	Type	Beskrivelse
id	nummer	Unik identifikator for ressourcen i zonen.
rname	String	Resource-navnet er det nick, som DNS-tjenesten oversætter til de rigtige data i feltet rdata.
ttl	nummer	Den tid til live (valgfri) værdi for den aktuelle post, som det er nødvendigt for at bestemme hvor lang tid det aktuelle navn vil blive cachelagret.
typen	String	DNS-posttype. Indstillingerne er: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). For mere information, se på GSLB - Zones - Ressourcer sektion.
rdata	String	Det er de rigtige data, der kræves af posttypen, inputværdien afhænger af typen af ressourcenavn, rname og ressourcetypen, typen.

Opret en ny ressource

Opret en ny ressource

Forespørgselseksempel:

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

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

Opret en ny ressource i en given zone i en GSLB Farm. id er zonen unikke identifikator som vil blive ændret, hvor ressourcen vil blive tilføjet.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
rname	String	Resource-navnet er det nick, som DNS-tjenesten oversætter til de rigtige data i feltet rdata.	sand
ttl	nummer	Time to Live-værdien for den aktuelle post. Det er maksimalt antal router enheder, som anmodningen kan gennem til dø. Det er nyttigt at pakken ikke indtaster i en netløkke.
typen	String	DNS-posttype. Indstillingerne er: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). For mere information, se på GSLB - Zones - Ressourcer sektion.	sand
rdata	String	Det er de rigtige data, der kræves af posttypen, inputværdien afhænger af typen af ressourcenavn, rname og ressourcetypen, typen. hvis DYNA er valgt i typen så skal rdata-værdien være en af de konfigurerede tjenester i denne zone.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger en ressource

Rediger en ressource

Forespørgselseksempel:

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

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

Ændre parametrene for en resouce i en zone af en GSLB Farm.

Fornavn id er zonen unikke identifikator, næste id er ressourcens unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
rname	String	Resource-navnet er det nick, som DNS-tjenesten oversætter til de rigtige data i feltet rdata.
ttl	nummer	Den tid til live (valgfri) værdi for den aktuelle post, som det er nødvendigt for at bestemme hvor lang tid det aktuelle navn vil blive cachelagret.
typen	String	DNS-posttype. Indstillingerne er: NS, A, AAAA, CNAME, DYNA, MX, SRV, TXT, PTR or NAPTR). For mere information, se på GSLB - Zones - Ressourcer sektion.
rdata	String	Det er de rigtige data, der kræves af posttypen, inputværdien afhænger af typen af ressourcenavn, rname og ressourcetypen, typen. hvis typen er indlæst med værdi DYNA derefter rdata skal læses med en tilgængelig tjeneste navn

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en ressource

Slet en ressource

Forespørgselseksempel:

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

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

Slet et bestemt resouce i en zone af en GSLB Farm

Bemærk at i DELETE URI over den første id er zonen unikke identifikator og næste id er ressourcens unikke identifikator.

Svar eksempel:

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

Datalink Farms

Datalink gårdsprofilen gør det muligt at oprette en ruter baseret gård, hvor backends er uplink routere eller gateways. Denne slags gårdsprofil er klar til at dele flere uplink WAN router-adganger ved hjælp af belastningsbalanceren som en uplink-kanalmultiplexor (1-indgang og flere routerlinjeudgange). Datalink gårdene kunne derfor bruges som høje tilgængelige kommunikationsforbindelser og kunne desuden bruges som båndbreddeforøgelse, der forbinder mængden af båndbredde mellem routers backends links.

Hent gården ved navn

Hent gården ved navn

Forespørgselseksempel:

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

GET /farms/<farmname>

Vis alle konfigurationer om en gård.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående format.

Farm Object:

Field	Type	Beskrivelse
params	Object	Parametre for gårdskonfiguration.
backends	Objekt[]	Reelle servere skabt i denne gård og dens konfiguration.

Parametre genstand for datalink gårde:

Field	Type	Beskrivelse
algoritme	String	Type lastbalanceringsalgoritme anvendt i gården. Indstillingerne er: vægt, balanceren fordeler blandt alle tilgængelige backends givet mere charge backends med højere vægt attribut eller Prio, som sender alle forbindelser til backend med den mindre værdi af prioritet.
status	String	Farm status. De mulige værdier er: up, gården kører, eller ned, gården er stoppet.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.

Backend objekt for datalink gårde:

Field	Type	Beskrivelse
id	nummer	Unik identifikator til backend på gården.
ip	String	IP af backend, hvor den rigtige tjeneste lytter.
grænseflade	String	Det er den lokale netværksinterface, hvor backend er forbundet.
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Det vil blive brugt, når algoritme feltet er konfiguration som prio og lavere prioritet vil have præference
vægt	nummer	Det er vægtværdien for den aktuelle virkelige server. Det vil blive brugt når algoritme feltet er konfigureret som vægt.

Opret en ny gård

Opret en ny gård

Forespørgselseksempel:

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

POST /farms

Opret en ny datalink gård.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
farmname	String	Landbrugsnavn, entydigt identifikator.	sand
profil	String	Profilen til den oprettede Farm. For datalink gårde er data link	sand
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre en gård

Ændre en gård

Forespørgselseksempel:

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

PUT /farms/<farmname>

Rediger konfigurationen af en datalink gård.

Anmod om parametre

Field	Type	Beskrivelse
newfarmname	String	Det nye landbrugsnavn. Gården skal stoppes.
algoritme	String	Type lastbalanceringsalgoritme anvendt i gården. Indstillingerne er: vægt, balanceren fordeler blandt alle tilgængelige backends givet mere charge backends med højere vægt attribut eller Prio, som sender alle forbindelser til backend med den mindre værdi af prioritet.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Datalink - Backends

Backends i datalink gårde er gateways gennem routing tjenesten. Tjenesten vil multiplexere blandt disse gateways, og nogle af dem er ikke tilgængelige, tjenesten bruger de andre (e).

Angiv backends

Angiv backends

Forespørgselseksempel:

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

GET /farms/<farmname>/backends

Få listen over backends i en tjeneste.

Svar eksempel:

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

Response Parametre

Dette opkald returnerer et backend-objekt array med bellow parametrene.

Field	Type	Beskrivelse
id	nummer	Unik identifikator til backend på gården. Denne identifikator genereres af systemet.
grænseflade	String	Det er den lokale netværksinterface, hvor backend er forbundet.
ip	String	IP af backend, hvor den rigtige tjeneste lytter.
prioritet	nummer	Det er den prioriterede værdi for den nuværende backend. Det vil blive brugt, når algoritme feltet er konfiguration som prio og lavere prioritet vil have præference.
vægt	nummer	Det er vægtværdien for den aktuelle backend. Det vil blive brugt når algoritme feltet er konfigureret som vægt.

Opret en ny backend

Opret en ny backend

Forespørgselseksempel:

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

POST /farms/<farmname>/backends

Opret en ny backend i en given datalink Farm.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	IP af backend, hvor den rigtige tjeneste lytter.	sand
grænseflade	String	Det er den lokale netværksinterface, hvor backend er forbundet.	sand
prioritet	nummer	Det er prioriteringsværdien for den aktuelle reelle server. Den bliver brugt når algoritme feltet er konfiguration som prio og lavere prioritet vil have præference. Standardværdien er 1.
vægt	nummer	Det er vægtværdien for den aktuelle backend. Det vil blive brugt når algoritme feltet er konfigureret som vægt. Standardværdien er 1.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger en backend

Rediger en backend

Forespørgselseksempel:

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

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

Ændre parametrene for en backend i en service af en datalink Farm. id er backend unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
String	ip	IP af backend, hvor den rigtige tjeneste lytter.
grænseflade	String	Det er den lokale netværksinterface, hvor backend er forbundet.
timeout	nummer	Det er backend timeout at svare på en bestemt anmodning.
vægt	nummer	Det er vægtværdien for den aktuelle backend.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en backend

Slet en backend

Forespørgselseksempel:

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

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

Slet en given backend i en service af en datalink Farm. id er backend unikke identifikator.

Svar eksempel:

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

Netværk

Zevenet kan arbejde med forskellige typer netværksinterfaces.

I dette afsnit kan du liste, oprette, konfigurere, slette og indstille en handling i NIC, VLAN, virtuelle og bonding-grænseflader.

nic: eller netværkskort, er det en computerhardware komponent, og den slags grænseflade er grundlaget for følgende type grænseflader, som kan defineres og styres i Zevenet.

VLAN: eller virtuelt lan-kort er venlig eller netværksgrænseflade, der leverer netværkssegmenteringstjenester. Mere end en vlan kan oprettes via en nic-grænseflade. limning: Også kaldet af en anden leverandør som trunk-grænseflader, denne slags nic kan oprettes med mere end en nic-grænseflade. Zevenet understøtter 7 forskellige typer af grænseflader.

virtuelt: Denne form for interface kan oprettes over enhver form for grænseflade, der beskrives ovenfor. Denne form for grænseflade bør bruges til Gårde og det kræves, at den virtuelle grænseflade er defineret i det samme undernet som forældren.

Liste over alle grænseflader

Liste over alle grænseflader

Forespørgselseksempel:

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

GET /interfaces

Få en liste over grænseflader i systemet med deres konfiguration.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en grænseflade objekt array.

Interface objekt:

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. IP skal være i samme netværkssegment end overordnet grænseflade i virtuel grænseflade.
netmaske	String	Netmaske af grænsefladen. Denne værdi kunne ikke ændres i virtuelle grænseflader, det er arvet fra moderinterface.
gateway	String	Gateway til grænsefladen. Denne værdi kunne ikke ændres i virtuelle grænseflader, det er arvet fra moderinterface.
mac	String	MAC af grænsefladen. Denne værdi er arvet fra den første NIC-slave i bindingsgrænseflader. I virtuelle og VLAN-interfaces er det arvet fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
typen	String	De forskellige former for grænseflader er: nic, VLAN, virtuelt or obligation.
is_slave	String	Kun tilgængelig i NIC-grænseflader, sand, grænsefladen er en del af et bindingsinterface, falsk grænsefladen er ikke en del af et bindingsinterface.

Hent standard gateway

Hent standard gateway

Forespørgselseksempel:

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

GET /interfaces/gateway

Standard gatewayen er noden, som sender alle destinationstrafik, der ikke kan nås lokalt fra en hvilken som helst grænseflade i belastningsbalanceren.

Få parametrene for standard gateway interface.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
adresse	String	Det er gatewayens IP.
grænseflade	String	Interface navn for gatewayen.

Ændre standard gateway

Ændre standard gateway

Forespørgselseksempel:

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

PUT /interfaces/gateway

Rediger konfigurationen af gateway-grænsefladen.

Svar eksempel:

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

Anmod om parametre

Field	Type	Beskrivelse
adresse	String	Det er gatewayens IP.
grænseflade	String	Interface navn for gatewayen.

Slet gateway-konfiguration

DELETE /interfaces/gateway

Slet konfigurationen af standard gateway-konfigurationen.

Advarsel: Hvis gatewayen er afbrudt, vil Zevenet ikke nås fra et eksternt netværkssegment.

Slet gateway-konfiguration

Forespørgselseksempel:

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

Svarmeddelelse

Hvis gatewayen ophæves fra samme netværkssegment, vises denne meddelelse, ellers vil forbindelsen tabe.

Svar eksempel:

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

Netværk - NIC-grænseflader

NIC-grænseflader er de fysiske grænseflader, der er forbundet med din Zevenet-belastningsbalancer.

Systemet genkender nye grænseflader automatisk, når de er tilsluttet.

Ved brug af NIC-grænseflader som forældre kan andre typer af grænseflader med forskellige egenskaber oprettes. Tilgængelige grænseflader er: VLAN,virtuelt limning.

Liste NIC-grænseflader

GET /interfaces/nic

Få alle parametrene i NIC-grænsefladerne.

Liste NIC-grænseflader

Forespørgselseksempel:

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

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en række NIC interface objekter.

NIC-grænsefladeobjekt:

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker til et andet netværkssegment.
mac	String	Link lag unikt indentifier. Det er umuligt.
navn	String	Interface navn. Det bruges som unik interface-id.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
is_slave	String	sand grænsefladen er en del af et bindingsinterface, falsk grænsefladen er ikke en del af et bindingsinterface.

Hent NIC-grænseflade

Hent NIC-grænseflade

Forespørgselseksempel:

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

GET /interfaces/nic/<name>

Få alle parametrene i en NIC-grænseflade. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker til et andet netværkssegment.
mac	String	Link lag unikt indentifier. Det er umuligt.
navn	String	Interface navn. Det bruges som unik interface-id.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
typen	String	De forskellige former for grænseflader er: nic, VLAN, virtuelt or obligation. Hver enkelt er defineret i deres undermenu i netværket.
is_slave	String	sand grænsefladen er en del af et bindingsinterface, falsk grænsefladen er ikke en del af et bindingsinterface.

Rediger NIC interface

Rediger NIC interface

Forespørgselseksempel:

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

PUT /interfaces/nic/<name>

Ændre parametrene for en NIC-grænseflade. navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet NIC-konfiguration

Slet NIC-konfiguration

Forespørgselseksempel:

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

DELETE /interfaces/nic/<name>

Slet konfigurationen for en NIC-grænseflade. Efter denne handling er grænsefladen ubrugelig og klar til at blive konfigureret igen. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Indstil NIC interface handling

Indstil NIC interface handling

Forespørgselseksempel:

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

POST /interfaces/nic/<name>/actions

Anvend en handling til en NIC-grænseflade. Dette opkald lader aktivere eller deaktivere en netværksgrænseflade.

navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til anvendelse på grænsefladen. De tilgængelige værdier er: up, aktiver grænsefladen og forberede den til at blive brugt ned, deaktiver grænsefladen for ikke at modtage eller ikke sende pakker.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Netværk - Bonding-grænseflader

Linux-bindingsgrænsefladen eller også kaldet af en anden leverandør som Trunk, giver en metode til aggregering af flere netværksinterfaces i en enkelt logisk "bundet" grænseflade. Opførelsen af de bundne grænseflader afhænger af tilstanden, Zevenet Load Balancer understøtter følgende metoder:

Round-robin politik: Sende pakker i rækkefølge fra den første ledige slave gennem den sidste. Denne tilstand giver belastningsbalancering og fejltolerance.

Aktiv backup-politik: Kun en slave i obligationen er aktiv. En anden slave bliver aktiv, hvis og kun hvis den aktive slave fejler. Obligations MAC-adresse er eksternt synlig på kun en port (netværksadapter) for at undgå at forvirre kontakten. Denne tilstand giver fejltolerance. Den primære indstilling påvirker opførslen af denne tilstand.

XOR-politik: Overfør baseret på kilde MAC-adresse XOR'd med destination MAC-adresse. Dette vælger den samme slave for hver destination MAC-adresse. Denne tilstand giver belastningsbalancering og fejltolerance.

Broadcast politik: Overfører alt på alle slave-grænseflader. Denne tilstand giver fejltolerance.

IEEE 802.3ad LACP: Opretter aggregeringsgrupper, der deler de samme hastigheds- og dupleksindstillinger. Udnytter alle slaver i den aktive aggregator i henhold til 802.3ad-specifikationen.

Forudsætninger:

Netværksinterface understøttelse i basisdriverne for at hente hver enkelt slaves hastighed og duplex.
En switch, der understøtter IEEE 802.3ad Dynamic link aggregation. De fleste switche kræver en form for konfiguration for at aktivere 802.3ad-tilstand.

Adaptiv transmitlastbalancering: Kanalbinding, der ikke kræver nogen særlig kontaktstøtte. Den udgående trafik fordeles i henhold til den aktuelle belastning (beregnet i forhold til hastigheden) på hver slave. Indkommende trafik modtages af den nuværende slave. Hvis den modtagende slave fejler, overtager en anden slave MAC-adressen til den mislykkede modtagelsesslav.

Forudsætning:

Base driver support for at hente hver slaves hastighed.

Adaptiv belastningsbalancering: Inkluderer Adaptive transmit load balancing plus modtage belastningsbalancering for IPV4 trafik, og kræver ikke nogen særlig switch support. Modtagebelastningsbalanceringen opnås ved ARP-forhandling. Bindingsdriveren aflyser ARP-svarene, der sendes af det lokale system på vej ud og overskriver kildehardwareadressen med den unikke hardwareadresse for en af slaverne i bindingen, således at forskellige jævnaldrende bruger forskellige hardwareadresser til serveren.

Liste Bonding-grænseflader

Liste Bonding-grænseflader

Forespørgselseksempel:

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

GET /interfaces/bonding

Få konfiguration om alle bindingsgrænseflader i systemet.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med et bindingsinterface objekt array.

Bindingsparametrene er:

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.
mac	String	Link lag unikt indentifier. Det er mac af den første NIC interface slave.
navn	String	Interface navn. Det bruges som unik interface-id.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
slaver	Objekt[]	NIC interface medlemmer af bonding inteface.
tilstand	String	Det er arbejdsmodus for bonding interface. Indstillingerne er: balance-rrRound-robin-politikken; aktiv-backup, Politik for aktiv backup balance-xorXOR-politik udsende, Udsendelsespolitik; 802.3ad, IEEE 802.3ad LACP; balance-TLBAdaptiv transmitlastbalancering; balance-albAdaptiv belastningsbalancering. Disse værdier er defineret i afsnit Netværk - Bonding-grænseflader.

Slaver objekt:

Field	Type	Beskrivelse
navn	String	Navn er grænsefladen unikke identifikator for NIC slaven.

Hent bonding interface

Hent bonding interface

Forespørgselseksempel:

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

GET /interfaces/bonding/<name>

Få alle parametre i grænsefladen. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med et bindingsinterface objekt.

Bindingsparametrene er:

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.
mac	String	Link lag unikt indentifier. Det er mac af den første NIC interface slave.
navn	String	Interface navn. Det bruges som unik interface-id.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
slaver	Objekt[]	NIC interface medlemmer af bonding inteface.
tilstand	String	Det er arbejdsmodus for bonding interface. Indstillingerne er: balance-rrRound-robin-politikken; aktiv-backup, Politik for aktiv backup balance-xorXOR-politik udsende, Udsendelsespolitik; 802.3ad, IEEE 802.3ad LACP; balance-TLBAdaptiv transmitlastbalancering; balance-albAdaptiv belastningsbalancering. Disse værdier er defineret i Netværk> Limningsgrænseflader.

Slave objekt:

Field	Type	Beskrivelse
navn	String	Navn er grænsefladen unikke identifikator for NIC slaven.

Opret Bonding-grænseflade

Opret Bonding-grænseflade

Forespørgselseksempel:

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

POST /interfaces/bonding

Opret en binding grænseflade tilslutning NIC interfaces.

Den bindende MAC-adresse vil blive taget fra sin første NIC-grænseflade. Forbindelsesfunktionen kan ikke ændres, når bindingsgrænsefladen er oprettet, men medlemsgrænseflader kan tilføjes eller slettes i bindingsinterfacet efter behov. En NIC-grænseflade vil blive låst, hvis den er en del af et bindingsinterface.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
navn	String	Interface navn. Det bruges som unik interface-id.	sand
slaver	Snor[]	Alle NIC-grænseflader, der opbygger bindingen. Det kræves NIC-parameteren navn.	sand
tilstand	String	Det er arbejdsmodus for bonding interface. Indstillingerne er: balance-rrRound-robin-politikken; aktiv-backup, Politik for aktiv backup balance-xorXOR-politik udsende, Udsendelsespolitik; 802.3ad, IEEE 802.3ad LACP; balance-TLBAdaptiv transmitlastbalancering; balance-albAdaptiv belastningsbalancering. Disse værdier er defineret i Netværk> Limningsgrænseflader.	sand

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med de bindingskonfigurerede parametre.

Field	Type	Beskrivelse
mac	String	Link lag unikt indentifier. Det er mac af den første NIC interface slave.
navn	String	Interface navn. Det bruges som unik interface-id.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.
slaver	Objekt[]	NIC-grænseflader, der opbygger bonding-interface.
tilstand	String	Det er arbejdsmodus for bonding interface. Indstillingerne er: balance-rrRound-robin-politikken; aktiv-backup, Politik for aktiv backup balance-xorXOR-politik udsende, Udsendelsespolitik; 802.3ad, IEEE 802.3ad LACP; balance-TLBAdaptiv transmitlastbalancering; balance-albAdaptiv belastningsbalancering. Disse værdier er defineret i Netværk> Limningsgrænseflader.

Slave objekt:

Field	Type	Beskrivelse
navn	String	Navn er grænsefladen unikke identifikator for NIC slaven.

Ændre Bonding-grænseflade

Ændre Bonding-grænseflade

Forespørgselseksempel:

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

PUT /interfaces/bonding/<name>

Ændre parametrene for en bindingsinterface. navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet bindingskonfiguration

Slet bindingskonfiguration

Forespørgselseksempel:

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

DELETE /interfaces/bonding/<name>

Slet bindingskonfigurationskonfigurationen. Konfigurationsparametrene er: gateway, ip netmaske.

navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Indstil Bonding-grænseflade handling

Indstil Bonding-grænseflade handling

Forespørgselseksempel:

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

POST /interfaces/bonding/<name>/actions

Anvend en handling til en bonding interface. Med dette opkald kan du slette bindingsgrænsefladen og aktivere eller deaktivere den.

Det er nødvendigt at slette bindingsgrænsefladen ved hjælp af ødelægge handling, hvis du vil låse op for de anvendte NIC-grænseflader i bindingen. Forbindelsesdriveren vil derefter gendanne de MAC-adresser, som medlemsgrænsefladerne havde, før de blev føjet til bindingsgrænsefladen.

navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til anvendelse på grænsefladen. De tilgængelige værdier er: up aktiver grænsefladen og forberede den til at blive brugt, ned deaktiver grænsefladen for ikke at modtage eller ikke sende pakker, ødelægge slet bindingen og genoprett NIC slaver grænseflader.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Tilføj en bonding slave interface

Tilføj en bonding slave interface

Forespørgselseksempel:

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

POST /interfaces/bonding/<name>/slaves

Tilføj en NIC-grænseflade som slave til et eksisterende bindingsinterface.

navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
navn	String	NIC-grænseflader navn at tilføje til bonding interface.	sand

Svar eksempel:

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

Response parametre

Svaret vil være en json med opdaterede konfigurerede værdier. Se svareksempel for mere information.

Fjern en bonding slave interface

Fjern en bonding slave interface

Forespørgselseksempel:

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

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

Slet en NIC slave-grænseflade fra et bindingsinterface. Bonding interface skal have næsten en NIC slave interface.

Fornavn navn er DELETE Opkald er bindingsnavnet unikt identifikator, næste navn i DELETE opkald er grænsefladenavnet unikt identifikator af NIC.

Svar eksempel:

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

Netværk - VLAN-interfaces

VLAN-grænsefladen gør det muligt at bruge et NIC- eller bindingsinterface i et andet netværk, så IP, gateway netmaske felter kan være forskellige fra forældreinterfacet. VLAN-grænsefladen arver MAC-adressen fra dens overordnede grænseflade.

VLAN-grænsefladen navn vises med en prik "." tegn, der vil blive brugt til at etablere et identifikationsmærke til vlan-grænsefladen.

Liste VLAN-grænseflader

Liste VLAN-grænseflader

Forespørgselseksempel:

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

GET /interfaces/vlan

Få alle parametre af VLAN-interfaces.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en VLAN interface objekt array.

VLAN parametrene er:

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. Det kan være anderledes end den overordnede intuitive IP.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.
mac	String	MAC af grænsefladen. Denne værdi er arvet fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af et overordnet interface-navn, et priktegn “.” og et nummer til vlan-netværksgrænsefladen eller vlan-taggen.
forælder	String	Det er grænsefladen, der bruges til at oprette denne.
status	String	Værdierne kan være up grænsefladen kan modtage pakker, ned grænsefladen kan ikke modtage pakker.

Hent VLAN-grænseflade

Hent VLAN-grænseflade

Forespørgselseksempel:

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

GET /interfaces/vlan/<name>

Få alle parametre i VLAN-grænsefladen. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.
mac	String	MAC af grænsefladen. Denne værdi er arvet fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af et overordnet interface-navn, et priktegn “.” og et nummer til vlan-netværksgrænsefladen.
status	String	Værdierne kan være up grænsefladen kan modtage pakker, ned grænsefladen kan ikke modtage pakker.

Opret VLAN-grænseflade

Opret VLAN-grænseflade

Forespørgselseksempel:

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

POST /interfaces/vlan

Opret en VLAN-grænseflade fra en NIC eller bonding interface. Den nye VLAN-grænseflade vil dele MAC, selvom følgende netværksparametre skal være forskellige: ip, og følgende kan ændres: gateway, netmaske.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	IP af grænsefladen. Det skal være forskelligt fra den overordnede IP-IP.	sand
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.	sand
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.	sand
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af et overordnet interface-navn, et priktegn “.” og et nummer til vlan-netværksgrænsefladen.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændr VLAN-grænseflade

Ændr VLAN-grænseflade

Forespørgselseksempel:

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

PUT /interfaces/vlan/<name>

Ændr parametrene for en VLAN-grænseflade. navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. Det kan være anderledes end den overordnede intuitive IP.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet VLAN-grænseflade

Slet VLAN-grænseflade

Forespørgselseksempel:

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

DELETE /interfaces/vlan/<name>

Slet en VLAN-grænseflade. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Indstil VLAN interface handling

Indstil VLAN interface handling

Forespørgselseksempel:

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

POST /interfaces/vlan/<name>/actions

Anvend en handling til en VLAN-grænseflade. Dette opkald lader aktivere eller deaktivere en netværksgrænseflade.

navn er navnet unikt identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til anvendelse på grænsefladen. De tilgængelige værdier er: up, aktiver grænsefladen og forberede den til at blive brugt ned, deaktiver grænsefladen for ikke at modtage eller ikke sende pakker.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Netværk - Virtuelle grænseflader

Netværksgrænseflader giver brugerne mulighed for at have en anden netværksgrænseflade i samme netværkssegment end forælder, så virtuelle grænseflader arver altid netværkskonfigurationen fra dets forælder. Den forskellige parameter vil være ip. Virtual interface kan oprettes fra NIC, binding eller VLAN. Oprettelse af en ny virtuel grænseflade vises et felt med et kolon ":" tegn, som vil blive brugt til at etablere en identifikation til den virtuelle grænseflade.

Liste Virtuelle grænseflader

Liste Virtuelle grænseflader

Forespørgselseksempel:

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

GET /interfaces/virtual

Få alle parametre af virtuelle grænseflader.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. IP'en skal være i samme netværkssegment end overordnet grænseflade.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker. Det arver fra overordnet grænseflade.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment. Det arver fra overordnet grænseflade.
mac	String	MAC af grænsefladen. Det arver fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af en overordnet grænseflade, et kolontegn “:” og navnet på den virtuelle netværksgrænseflade, alfanumeriske tegn er tilladt.
forælder	String	Det er grænsefladen, der bruges til at oprette denne.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.

Hent virtuel grænseflade

Hent virtuel grænseflade

Forespørgselseksempel:

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

GET /interfaces/virtual/<name>

Få alle parametre af en virtuel grænseflade. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. IP'en skal være i samme netværkssegment end overordnet grænseflade.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker. Det arver fra overordnet grænseflade.
gateway	String	IP bruges til at sende pakker af et andet netværkssegment. Det arver fra overordnet grænseflade.
mac	String	MAC af grænsefladen. Det arver fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af en overordnet grænseflade, et kolontegn ":" og en alfanumerisk streng til den virtuelle netværksgrænseflade.
forælder	String	Det er grænsefladen, der bruges til at oprette denne.
status	String	Værdierne kan være up, grænsefladen kan modtage pakker; ned, grænsefladen kan ikke modtage pakker.

Opret virtuel grænseflade

Opret virtuel grænseflade

Forespørgselseksempel:

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

POST /interfaces/virtual

Opret en virtuel grænseflade.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
ip	String	IP af grænsefladen. IP'en skal være i samme netværkssegment end overordnet grænseflade.	sand
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af en overordnet grænseflade, et kolontegn ":" og en alfanumerisk streng til den virtuelle netværksgrænseflade.	sand

Svar eksempel:

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

Response parametre

Svaret vil være en json med interface-konfigurationen. Se svareksempel for mere information.

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. IP'en skal være i samme netværkssegment end overordnet grænseflade.
netmaske	String	Definer netværkssegmentet, hvor grænsefladen virker. Det arver fra overordnet grænseflade.
gateway	String	IP bruges til at sende pakker til et andet netværkssegment. Det arver fra overordnet grænseflade.
mac	String	MAC af grænsefladen. Det arver fra overordnet grænseflade.
navn	String	Interface navn. Det bruges som unik identifikator. Dette navn er en kæde dannet af en overordnet grænseflade, et kolontegn “:” og en alpahnumerisk streng til den virtuelle netværksgrænseflade.

Modificer den virtuelle grænseflade

Modificer den virtuelle grænseflade

Forespørgselseksempel:

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

PUT /interfaces/virtual/<name>

Ændre parametrene for en virtuel grænseflade. navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP af grænsefladen. IP'en skal være i samme netværkssegment end overordnet grænseflade.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet den virtuelle grænseflade

Slet den virtuelle grænseflade

Forespørgselseksempel:

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

DELETE /interfaces/virtual/<name>

Slet en virtuel grænseflade. navn er grænsefladen unikke identifikator.

Svar eksempel:

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

Indstil Virtual Interface-handling

Indstil Virtual Interface-handling

Forespørgselseksempel:

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

POST /interfaces/virtual/<name>/actions

Anvend en handling til en virtuel grænseflade. Dette opkald lader aktivere eller deaktivere en netværksgrænseflade.

navn er grænsefladen unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til anvendelse på grænsefladen. De tilgængelige værdier er: up, aktiver grænsefladen og forberede den til at blive brugt ned, deaktiver grænsefladen for ikke at modtage eller ikke sende pakker.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Netværk - Flydende grænseflader

Denne form for grænseflade bruger en defineret virtuel grænseflade og maskerer den udgående trafik af a nic, limning or VLAN interface med et barn virtuelt grænseflade. Denne grænseflade bruges til stateful failoveradfærd i l4xnat profiler, hvis en klynge er konfigureret.

Liste Flydende grænseflader

Liste Flydende grænseflader

Forespørgselseksempel:

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

GET /interfaces/floating

Vis alle tilgængelige eller konfigurerede grænseflader, hvor der er oprettet en flydende IP.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en flytende grænseflade objekt array:

Flydende objekt:

Field	Type	Beskrivelse
floating_ip	String	Flydende IP bruges i grænseflade. floating_ip skal eksistere som virtuelt interface barn af grænseflade.
grænseflade	String	Interface maskeret af den flydende IP.

Hent flytende interface

Hent flytende interface

Forespørgselseksempel:

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

GET /interfaces/floating/<name>

Viser, om en grænseflade har en konfigureret flydende IP. Hvis den har en konfigureret, vises den her.

navn er grænsefladen unikke identifikator, som kan være af typen nic, binding eller vlan.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
floating_ip	String	Flydende IP bruges i grænseflade. floating_ip skal eksistere som virtuelt interface barn af grænseflade.
grænseflade	String	Interface maskeret af den flydende IP.

Ændre flydende grænseflade

Ændre flydende grænseflade

Forespørgselseksempel:

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

PUT /interfaces/floating/<name>

Konfigurer en flydende IP til en NIC, binding eller VLAN-grænseflade.

navn er grænsefladen unikke identifikator, som kan være af typen nic, binding eller vlan.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
floating_ip	String	Flydende IP bruges i grænseflade. floating_ip skal eksistere som virtuelt interface barn af grænseflade.	sand

Svar eksempel:

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

Slet Flytende konfiguration

Slet Flytende konfiguration

Forespørgselseksempel:

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

DELETE /interfaces/floating/<name>

Fjern den flydende IP-konfiguration i en grænseflade.

navn er grænsefladen unikke identifikator, som kan være af typen nic, binding eller vlan.

Svar eksempel:

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

Overvågning - Statistik

Vis oplysninger om system og gårde. Disse oplysninger vil være nyttige for at overvåge Zevenet load balancer status.

Vis systemstatistikker

Vis systemstatistikker

Forespørgselseksempel:

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

GET /stats

Få global systemstatistik.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
cpu	Object	CPU statistikker.
dato	String	System dato.
hostname	String	Værts navn.
belastning	Object	Kernelastestatistik.
hukommelse	Object	Brugt hukommelsesstatistik.
netværk	Object	Netværkstrafikstatistik.

CPU objekt:

Field	Type	Beskrivelse
kerner	nummer	Antal kerner i processoren.
tomgang	nummer	CPU bruger ikke noget program.
iowait	nummer	CPU bruges ved input eller output proces.
IRQ	nummer	CPU bruges af hardware interrrupcions.
rart	nummer	CPU planlægning prioritet.
softirq	nummer	CPU bruges af software interruptions.
sys	nummer	CPU bruges af systemet.
forbrug	nummer	Total CPU brugt.
bruger	nummer	CPU brugt af brugeren.

Indlæs objekt:

Field	Type	Beskrivelse
Last_1	nummer	Indlæs systemets andel i sidste øjeblik.
Last_5	nummer	Indlæs systemprocent for fem minutter siden.
Last_15	nummer	Indlæs systemprocent for femten minutter siden.

Hukommelsesobjekt.

Field	Type	Beskrivelse
Buffere	nummer	Det er den hukommelse, der bruges af bufferne. Dette beløb er angivet i Mb.
Cached	nummer	Det er den samlede hukommelse cached af systemet. Dette beløb er angivet i Mb.
MemFree	nummer	Det er den samlede ledige hukommelse, der ikke er cachelagret af systemet. Dette beløb er angivet i Mb.
MemTotal	nummer	Det er den samlede RAM-hukommelse på systemet. Dette beløb er angivet i Mb.
MemUsed	nummer	Det er den hukommelse der bruges af systemet. Dette beløb er angivet i Mb.
SwapCached	nummer	Det er den samlede cache hukommelse reserveret.
SwapFree	nummer	Det er den samlede ledige hukommelse, der ikke er cachelagret af systemet. Dette beløb er angivet i Mb.
SwapTotal	nummer	Det er den samlede swap-hukommelse reserveret.
SwapUsed	nummer	Det er den bytte, der bruges til hukommelsen af systemet, på optimale systemer skal 0 være.

Netværksobjekt:

Field	Type	Beskrivelse
ind i	nummer	Indtast trafik for dette grænseflade.
ude	nummer	Output trafik til dette grænseflade.

Vis netværksstatistik

Vis netværksstatistik

Forespørgselseksempel:

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

GET /stats/system/network

Få en oversigt over den samlede input- og outputtrafik via en netværksgrænseflade.

Svar eksempel:

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

Response parametre

Svaret vil være en JSON med en nøgle params hvis værdi er et objekt med følgende nøgler:

Field	Type	Beskrivelse
dato	String	System dato.
hostname	String	Værts navn.
grænseflader	Objekt[]	Netværkstrafikstatistik.

Interfaces objekt

Field	Type	Beskrivelse
in	String	Samlet inputtrafik i MB.
grænseflade	String	Interface navn.
ud	String	Total output trafik i MB.

Vis grænsefladestatistik

Vis grænsefladestatistik

Forespørgselseksempel:

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

GET /stats/system/network/interfaces

Få et resumé af hver netværksgrænseflade.

Svar eksempel:

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

Response parametre

Svaret vil være en JSON med en nøgle params hvis værdi er et objekt med nøglerne obligation nic.

Field	Type	Beskrivelse
obligation	Objekt[]	Bond interface-statistik.
nic	Objekt[]	NIC interface statistik.

Objektobjekt:

Field	Type	Beskrivelse
in	String	Samlet inputtrafik i MB.
grænseflade	String	Interface navn bruges som unik identifikator.
ip	String	Interface's IP.
mac	String	Interface MAC.
ud	String	Total outputtrafik i MB.
slaver	String []	Liste over slaver, der opbygger bindingsgrænsefladen.
status	String	Interface status. Værdien kan være ned, grænsefladen er deaktiveret; up, grænsefladen er aktiveret.
virtuelt	String []	Virtuelle grænseflader, der arver fra denne grænseflade.
VLAN	String []	VLAN-grænseflader, der arver fra denne grænseflade.

Nic objekt:

Field	Type	Beskrivelse
in	String	Samlet inputtrafik i MB.
grænseflade	String	Interface navn bruges som unik identifikator.
ip	String	Interface's IP.
mac	String	Interface MAC.
ud	String	Total outputtrafik i MB.
status	String	Interface status. Værdien kan være ned, grænsefladen er deaktiveret; up, grænsefladen er aktiveret.
virtuelt	String []	Virtuelle grænseflader, der arver fra denne grænseflade.
VLAN	String []	VLAN-grænseflader, der arver fra denne grænseflade.

Vis hukommelsesstatistik

Vis hukommelsesstatistik

Forespørgselseksempel:

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

GET /stats/system/memory

Få et resumé af systemhukommelsen.

Svar eksempel:

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

Response parametre

Svaret vil være en JSON med en nøgle params hvis værdi er et hukommelsesobjekt.

Hukommelse objekt.

Field	Type	Beskrivelse
Buffere	nummer	Det er den hukommelse, der bruges af bufferne. Dette beløb er angivet i Mb.
Cached	nummer	Det er den samlede hukommelse cached af systemet. Dette beløb er angivet i Mb.
MemFree	nummer	Det er den samlede ledige hukommelse, der ikke er cachelagret af systemet. Dette beløb er angivet i Mb.
MemTotal	nummer	Det er den samlede RAM-hukommelse på systemet. Dette beløb er angivet i Mb.
MemUsed	nummer	Det er den hukommelse der bruges af systemet. Dette beløb er angivet i Mb.
SwapCached	nummer	Det er den samlede cache hukommelse reserveret.
SwapFree	nummer	Det er den samlede ledige hukommelse, der ikke er cachelagret af systemet. Dette beløb er angivet i Mb.
SwapTotal	nummer	Det er den samlede swap-hukommelse reserveret.
SwapUsed	nummer	Det er den bytte, der bruges til hukommelsen af systemet, på optimale systemer skal 0 være.
dato	String	System dato.
hostname	String	Værts navn.

Vis belastningsstatistik

Vis belastningsstatistik

Forespørgselseksempel:

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

GET /stats/system/load

Få et resumé af CPU systembelastningen.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
Last_1	nummer	Indlæs systembrugen sidst.
Last_5	nummer	Indlæs systemanvendelsen de sidste fem minutter.
Last_15	nummer	Indlæs systembrug de sidste fem minutter.
dato	String	System dato.
hostname	String	Værts navn.

Vis CPU-statistikker

Vis CPU-statistikker

Forespørgselseksempel:

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

GET /stats/system/cpu

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
kerner	nummer	Antal kerner i processoren.
tomgang	nummer	CPU bruger ikke noget program.
iowait	nummer	CPU bruges ved input eller output proces.
IRQ	nummer	CPU bruges af hardware interrrupcions.
rart	nummer	CPU planlægning prioritet.
softirq	nummer	CPU bruges af software interruptions.
sys	nummer	CPU bruges af systemet.
forbrug	nummer	Total CPU brugt.
bruger	nummer	CPU brugt af brugeren.
dato	String	System dato.
hostname	String	Værts navn.

Vis forbindelsesstatistikker

Vis forbindelsesstatistikker

Forespørgselseksempel:

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

GET /stats/system/connections

Få de samlede aktuelle forbindelser i systemet. Tælleren summerer enhver form for sporede forbindelser: ASSURED, ESTABLISHED, SYN_SENT, TIME_WAIT, LISTEN ...

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
tilslutninger	nummer	Samlede sporede forbindelser faktisk.

Vis antal gårde

Vis antal gårde

Forespørgselseksempel:

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

GET /stats/farms/total

Vis det samlede antal bedrifter, der er oprettet i systemet.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
nummer	nummer	Det er antallet af bedrifter, der findes i systemet.

Vis gårdsstatistik

Vis gårdsstatistik

Forespørgselseksempel:

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

GET /stats/farms

Få et resumé af forbindelser og konfiguration for alle gårde i systemet.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
etableret	nummer	Samlet antal nuværende etablerede forbindelser.
farmname	String	Landbrugsnavn, entydigt identifikator.
verserende	nummer	Antal ventende forbindelser.
profil	String	Type gård. De mulige værdier er: data link, l4xnat, http, https or GSLB. Hver profil er defineret i sin sektion.
status	String	Farm status. De mulige værdier er: upgården går; ned, gården er stoppet eller nødvendige genstart, gården skal genstartes for at de seneste ændringer kan træde i kraft.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	String	Havnen på gården, hvor den virtuelle tjeneste lytter.

Vis en bedriftsstatistik

Vis en bedriftsstatistik

Forespørgselseksempel:

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

GET /stats/farms/<farmname>

Viser den aktuelle gårdsstatus, deres backend status og forbindelser. Hver gård vil reagere med forskellige objekter, afhængigt af profilen.

Svareksempel for HTTP gård:

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

Response parametre i HTTP gårde

Field	Type	Beskrivelse
backends	Objekt[]	Vis oplysninger om backends.
sessioner	Objekt[]	Vis oplysninger om sessioner.

Backend Object

Field	Type	Beskrivelse
etableret	nummer	Samlet antal etablerede forbindelser.
id	nummer	Backend unik identifikator.
ip	String	IP hvor den rigtige tjeneste lytter.
verserende	nummer	Antal ventende forbindelser.
port	nummer	Port, hvor den rigtige tjeneste lytter.
tjeneste	String	Servicenavn, der bruges som unik identifikator.
status	String	Backend status. De mulige værdier er: up, backend er klar til at modtage forbindelser; ned, tjenesten har opdaget, at backend'en ikke virker; fgDOWN, farmguardian har deaktiveret backend, fordi farmguardian check ikke lykkedes; vedligeholdelse, backend er markeret som ikke klar til at modtage forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver.

Session Object

Field	Type	Beskrivelse
kunde	String	Client unikke identifikator.
id	String	Backend unik identifikator tildelt til klienten.
tjeneste	String	Service unik identifikator tildelt til klienten.
Session	String	Session unik identifikator. Denne værdi afhænger af persistens typen.

Svareksempel for GSLB gård:

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

Response parametre i GSLB gårde

Field	Type	Beskrivelse
backends	Objekt[]	Vis oplysninger om bagsiden.
kunde	Object	Statistik relateret til klienten.
udvidet	Object	Udvidet information om tjenesten.
server	Object	Statistik relateret til serveren.

Backend objekt

Field	Type	Beskrivelse
id	nummer	Backend unik identifikator.
ip	String	IP hvor den rigtige tjeneste lytter.
port	nummer	Port, hvor den rigtige tjeneste lytter.
tjeneste	String	Servicenavn, der bruges som unik identifikator.
status	String	Backend status. De mulige værdier er: up, backend er klar til at modtage forbindelser; ned, tjenesten har opdaget, at backend'en ikke virker; vedligeholdelse, backend er markeret som ikke klar til at modtage forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver.

Klientobjekt

Field	Type	Beskrivelse
edns_big	nummer	Svar, der var større end 512 bytes.
edns_tc	nummer	Klientens specificerede udvidede dns-bufferstørrelse var for lille til de anmodede data.
recvfail	nummer	Antal UDP-fejl, hvor operativsystemet angav, at der opstod noget dårligt ved modtagelsen.
anmod	nummer	Samlet antal UDP-anmodninger, der håndteres af serveren.
sendfail	nummer	Antal UDP-fejl, hvor operativsystemet angav, at der opstod noget dårligt ved afsendelse.
tc	nummer	Svar, der blev afkortet med TC bit sæt.

Udvidet objekt

Field	Type	Beskrivelse
badvers	nummer	Anmodning, der havde en EDNS OPT-RR med en version, der ikke blev understøttet.
droppet	nummer	Mistede anmodninger om fejlformet format.
edns	nummer	Forespørgslen indeholdt en EDNS OPT-RR.
edns_clientsub	nummer	Undergruppe af edns-anmodninger, der angav indstillingen edns_client_subnet.
formerr	nummer	Forespørgslen var dårligt formateret, men var fornuftig nok, at vi sendte et svar med koden FORMERR.
noerror	nummer	Succesfulde anmodninger.
notimp	nummer	Forespurgt tjeneste ikke implementeret af denne dæmon, såsom anmodninger om zoneoverførsel.
nxdomain	nummer	Anmodning om et ikke-eksisterende domænenavn.
nægtede	nummer	Forespørgslen blev afvist af serveren, fordi serveren ikke er autoriseret til det forespurgte navn.
v6	nummer	Anmodning fra en IPv6-klient.

Server objekt

Field	Type	Beskrivelse
recvfail	nummer	Antal TCP fejl, hvor OS viste, at der var noget dårligt ved modtagelsen.
anmod	nummer	Samlet antal TCP-anmodninger, der håndteres af serveren.
sendfail	nummer	Antal TCP fejl, hvor OS viste, at der var sket noget dårligt ved afsendelse.

Reaktionseksempel for L4xNAT gård:

{
   "backends" : [
      {
         "established" : 5,
         "id" : 1,
         "ip" : "192.168.5.40",
         "pending" : 0,
         "port" : "8080",
         "status" : "maintenance"
      },
      {
         "established" : null,
         "id" : 3,
         "ip" : "192.5.1.1",
         "pending" : 0,
         "port" : "787",
         "status" : "fgDOWN"
      },
      {
         "established" : null,
         "id" : 5,
         "ip" : "192.168.5.100",
         "pending" : 0,
         "port" : "8080",
         "status" : "up"
      }
   ],
   "description" : "List farm stats"
}

Response parametre i L4xNAT gårde

Svaret bliver en JSON med nøgle backends og værdi et objekt array med nedenstående parametre.

Backend objekt:

Field	Type	Beskrivelse
etableret	nummer	Samlet antal nuværende etablerede forbindelser.
id	nummer	Backend unik identifikator.
ip	String	IP hvor den rigtige tjeneste lytter.
verserende	nummer	Antal ventende forbindelser.
port	nummer	Port, hvor den rigtige tjeneste lytter.
status	String	Backend status. De mulige værdier er: up, backend er klar til at modtage forbindelser; fgDOWN, bondevogter har opdaget, at bagenden ikke virker; vedligeholdelse, backend er markeret som ikke klar til at modtage forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver.

Response parametre i datalink gårde

Datalink gårdsstatistik er ikke tilgængelig faktisk.

Vis modulstatus

Vis modulstatus

Forespørgselseksempel:

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

GET /stats/farms/modules

Få et resumé af modulstatistikker. Dette opkald viser hvert modul status, antal konfigurerede, antallet af gårde sat ned og op.

Definitionen om moduler er i Gårde sektion.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON med tre nøgler: dslb, GSLB lslb.

Field	Type	Beskrivelse
ned	nummer	Antal stoppede gårde. Disse gårde stoppes af systemadministratoren.
alt	nummer	Antal samlede gårde.
up	nummer	Antal løbende gårde.

Vis modulstatistik

Vis modulstatistik

Forespørgselseksempel:

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

GET /stats/farms/modules/<module>

Vis gårdsstatistik for et bestemt modul.

De tilgængelige værdier for modul parameter er: lslb, GSLB or dslb.

Svar eksempel:

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

Response parametre

Svaret bliver et JSON objekt med information om gårde i modulet.

Field	Type	Beskrivelse
etableret	nummer	Samlet antal nuværende etablerede forbindelser.
farmname	String	Farmens navn, unikke identifikator for gårde.
verserende	nummer	Antal ventende forbindelser.
profil	String	Type gård. De mulige værdier er: data link, l4xnat, http, https or GSLB. Hver profil er defineret selv-sektion.
status	String	Farm status. De mulige værdier er: upgården går; ned, gården er stoppet eller nødvendige genstart, gården skal genstartes for at de seneste ændringer kan træde i kraft.
vip	String	IP af gården, hvor den virtuelle tjeneste lytter.
VPort	String	Havnen på gården, hvor den virtuelle tjeneste lytter.

Overvågning - Grafer

Dette afsnit er nyttigt at overvåge det interne belastningsbalancersystem til at registrere problemer via parametrene for CPU-brug, swap-hukommelse, RAM-hukommelse, alle konfigurerede nework-grænseflader, belastning og harddiskopbevaring.

Du vil også kunne få adgang til den ugentlige, mothly og årlige historie.

Grafer med oplysninger besvares i base64 format.

Liste ledige grafer

Liste ledige grafer

Forespørgselseksempel:

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

GET /graphs

Vis et objekt med alle tilgængelige grafer i systemet. Det viser den mulige anmodning, der kan foretages.

Svar eksempel:

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

Response parametre

Svaret vil være en JSON tre typer af grafer, gårde, grænseflader systemet.

Field	Type	Beskrivelse
gårde	Snor[]	Liste over landbrugsgrafer tilgængelige.
grænseflader	Snor[]	Liste over grænseflader grafer tilgængelige.
systemet	Objekt[]	Liste over systemgrafer tilgængelige. Arrayet har et objekt med et array, som det angiver disk mount points.

System objekt:

Systemobjekt indeholder en matrixliste relateret til systemet og et diskobjekt med det næste format.

Field	Type	Beskrivelse
disk	Snor[]	Værdierne i dette array er alle eksisterende monteringspunkter I systemet har hver en tilgængelig graf.

Vis grafer

Vis grafer

Anmodning om eksempel på en gård:

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

Anmod om eksempel på en grænseflade:

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

Anmod om eksempel på en disk:

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

GET /graphs/<graph>

De tilgængelige værdier for graf er:

Værdi	Beskrivelse
`farms/<farmname>`	farmname, farm unikke identifikator.
`interfaces/<interface>`	grænseflade, grænseflade unik identifikator.
`system/<system>`	systemet, mulige systemgrafer er: cpu, belastning, RAM or bytte.
`system/disk/<mount point>`	monteringspunkt, er en værdi af disk objekt, returneret af 'GET / grafer' opkald.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
frekvens	String	Tidsperiode brugt til at generere grafen. De mulige værdier er: dagligt, ugentlig, månedligt or årligt.
grafer	String	Graf i base 64 format.

Vis frekvensdiagram

Vis frekvensdiagram

Anmodning om eksempel på en gård:

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

Anmod om eksempel på en grænseflade:

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

Anmod om eksempel på en disk:

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

GET /graphs/<graph>/<frequency>

De tilgængelige værdier for graf er:

Værdi	Beskrivelse
`farms/<farmname>`	farmname, farm unikke identifikator.
`interfaces/<interface>`	grænseflade, grænseflade unik identifikator.
`system/<system>`	systemet, mulige systemgrafer er: cpu, belastning, RAM or bytte.
`system/disk/<mount point>`	monteringspunkt, er en værdi af disk objekt, returneret af 'GET / grafer' opkald.

De tilgængelige værdier for frekvens er:

Field	Type	Beskrivelse
frekvens	String	Tidsperiode brugt til at generere grafen. De mulige værdier er: dagligt, ugentlig, månedligt or årligt.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
grafer	String	Graf i base 64 format.

IPDS

Dette modul er implementeringen af a IPS (Intrusion Prevention System) og IDS (Intrusion Detection System) system til at tilbyde brugeren et sikkerhedslag. IPDS-modulet inspicerer trafikken lige før for at nå belastningsbalancemodulerne LSLB or GSLB, hvis trafikken opdages som skadelig, vil den blive afvist.

Det virker at anvende sikkerhedsregler på systemet, som vil blive defineret som objekt af forskellig karakter. Hver enkelt tilbyder en løsning til ekstern ondsindet eller mistænkelig handling. Dette værktøj hjælper systemadministratorer med at kontrollere trusler og angreb.

De tilgængelige regler, der gælder for Zevenet, kan være sortlister DoS.

IPDS - Blacklists

Sortlister lader brugerne bruge lister til at filtrere eller tillade trafik ifølge kilde-IP'er (inkommende trafik).

Der er to typer lister:

Fjernbetjeninger: Lister er hentet fra en webadresse, disse lister er ikke modificerede og kan afvikles for at blive downloadet.
Lokal: Brugere kan oprette deres egne lister med en given politik, benægte hvis den inkommende IP matcher, bliver trafikken afvist eller tillade hvis den inkommende IP matcher så vil trafikken blive tilladt.

Dette modul indeholder forudindlæst lister leveret af Zevenet hold, listen er klar til at blive anvendt på bedrifter. Derudover kan brugerne oprette deres egne personlige lister.

Flere lister kan anvendes på samme gård, hvis kilden IP matcher i en del af listen, vil trafikken blive tilladt eller afvist afhængigt af blacklist-politikken. I øjeblikket matcher IP'en, så er der ikke foretaget flere sorte listekontroller til kilde IP.

Hvis en kilde IP er i to forskellige lister benægte tillade, så er altid tilladelsespolitikken evallueret først.

Liste over alle blacklists regler

Liste over alle sortlister

Forespørgselseksempel:

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

GET /ipds/blacklists

Liste over alle blacklists oprettet af brugeren eller forudindlæst i systemet, der kan anvendes på gårdene.

Svar eksempel:

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

Response parametre

Svaret bliver et JSON objekt med en nøgle indstillet til params. Værdien af dette vil være en række af blacklist objekter, der hver indeholder de nøgleattributter nedenfor.

Field	Type	Beskrivelse
gårde	Snor[]	Farms liste hvor den sorte liste er anvendt.
navn	String	Sortlistenavn. Den bruges som unik identifikator.
politik	String	Handling til anvendelse på kilden. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
preload	String	De mulige værdier er: sand, sortlisten er forudindlæst i systemet; eller falsk, sortlisten er oprettet af systemadministrator.
typen	String	Hvor listen er gemt, og hvem opretholder den. Værdierne er: lokale, listen gemmes i det lokale system og kan ændres lokalt eller fjern, listen er hentet fra fjernkilde gennem a url, Det kan ikke ændres lokalt, så ændringerne skal tages i den eksterne kilde.

Hent en blacklist-regel

Hent blacklist

Forespørgselseksempel:

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

GET /ipds/blacklists/<name>

Vis blacklistens konfiguration og beskrivelse parametre. navn er blacklistens unikke identifikator.

Response parametre

Response Local List Eksempel:

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

Lokalt sortlisteobjekt:

Field	Type	Beskrivelse
gårde	Snor[]	Farms liste hvor den sorte liste er anvendt.
navn	String	Sortlistenavn. Den bruges som unik identifikator.
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
preload	String	De mulige værdier er: sand, sortlisten er forudindlæst i systemet; eller falsk, sortlisten er oprettet af systemadministratoren.
typen	String	Hvor listen er gemt, og hvem opretholder den. Værdierne er: lokale, listen gemmes i systemet og vedligeholdes af systemadministratoren; eller fjern, listen er hentet fra en ekstern url.
kilder	Objekt[]	Liste over IP'er, som listen kontrollerer. Kilde netværk format accepteret: Netværksadresse / Mask bit eller IP

Eksempel på fjernbetjeningseksempel:

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

Fjernt sortlistelement:

Field	Type	Beskrivelse
gårde	Snor[]	Farms liste hvor den sorte liste er anvendt.
navn	String	Sort liste navn. Den bruges som unik identifikator.
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
preload	String	De mulige værdier er: sand, sortlisten er forudindlæst i systemet; eller falsk, sortlisten er oprettet af systemadministratoren.
typen	String	Hvor listen er gemt, og hvem opretholder den. Værdierne er: lokale, listen gemmes i systemet og vedligeholdes af systemadministratoren; eller fjern, listen er hentet fra en fjernbetjening url.
kilder	Objekt[]	Ssource IP'er, som listen kontrollerer. Hvis listen er af typen fjern så vises listens indhold ikke før den første download.
Opdater status	String	Status for den sidste download af listen og dato for den sidste succesfulde opdatering i det lokale system.
url	String	Hvor fjernliste hentes fra. Fjernformatet skal være en liste over en kilde netværk / bitmaske eller IP pr. linje.
frekvens	String	Fjernliste opdateringsfrekvens. Indstillingerne er: dagligt, opdater alle dage, en gang eller periodisk, dette er angivet i frequency_type Mark; ugentlig, opdater en gang om ugen eller månedligt, opdater en gang om måneden.
frequency_type	String	Denne parameter fuldender frekvens dagligt, når dets værdi er daglig. De mulige værdier er: eksakt. definere en time om dagen eller periode, definer en periode, der skal opdateres i løbet af dagen.
dag	String eller nummer	Denne parameter fuldender parameteren frekvens hvornår frecuency Værdien er ugentlig or månedligt. hvis frecuency is ugentlig denne parameter skal være aday for ugen (mandag, tirsdag, onsdag, torsdag, Fredag, lørdag or Søndag) hvis frekvens Værdien er månedligt så skal denne parameter være en dag i måneden (et tal mellem 1 31).
tid	Object	Det er en struktur, der afhænger af felterne frekvens.

Tid objekt for den daglige frekvens og periode frequency_type

Field	Type	Beskrivelse
periode	nummer	Hvor ofte opdateres listen.
enhed	String	Periodeenhed. Indstillingerne er: minutter, angiv listen vil blive opdateret hvert konfigureret minut eller timer, listen opdateres hver konfigurerede tid.

Tid objekt for andre frekvenser

Field	Type	Beskrivelse
time	nummer	Time for at opdatere listen. Værdien skal være et tal mellem 0 23.
minutter	nummer	Minutter for at opdatere listen. Værdien skal være et tal mellem 0 59.

Kilder objekt

Field	Type	Beskrivelse
id	nummer	Kilde unik identifikation i listen.
kilde	String	IP-adresser eller net-segmenter, som listen kontrollerer.

Opret en blacklist-regel

Opret en ny sortliste

Anmod om eksempel på en lokal liste:

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

Anmod om eksempel på en fjernliste:

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

POST /ipds/blacklists

Opret en sortliste, der skal bruges på gårde. Sortlister kan bestå af to typer:

Lokal: Kilderne tilføjes af brugeren. Listen gemmes lokalt.
Remote: Kilderne hentes fra en fjernplacering. Denne placering er angivet med en webadresse. Det understøttede fjernlisteformat er en Netværksadresse / Mask bit or IP linje pr. linje.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
navn	String	Sortlistenavn. Den bruges som unik identifikator.	sand
typen	String	Hvor listen er gemt, og hvem vedligeholder den. Værdierne er: lokale, listen gemmes i system og vedligeholdelse for administrationssystem; eller fjern, listen er taget fra en ud service gennem a url og administrators servcie vedligeholder listen.	sand
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen. Standardværdien nægtes.
url	String	Hvor fjernliste hentes fra. Fjernformatet skal være en liste over en kilde pr. linje i formatet Netværksadresse / Mask bit or IP.	sandt for fjernliste

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

Response parametre

Svaret bliver et JSON objekt med en nøgle indstillet til params. Værdien af dette vil være en række af blacklist objekter, der hver indeholder følgende nøgleattributter.

Field	Type	Beskrivelse
gårde	Snor[]	Farms liste hvor den sorte liste er anvendt.
navn	String	Sortlistenavn. Den bruges som unik identifikator.
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
preload	String	De mulige værdier er: sand, sortlisten er forudindlæst i systemet; eller falsk, sortlisten er oprettet til systemadministrator.
typen	String	Hvor listen er gemt, og hvem vedligeholder den. Værdierne er: lokale, listen gemmes i system og vedligeholdelse for administrationssystem; eller fjern, listen er taget fra en ud service gennem a url og administrators servcie vedligeholder listen.

Ændre en blacklist-regel

Rediger en sortliste

Anmod om eksempel på en lokal liste:

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

PUT /ipds/blacklists/<name>

Rediger konfigurationen af en blacklist-regel. navn er blacklistens unikke identifikator.

Anmod parameter for en lokal liste:

Field	Type	Beskrivelse
navn	String	Sortlistenavn. Den bruges som unik identifikator. Kun det er modificeret på nr preload lister.
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
kilde	Snor[]	Det er en liste over IP-adresser eller net-segmenter, som listen kontrollerer. For at ændre ændring kun en kilde, se venligst dokumentatio sektionen IPDS> Sortlister> Rediger en kilde til en sortliste. Kun kilder er ændret på nr preload lister.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Anmod om eksempel på en fjernliste:

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

Anmod om eksempel for opdatering af en liste hver 2 timer:

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

Anmod om eksempel for opdatering af en liste alle dage på 2: 00 AM:

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

Anmod om eksempel for opdatering af alle mandage på 0: 00 AM:

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

Anmod om eksempel for opdatering af dagen 1 i måneden ved 12: 00 PM:

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

Anmod parameter for en fjernliste

Field	Type	Beskrivelse
gårde	Snor[]	Farms liste hvor den sorte liste er anvendt.
navn	String	Sortlistenavn. Den bruges som unik identifikator.
politik	String	Handling til anvendelse på en kilde. Indstillingerne er: benægte, bloker inputtrafikken fra kilder til listen; eller tillade acceptere trafikken fra kilder til listen.
url	String	Hvor fjernliste hentes fra.
frekvens	String	Fjernliste opdateringsfrekvens. Indstillingerne er: dagligt, opdater alle dage, en gang eller en periode, dette er angivet i frequency_type Mark; ugentlig, opdater en gang om ugen eller månedligt, opdater en gang om måneden.
frequency_type	String	Denne parameter fuldender frekvens dagligt, når dets værdi er daglig. De mulige værdier er: eksakt. definere en time om dagen eller periode, definer en periode, der skal opdateres i løbet af dagen.
dag	String eller nummer	Denne parameter fuldender frekvens når dens værdi er ugentlig eller månedlig. Hvis det er ugentlig, skal denne parameter være en ugedag (mandag, tirsdag, onsdag, torsdag, Fredag, lørdag or Søndag) ellers hvis frekvens er månedlig, så skal denne parameter være en månedsdag (nummer mellem 1 31).
tid	Object	Det er en struktur, der afhænger af felterne frekvens.

Tidsperiode objekt

Dette er felterne, når en tidsperiode vil blive konfigureret.

Det er nødvendigt at konfigurere frekvens med værdien dagligtog frequency_type med værdien periode.

Field	Type	Beskrivelse
periode	nummer	Hvor ofte opdaterer listen.
enhed	String	Periodeenhed. Indstillingerne er: minutter or timer, angiv måleenheden for listen opdateringer.

Tid præcis time objekt

Dette er felterne, når en eksakt timetid vil blive konfigureret.

Dette objekt bruges sammen med de følgende konfigurationer:

frekvens feltet har værdien dagligt frequency_type is eksakt.

frekvens feltet har værdien ugentlig dag er den ugedag, hvor listen opdateres.

frekvens feltet har værdien månedligt dag er antallet af dagmåneder, når listen opdateres.

Field	Type	Beskrivelse
time	nummer	Time for at opdatere listen. Værdien skal være et tal mellem 0 23.
minutter	nummer	Minutter for at opdatere listen. Værdien skal være et tal mellem 0 59.

Svar eksempel:

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

Response parametre

Svaret vil være en json med alle listekonfigurationer. Se svareksempel for mere information.

Opdater en fjern blacklist-regel

Opdater en fjern blacklist

Anmod om eksempel på en fjernliste:

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

POST /ipds/blacklists/<name>/actions

Opdater en fjernliste, download kilderne. navn er blacklistens unikke identifikator.

Anmod parameter for en fjernliste

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til at sende til listen. Denne parameter skal være opdatering.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med downloadstatus. Se svareksempel for mere information.

Field	Type	Beskrivelse	påkrævet
opdatering	String	Status for den sidste download af listen og dato for den sidste succesrige opdatering.

Slet en sortliste-regel

Slet en liste over sorte lister

Forespørgselseksempel:

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

DELETE /ipds/blacklists/<name>

Slet en given sortliste. navn er blacklistens unikke identifikator.

Svar eksempel:

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

Liste kilde fra en sortliste

Liste kilde fra en sortliste

Forespørgselseksempel:

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

GET /ipds/blacklists/<name>/sources

Liste kilder til en sortliste. navn er blacklistens unikke identifikator.

Svar eksempel:

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

Response parametre

Svaret bliver en JSON med nøglen params og kildeobjekt array som værdi.

Kildeobjekt:

Field	Type	Beskrivelse
id	nummer	Kilde unik identifikation i listen.
kilde	Snor[]	IP-adresser eller net-segmenter, som listen kontrollerer.

Tilføj en kilde til en sortliste

Tilføj en kilde til en sortliste

Forespørgselseksempel:

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

POST /ipds/blacklists/<name>/sources

Skub en ny kilde til en sortliste. Kun tilgængelig for lokale lister og ikke-forudindlæste lister. navn er blacklistens unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
kilde	String	IP-adresse eller net-segment, som listen kontrollerer.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger en kilde til en sortliste

Rediger en kilde til en sortliste

Forespørgselseksempel:

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

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

Rediger en kilde til en sortliste.

navn er blacklistens unikke identifikator. id er kildens unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
kilde	String	IP-adresse eller net-segment, som listen kontrollerer.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med opdateret kilde. Se svareksempel for mere information.

Slet en kilde til en sortliste

Slet en kilde til en sortliste

Forespørgselseksempel:

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

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

Fjern en kilde fra en sortliste.

navn er blacklistens unikke identifikator. id er kildens unikke identifikator.

Svar eksempel:

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

IPDS - DoS

DoS beskyttelse har forskellige regler, afhænger af beskyttelsesregel, den anvendes til en anden del af balanceren. Så der er systemet regler, at det gælder alle balancer. Forbindelsesorienterede regler, specifikke for gård arbejder med TCP-protokollen. Før du anvender en regel til a gård, opret et objekt med den ønskede konfiguration. Derefter anvendte den på alle gårde, som du har brug for den. Det systemet regler har objektet allerede oprettet og kun har en mulig konfiguration. Når du er konfigureret, skal du aktivere den.

Farm DoS regler

Det er nødvendigt at oprette et objekt før at anvende en regel på en gård.

limitsec

Begrænsning af ny forbindelse pr. Sekund og kilde. Kun tilgængelig på gårde arbejder med TCP-protokollen.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.
begrænse	nummer	Det er maksimalt antal nye forbindelser per sekund for en kilde.
limit_burst	nummer	Det er en tilladt top af nye forbindelser. En burst-enhed regenereres, når "grænse" sekunder passerer.

limitconns

Begræns totalstrømforbindelser pr. Kilde. Kun tilgængelig på gårde arbejder med TCP-protokollen.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.
limit_conns	nummer	Det er maksimalt antal nuværende forbindelse fra en kilde.

bogustcpflags

Check TCP-protokollen respekteres. Denne regel har ikke konfigurationsparametre, så der kun oprettes en genstand, du kan bruge på alle gårde. Kun tilgængelig på gårde arbejder med TCP-protokollen.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.

limitrst

Begræns antal nulstillingsforespørgsler pr. Sekund. Kun tilgængelig på gårde arbejder med TCP-protokollen.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.
begrænse	nummer	Det er maksimalt antal nulstillingsforespørgsler pr. Sekund for en kilde.
limit_burst	nummer	Det er en tilladt top for nulstillingsanmodning. En burst-enhed regenereres, når "grænse" sekunder passerer.

System DoS regler

I systemets DoS-regler er objektet ikke blevet oprettet.

sshbruteforce

Grænsen for den nye ssh-forbindelse.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator. Identifikatoren er defineret som ssh_brute_force.
hits	nummer	Antal hits for kilde før, end forbindelserne er blokeret.
tid	nummer	Tid i sekunder for at nulstille hits tæller.
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

dropicmp

Systemet taber icmp-anmodningen.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator. Identifikatoren er defineret som drop_icmp.
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

Angiv alle typer DoS-regler

Angiv alle typer DoS-regler

Forespørgselseksempel:

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

GET /ipds/dos/rules

Vis en liste over DoS regler. De er ikke objekt, men typer til at definere det.

Hver regel har forskellige konfigurationsparametre

Svar eksempel:

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

Response parametre

JSON-responsen har to arrays gård systemet. Hvert array-element er en type regel, der skal gælde for en gård o systemet.

Field	Type	Beskrivelse
beskrivelse	String	Kort beskrivelse af reglen.
regere	String	type regel unik identifikator.

Liste over alle DoS regler

Liste over alle DoS-objekter

Forespørgselseksempel:

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

GET /ipds/dos

Vis konfiguration for alle eksisterende DoS-objekter.

Svar eksempel:

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

Response parametre

Svaret er et array med alle tilgængelige DoS-objekter.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.
regere	String	Det er typen regelidentifikator.
typen	String	De mulige værdier er: gård, reglen gælder for bedrifter; eller systemet, reglen gælder for systemet.

Afhængigt af reglen, indeholder objektet de næste parametre

limitsec

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
begrænse	nummer	Det er maksimalt antal nye forbindelser per sekund for en kilde.
limit_burst	nummer	Det er en tilladt top af nye forbindelser. En burst-enhed regenereres, når "grænse" sekunder passerer.

limitconns

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
limit_conns	nummer	Det er maksimalt antal nuværende forbindelse fra en kilde.

bogustcpflags

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.

limitrst

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
begrænse	nummer	Det er maksimalt antal nulstillingsforespørgsler pr. Sekund for en kilde.
limit_burst	nummer	Det er en tilladt top for nulstillingsanmodning. En burst-enhed regenereres, når "grænse" sekunder passerer.

sshbruteforce

Field	Type	Beskrivelse
hits	nummer	Antal hits for kilde før, end forbindelserne er blokeret.
tid	nummer	Tid i sekunder for at nulstille hits tæller.
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

dropicmp

Field	Type	Beskrivelse
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

Hent en DoS-regel

Hent en DoS-regel

Forespørgselseksempel for landbrugsregel:

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

Forespørgselseksempel for systemregel:

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

GET /ipds/dos/<name>

Hvert DoS-objekt kan have en anden konfiguration. navn er DoS-regelens unikke identifikator.

Svareksempel for landbrugsregel:

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

Svareksempel for systemregel:

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

Response parametre

Svaret er et array med alle tilgængelige DoS-objekter.

Field	Type	Beskrivelse
navn	String	Det er objektreglen unik identifikator.
regere	String	Det er typen regelidentifikator.
typen	String	De mulige værdier er: gård, reglen gælder for bedrifter; eller systemet, reglen gælder for systemet.

Afhængigt af reglen, indeholder objektet de næste parametre

limitsec

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
begrænse	nummer	Det er maksimalt antal nye forbindelser per sekund for en kilde.
limit_burst	nummer	Det er en tilladt top af nye forbindelser. En burst-enhed regenereres, når "grænse" sekunder passerer.

limitconns

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
limit_conns	nummer	Det er maksimalt antal nuværende forbindelse fra en kilde.

bogustcpflags

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.

limitrst

Field	Type	Beskrivelse
gårde	Snor[]	Gårde hvor reglen anvendes.
begrænse	nummer	Det er maksimalt antal nulstillingsforespørgsler pr. Sekund for en kilde.
limit_burst	nummer	Det er en tilladt top for nulstillingsanmodning. En burst-enhed regenereres, når "grænse" sekunder passerer.

sshbruteforce

Field	Type	Beskrivelse
hits	nummer	Antal hits for kilde før, end forbindelserne er blokeret.
tid	nummer	Tid i sekunder for at nulstille hits tæller.
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

dropicmp

Field	Type	Beskrivelse
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

Opret en DoS-regel

Opret en DoS-regel

Forespørgselseksempel:

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

POST /ipds/dos

Opret et DoS-objekt for at bruge det som gårde, som det er nødvendigt.

Hvert DoS-objekt kan have en anden konfiguration.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
navn	String	Det er objektreglen unik identifikator.	sand
regere	String	Det er typen regelidentifikator. Indstillingerne er: limitconns, limitsec, limitrst or bogustcpflags.	sand

Svar eksempel:

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

Response parametre

Svaret vil være en json med standardkonfigurationen for den oprettede regel. Se svareksempel for mere information.

Ændre en DoS-regel

Ændre en DoS-regel

Forespørgselseksempel:

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

PUT /ipds/dos/<name>

Ændre en DoS-regel. navn er DoS-regelens unikke identifikator.

Anmod om parametre

Hver type regel kan være forskellige parametre. De modificerbare parametre er de næste:

limitsec

Field	Type	Beskrivelse
begrænse	nummer	Det er maksimalt antal nye forbindelser per sekund for en kilde.
limit_burst	nummer	Det er en tilladt top af nye forbindelser. En burst-enhed regenereres, når "grænse" sekunder passerer.

limitconns

Field	Type	Beskrivelse
limit_conns	nummer	Det er maksimalt antal nuværende forbindelse fra en kilde.

bogustcpflags

Nej har parametre.

limitrst

Field	Type	Beskrivelse
begrænse	nummer	Det er maksimalt antal nulstillingsforespørgsler pr. Sekund for en kilde.
limit_burst	nummer	Det er en tilladt top for nulstillingsanmodning. En burst-enhed regenereres, når "grænse" sekunder passerer.

sshbruteforce

Field	Type	Beskrivelse
hits	nummer	Antal hits for kilde før, end forbindelserne er blokeret.
tid	nummer	Tid i sekunder for at nulstille hits tæller.
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

dropicmp

Field	Type	Beskrivelse
status	String	Vis regelstatusen, de mulige værdier er: up systemet falder icmp anmodninger; eller ned systemet tillader icmp anmodninger.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Slet en DoS-regel

Slet en DoS-regel

Forespørgselseksempel:

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

DELETE /ipds/dos/<name>

Systemregler kan ikke slettes. For at deaktivere den skal du sætte statusen til ned. navn er DoS-regelens unikke identifikator.

Svar eksempel:

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

Systemkrav

System muligheder giver dig mulighed for at personalisere de tjenester, der kører i balanceren og de globale parametre.

Vis version

Vis version

Forespørgselseksempel:

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

GET /system/version

Vis informacion om produktversionen.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
appliance_version	String	Ansøgningsversion. Vis også hypervisor, hvis det er en virtuel maskine.
hostname	String	Værtsnavn.
kernel_version	String	Linux kernel version.
system_date	String	System dato.
zevenet_version	String	Zevenet version.

Vis DNS

Vis DNS

Forespørgselseksempel:

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

GET /system/dns

Vis DNS-servicekonfigurationen.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
primære	String	Primær DNS konfigureret i systemet.
sekundær	String	Sekundær DNS konfigureret i systemet.

Ændre DNS

Ændre DNS

Forespørgselseksempel:

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

POST /system/dns

Rediger DNS-tjeneste konfiguration.

Anmod om parametre

Field	Type	Beskrivelse
primære	String	Primær DNS konfigureret i systemet.
sekundær	String	Sekundær DNS konfigureret i systemet.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Vis SSH

Vis SSH

Forespørgselseksempel:

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

GET /system/ssh

Vis SSH-servicekonfigurationen.

Anmod om parametre

Field	Type	Beskrivelse
lytte	String	IP-system, hvor SSH-tjenesten lytter. Det Karakter * bruges til at lytte i alle konfigurerede IP'er.
port	String	Port konfigureret til SSH service.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Ændre SSH

Ændre SSH

Forespørgselseksempel:

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

POST /system/ssh

Rediger SSH-servicekonfigurationen.

Anmod om parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
lytte	String	IP-system, hvor SSH-tjenesten lytter. Det Karakter * bruges til at lytte i alle konfigurerede IP'er.
port	String	Port konfigureret til SSH service.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Vis SNMP

Vis SNMP

Forespørgselseksempel:

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

GET /system/snmp

Vis SNMP-servicekonfigurationen.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
samfund	String	Gruppenavn. Læs kun Fællesskabet, der bruges.
ip	String	Interface IP, hvor SNMP-tjenesten kører. Det er sikkert at holde alle grænseflader aktiveret ved hjælp af Karakter *.
port	String	Port, hvor SNMP-tjenesten kører.
rækkevidde	String	IP eller subnet med adgang (IP / bit). Tilladte klient-IP'er til at tilgå SNMPD-tjeneste, hvis du kun vil tillade adgang til en IP, skal du bruge bit "/ 32".
status	String	Status for SNMP-tjeneste. De mulige værdier er: sandtjenesten kører; eller falsk, tjenesten stoppes.

Rediger SNMP

Rediger SNMP

Forespørgselseksempel:

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

POST /system/snmp

Rediger SNMP-tjenestekonfigurationen.

Anmod om parametre

Field	Type	Beskrivelse
samfund	String	Gruppenavn. Læs kun Fællesskabet, der bruges.
ip	String	Interface IP, hvor SNMP-tjenesten kører. Det er sikkert at holde alle grænseflader aktiveret ved hjælp af Karakter *.
port	String	Port, hvor SNMP-tjenesten kører.
rækkevidde	String	IP eller subnet med adgang (IP / bit). Tilladte klient-IP'er til at tilgå SNMPD-tjeneste, hvis du kun vil tillade adgang til en IP, skal du bruge bit "/ 32".
status	String	Status for SNMP-tjeneste. De mulige værdier er: sandtjenesten kører; eller falsk, tjenesten stoppes.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Hent licens

Hent licens

Forespørgselseksempel:

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

GET /system/license/<format>

Vis Zevenet-licensen i et format. Den tilgængelige format værdier er html or txt.

Vis NTP

Vis NTP

Forespørgselseksempel:

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

GET /system/ntp

Vis konfigurationen af NTP-tjenesten.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
server	String	Server hvor NTP-klient gør anmodningerne.

Rediger NTP

Rediger NTP

Forespørgselseksempel:

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

POST /system/ntp

Rediger konfigurationen af NTP-tjenesten.

Anmod om parametre

Field	Type	Beskrivelse
server	String	Server hvor NTP-klient gør anmodningerne.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Vis HTTP-server

Vis HTTP-server

Forespørgselseksempel:

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

GET /system/http

Vis HTTP-servicekonfigurationen. Det er her Zevenet API og GUI kører.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med nedenstående parametre.

Field	Type	Beskrivelse
ip	String	IP, hvor HTTP-serveren lytter. Det Karakter * bruges til at lytte i alle konfigurerede IP'er.
port	String	Port, hvor HTTP-tjenesten lytter.

Ændre HTTP-server

Ændre HTTP-server

Forespørgselseksempel:

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

POST /system/http

Ændre HTTP-tjenesten konfiguration.

Anmod om parametre

Field	Type	Beskrivelse
ip	String	IP, hvor HTTP-serveren lytter. Det Karakter * bruges til at lytte i alle konfigurerede IP'er.
port	String	Port, hvor HTTP-tjenesten lytter.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Liste over alle brugere

Liste over alle brugere

Forespørgselseksempel:

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

GET /system/users

Angiv de tilgængelige brugere i systemet.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en række af nedenstående parametre.

Field	Type	Beskrivelse
status	String	Brugerstatus. De mulige værdier er: sand, brugeren er aktiveret; eller ikke falsk, er brugeren desaktiveret.
bruger	String	Brugernavn.

Hent zapi-brugeren

Hent zapi-brugeren

Forespørgselseksempel:

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

GET /system/users/zapi

Vis zapi-brugerkonfigurationen. Disse parametre er nødvendige for at få adgang til Zevenet-tjenester gennem zapi.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON objekt med en række af nedenstående parametre.

Field	Type	Beskrivelse
nøgle	String	Nøgle til at godkende i zapi. Dette er parameteren ZAPI_KEY bruges i opkald til zapi.
status	String	Zapi brugerstatus. Hvis dens værdi er sand, det er muligt at anvende zapi; eller ikke falsk, zapi er desaktiveret, og det er ikke muligt at sende den anmodning.

Rediger zapi brugerkonfiguration

Rediger zapi brugerkonfiguration

Forespørgselseksempel:

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

POST /system/users/zapi

Rediger zapi-brugerkonfigurationen. Disse parametre er nødvendige for at få adgang til Zevenet-tjenester gennem zapi.

Anmod om parametre

Field	Type	Beskrivelse
nøgle	String	Nøgle til at godkende i zapi. Dette er parameteren ZAPI_KEY bruges i opkald til zapi.
nyt kodeord	String	Ny adgangskode til zapi-bruger.
status	String	Zapi brugerstatus. Hvis dens værdi er sand, det er muligt at anvende zapi; eller ikke falsk, zapi er desaktiveret, og det er ikke muligt at sende den anmodning.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Rediger rodadgangskode

Rediger rodadgangskode

Forespørgselseksempel:

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

POST /system/users/root

Rediger rodadgangskoden. Denne bruger bruges til at få adgang til syv tjenester via GUI

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
adgangskode	String	Nuværende root brugeradgangskode.	sand
nyt kodeord	String	Nyt kodeord til root-bruger.	sand

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Liste logfiler

Liste logfiler

Forespørgselseksempel:

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

GET /system/logs

Angiv de tilgængelige logfiler.

Svar eksempel:

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

Response parametre

Svaret vil være et JSON med en række logfiler. Parametrene for hvert objekt er:

Field	Type	Beskrivelse
dato	String	Datoen for den sidste filændring.
fil	String	Filnavn på logfiler. Den bruges som log unik identifikator.

Download en logfil

Download en logfiler

Forespørgselseksempel:

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

GET /system/logs/<file>

Download en logfil af de tilgængelige logfiler, der er angivet under GET-anmodningen.

fil er logfilens unikke identifikator.

System - Backups

Med Backup-indstillingen kan du gemme den nuværende systemkonfiguration og downloade den.

I dette afsnit vil du kunne oprette, gendanne, uploade og downloade backupfiler.

Liste backups

Liste backups

Forespørgselseksempel:

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

GET /system/backup

Svar eksempel:

{
   "description" : "Get backups",
   "params" : [
      {
         "date" : "Fri Feb  3 06:01:04 2017",
         "name" : "newbackup"
      },
      {
         "date" : "Fri Feb  3 05:50:48 2017",
         "name" : "firstConf"
      }
   ]
}

Response parametre

Svaret vil være en JSON med en række sikkerhedskopier. Parametrene for hvert arrayelement er:

Field	Type	Beskrivelse
dato	String	Datoen for den sidste ændring.
navn	String	Det er filnavnet, der bruges som en unik identifikator. Filforlængelsen er `.tar.gz`.

Opret en sikkerhedskopi

Opret en sikkerhedskopi

Forespørgselseksempel:

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

POST /system/backup

Opret en systemkonfigurationskopi af den nuværende konfiguration.

Anmod om parametre

Field	Type	Beskrivelse
navn	String	Det er filnavnet, der bruges som en unik identifikator. Filforlængelsen er `.tar.gz`.

Svar eksempel:

{
   "description" : "Create a backups",
   "message" : "Backup firstConf was created successful.",
   "params" : "firstConf"
}

Download en sikkerhedskopi

Download en sikkerhedskopi

Forespørgselseksempel:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
 https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf > ~/zevenetConf.tar.gz

Backupfilen er i TAR GZ-format.

GET /system/backup/<name>

Download en systemkonfigurationskopi. navn er den backup unikke identifikator.

Upload en sikkerhedskopi

Upload en sikkerhedskopi

Forespørgselseksempel:

curl -k -X PUT -H 'Content-Type: text/plain' 
--data-binary @/opt/1mar.tar.gz -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/newbackup

PUT /system/backup/<name>

Upload en lokal gemt backup til Zevenet. navn er den backup unikke identifikator, som vil blive gemt i Zevenet.

Anmod om parametre

Det er nødvendigt at bruge –data-binær for at uploade en sikkerhedskopi.

Svar eksempel:

{
   "description" : "Upload a backup",
   "message" : "Backup newbackup was created successful.",
   "params" : "newbackup"
}

Slet en sikkerhedskopi

Slet en sikkerhedskopi

Forespørgselseksempel:

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

DELETE /system/backup/<name>

Slet en sikkerhedskopieringsfil fra Zevenet-systemet. navn er den backup unikke identifikator.

Svar eksempel:

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

Anvend en sikkerhedskopi

Anvend en sikkerhedskopi

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"apply"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf/actions

POST /system/backup/<name>/actions

Gendan konfigurationen fra en backup-fil. navn er den backup unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	For at gendanne sikkerhedskonfigurationen skal værdien være ansøge.

Svar eksempel:

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

System - Notifikationer

Meddelelser er dannet af to elementer: Sender metode og type af alert.

I advarselssektionen kan du vælge hvilken type alarm du ønsker at modtage. Faktisk er advarslerne fokuseret i backend eller cluster status, så balanceren sender en besked, hvis nogle skifter.

I metode sektionen kan du vælge, hvilken afsender der skal bruges, når Zevenet skal sende en anmeldelse.

Vis advarselsstatus

Vis advarselsstatus

Forespørgselseksempel:

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

GET /system/notifications/alerts

Angiv alle typer advarsler med deres status.

Svar eksempel:

{
   "description" : "Get notifications alert status",
   "params" : [
      {
         "alert" : "backends",
         "status" : "disabled"
      },
      {
         "alert" : "cluster",
         "status" : "disabled"
      }
   ]
}

Response parametre

Field	Type	Beskrivelse
alert	String	Type alarm, den bruges som alarm unik identifikator. De tilgængelige advarsler er: backend, underrette, når en backend ændrer status; eller klynge, send en besked, når klyngemesterknuden skifter til anden knudepunkt.
status	String	Vis om varsling er deaktiveret, systemet sender ikke besked, når der er en begivenhed; eller aktiveret, sender systemet en advarsel, når det registreres en ændret status.

Hent meddelelsesvarsler

Hent meddelelsesvarsler

Forespørgselseksempel:

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

GET /system/notifications/alerts/<alert>

Vis konfigurationen om en type alarm.

alert er den advarsel unikke identifikator.

Svar eksempel:

{
   "description" : "Get notifications alert backends settings",
   "params" : {
      "avoidflappingtime" : 5,
      "prefix" : "",
      "status" : "disabled"
   }
}

Response parametre

Field	Type	Beskrivelse
avoidflappingtime	nummer	Nogle gange er backends tilgængelige eller ikke på kort tid, dette område tillader at konfigurere en tidsperiode for at undgå beskedmeddelelser, mens backend ændrer status, når denne tidsperiode slutter, hvis den backend-status det er anderledes at starte, så Meddelelsen er sendt.
præfiks	String	Det er et præfiks for e-mail-emnet, der sendes af systemet til denne form for advarsel.
status	String	Vis om varsling er deaktiveret, systemet sender ikke besked, når der er en begivenhed; eller aktiveret, sender systemet en advarsel, når det registreres en ændret status.

Rediger underretningsadvarsel

Rediger underretningsadvarsler

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
{"avoidflappingtime":10,"prefix":"[backend alert]"} 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends

POST /system/notifications/alerts/<alert>

alert er den advarsel unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
avoidflappingtime	nummer	Nogle gange er backends tilgængelige eller ikke på kort tid, dette område tillader at konfigurere en tidsperiode for at undgå beskedmeddelelser, mens backend ændrer status, når denne tidsperiode slutter, hvis den backend-status det er anderledes at starte, så Meddelelsen er sendt. Denne parameter er ikke i klyngealarm, klynge har sin egen swich-tid.
præfiks	String	Det er et præfiks for e-mail-emnet, der sendes af systemet til denne form for advarsel.

Svar eksempel:

{
   "description" : "Set notifications alert backends",
   "params" : {
      "avoidflappingtime" : 10,
      "prefix" : "[backend alert]"
   }
}

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Aktivér advarsler

Aktivér advarsler

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
{"action":"enable"} 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends/actions

POST /system/notifications/alerts/<alert>/actions

Aktivér eller deaktiver meddelelserne for en type alarm.

alert er den advarsel unikke identifikator.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	De handlinger, der er tilgængelige for advarsler, er deaktiveret, systemet sender ikke besked, når der er en begivenhed; eller aktiveret, sender systemet en advarsel, når det registreres en ændret status.

Svar eksempel:

{
   "description" : "Set notifications alert backends actions",
   "params" : {
      "action" : "enable"
   }
}

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Hent email konfiguration

Hent email konfiguration

Forespørgselseksempel:

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

GET /system/notifications/methods/email

Vis alle konfigurationer af e-mail afsender.

Bemærk: SMTP-port, der bruges til afsendelse af e-mails, er TCP 25, selvom TLS er aktiveret.

Svar eksempel:

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

Response parametre

Field	Type	Beskrivelse
fra	String	E-mail-konto, der sender e-mailen, vises denne konto i SMTP-overskriften Fra: og den bliver brugt, hvis modtageren svarer på e-mailen.
metode	String	Det er metoden unikt identifikator. Faktisk er den tilgængelige metode e-mail.
adgangskode	String	Adgangskode til bruger SMTP-konto, er denne adgangskode nødvendig, hvis serveren kræver SMTP-godkendelse.
server	String	SMTP server via e-mailen er sendt.
tls	String	Aktivér TLS-validering for at sende e-mail, denne ejendom bruger STARTTLS, og denne funktion skal understøttes i SMTP-serveren. Nogle SMTP-servere kræver aktivering af det. De mulige værdier er: sand, TLS-validering er aktiveret til afsendelse af e-mail; eller falsk, afsendelse af e-mail bruger ikke TLS-validering.
til	String	E-mail-konto, der modtager e-mailen, vises denne konto i SMTP-overskriften Til.
bruger	String	E-mail-konto tilladt at sende e-mails, er denne konto nødvendig, hvis serveren kræver SMTP-godkendelse.

Rediger email konfiguration

Rediger email konfiguration

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json'  -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"from":"user@zevenet.com","password":"verystrongpass","server":"smtp.gmail.com","to":"adminuser@zevenet.net","tls":"true","user":"user@zevenet.com"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email

POST /system/notifications/methods/email

Rediger konfigurationen af e-mail afsender metode.

Anmod om parametre

Field	Type	Beskrivelse
fra	String	E-mail-konto, der sender e-mailen, vises denne konto i SMTP-overskriften Fra: og den bliver brugt, hvis modtageren svarer på e-mailen.
adgangskode	String	Adgangskode til bruger SMTP-konto, er denne adgangskode nødvendig, hvis serveren kræver SMTP-godkendelse.
server	String	SMTP server via e-mailen er sendt.
tls	String	Aktivér TLS-validering for at sende e-mail, denne ejendom bruger STARTTLS, og denne funktion skal understøttes i SMTP-serveren. Nogle SMTP-servere kræver aktivering af det. De mulige værdier er: sand, TLS-validering er aktiveret til afsendelse af e-mail; eller falsk, afsendelse af e-mail bruger ikke TLS-validering.
til	String	E-mail-konto, der modtager e-mailen, vises denne konto i SMTP-overskriften Til.
bruger	String	E-mail-konto tilladt at sende e-mails, er denne konto nødvendig, hvis serveren kræver SMTP-godkendelse.

Svar eksempel:

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

Response parametre

Svaret bliver en json med alle ønskede værdier opdateret. Se svareksempel for mere information.

Send en test mail

Send en test mail

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json'  -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"test"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email/actions

POST /system/notifications/methods/email/actions

Send en test mail med e-mail-konfigurationen for at teste den.

Anmod om parametre

Field	Type	Beskrivelse
Action	String	Værdien til at sende en testmail er prøve.

Svar eksempel:

{
   "description" : "Send test mail",
   "message" : "Test mail sent successful.",
   "success" : "true"
}

Download en supportsave

Download en supportsave

Forespørgselseksempel:

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

GET /system/supportsave

Få systemstatusbillede med alle konfigurationer og processer, der kører i systemet. Denne understøttelse er nødvendigt for at finde problemer eller støttehjælp.

System - Cluster

Klyngen er elementet udført af en master node, at den styrer forbindelserne fordward backends, og en backup node kontrollerer master, det er parat til at swich til master node, hvis det går til down status.

Når der er status skiftet, gendanner backup-noden alle forbindelsesstatus i sig selv. Så klienten opdager ikke en afbrydelse i tjenesten.

Dette laver belastningsbalanceren i høj tilgængelighed. Så hvis der er noget problem i en Zevenet, vil tjenesten fortsætte med at arbejde med den uploadede konfiguration.

Vis klyngekonfigurationen

Vis klyngekonfigurationen

Forespørgselseksempel:

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

GET /system/cluster

Vis alle konfigurationer om klyngen.

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

Response parametre

Svaret vil være et JSON objekt med klyngekonfigurationen og en matrix med noderne i den.

Klusterobjekt:

Field	Type	Beskrivelse
check_interval	nummer	Det er ventetiden mellem to kontroller af master node status.
failback	String	Hvilken knude har præference at være herre. Værdierne kan være a navn node, for at give præference til en node; eller deaktiveret, hvis nogen node kan være mester og ikke er prioriteret for en.
grænseflade	String	Interface, hvor nodens IP er konfigureret.
noder	Objekt[]	Klyngens noder.

Node Object:

Field	Type	Beskrivelse
ip	String	Det er IP konfigureret i noden for at kontrollere nodens status og for at gøre informationsreplikationen.
navn	String	Det er nodens værtsnavn, og det bruges som nodens unikke identifikator.
node	String	De mulige værdier er: lokale, hvis node er, som modtager zapi-anmodningen; eller fjern, hvis er den anden node konfigureret i klynge.

Aktivér en klynge

Aktivér en klynge

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"local_ip":"192.168.100.241","remote_ip":"192.168.100.240","remote_password":"admin"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

POST /system/cluster

Lav en klynge, der kommunikerer to balancere.

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
remote_ip	String	IP af fjernværten bruges til klyngen.	sand
local_ip	String	IP af lokal vært brugt til klyngen.	sand
remote_password	String	Root brugeradgangskode til fjernbalancer.	sand

Response Body:

{
   "description" : "Enabling cluster",
   "message" : "Cluster enabled successfully",
   "success" : "true"
}

Ændring af klyngekonfiguration

Ændring af klyngekonfiguration

Forespørgselseksempel:

curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"check_interval":4,"failback":"disabled"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

PUT /system/cluster

Konfigurer arbejdsmodusparametre for klynge.

Anmod om parametre

Field	Type	Beskrivelse
check_interval	nummer	Det er ventetiden mellem to kontroller af master node status.
failback	String	Hvilken knude har præference at være herre. Værdierne kan være a navn node, for at give præference til en node; eller deaktiveret, hvis nogen node kan være mester og ikke er prioriteret for en.

Response Body:

{
   "description" : "Modifying the cluster configuration",
   "params" : {
      "check_interval" : "4",
      "failback" : "disabled"
   }
}

Deaktiver klyngen

Deaktiver klyngen

Forespørgselseksempel:

curl -k -X DELETE -H 'Content-Type: application/json' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster

DELETE /system/cluster

Fjern klyngen.

Response Body:

{
   "description" : "Disabling cluster",
   "message" : "Cluster disabled successfully",
   "success" : "true"
}

Vedligeholdelsestilstand

Vedligeholdelsestilstand

Forespørgselseksempel:

curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
-d '{"action":"maintenance","status":"enable"}' 
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/actions

POST /system/cluster/actions

Skift den lokale klyngenode til vedligeholdelsestilstand.

Response Body:

{
   "description" : "Setting maintenance mode",
   "message" : "Local cluster node changed to maintenance mode successfully",
   "success" : "true"
}

Anmod om parametre

Field	Type	Beskrivelse	påkrævet
Action	String	Handling til anvendelse på klyngen. Den tilgængelige handling er vedligeholdelse.	sand
status	String	Status til at sætte noden, de mulige værdier er muliggøre, læg det i vedligeholdelsestilstand eller deaktivere, sæt noden til rådighed.	sand

Vis nodestatus

Vis nodestatus

Forespørgselseksempel:

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

GET /system/cluster/nodes

Vis status for alle knudepunkter.

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

Response parametre

Svaret bliver en JSON med nøgle param og værdi en række node status objekt.

Node status objekt

Field	Type	Beskrivelse
ip	String	Det er IP konfigureret i noden for at kontrollere nodens status og for at gøre informationsreplikationen.
navn	String	Det er nodens værtsnavn, og det bruges som nodens unikke identifikator.
node	String	De mulige værdier er: lokale, hvis node er, som modtager zapi-anmodningen; eller fjern, hvis er den anden node konfigureret i klynge.
besked	String	Beskrivende besked, der angiver status og driftstilstand for noden.
rolle	String	Faktisk arbejdsmodus af denne knudepunkt. De mulige værdier er: Master, denne knude styrer forbindelserne mellem backends og klienter; eller backup, denne knude har svaret mesterstatusforbindelser og masterkonfiguration, og det kontrollerer, at mastertjenesten fungerer.
status	String	Angiv, om en vis klyngeproces fejler.

Vis lokalhost cluster status

Vis lokalhost cluster status

Forespørgselseksempel:

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

GET /system/cluster/nodes/localhost

Vis status for lokal node.

Response Body:

{
   "description" : "Cluster status for localhost",
   "params" : {
      "message" : "Node online and active",
      "name" : "canoDEV4100",
      "role" : "master",
      "status" : "ok"
   }
}

Response parametre

Field	Type	Beskrivelse
besked	String	Beskrivende besked, der angiver status og driftstilstand for noden.
navn	String	Det er nodens værtsnavn, og det bruges som nodens unikke identifikator.
rolle	String	Faktisk arbejdsmodus af denne knudepunkt. De mulige værdier er: Master, denne knude styrer forbindelserne mellem backends og klienter; eller backup, denne knude har svaret mesterstatusforbindelser og masterkonfiguration, og det kontrollerer, at mastertjenesten fungerer.
status	String	Angiv, om en vis klyngeproces fejler.