NAV Navbar
Logo
Shell

Zevenet Community Edition API v3.1

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.1 / zapi.cgi / (URI_path), hvor zevenet_server er den IP, hvor HTTP-tjenesten lytter.

URI_path definerer objektet eller handlingen. Hans opførsel og hans parametre vil blive defineret inden for hver enkelt dokumentsektion.

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.1/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.1/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

Slet et certifikat

Slet et certifikat

Forespørgselseksempel:

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

DELETE /certificates/<file>

Slet et certifikat efter filnavn i certifikatbutikken.

Svar eksempel:

{
   "description" : "Delete certificate",
   "message" : "The Certificate example.pem 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.1/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.1/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"
}

Liste Cipherer

Liste Cipherer

Forespørgselseksempel:

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

GET /ciphers

Angiv de tilgængelige cifre, som en HTTPS-gård kan bruge.

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" : "Get the ciphers available",
   "params" : [
      {
         "ciphers" : "all",
         "description" : "All"
      },
      {
         "ciphers" : "highsecurity",
         "description" : "High security"
      },
      {
         "ciphers" : "customsecurity",
         "description" : "Custom security"
      }
   ]
}

Response parametre

Field Type Beskrivelse
params Objekt [] Liste over certifikatobjekter.

Certifikatobjekt

Field Type Beskrivelse
ciphers String Den bruges som unik identifikator.
beskrivelse String Venligt navn.

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

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.1/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 for LSLB modul og data link til DSLB modul
status String Farm status. De tilgængelige statusværdier er: nedgården går ikke; nødvendige genstart, gården er op, men den afventer en genstart kritisk, gården er op og alle backends er uopnåelige eller vedligeholdelse; problem, gården er op, og der er noget backend unreachable, men næsten en backend er i up status; vedligeholdelse, gården er op, og der er backends in up status, men næsten en backend er i vedligeholdelsestilstand; up, gården er op og alle backends arbejder succes.
vip String Virtual IP hvor gården modtager trafik
VPort String Virtuel port, hvor gården modtager trafik, de tilgængelige portværdier er: et portnummer for http [s] og l4xnat, en gruppe af porte adskilt af “,” eller et portområde adskilt af “:” for l4xnat-profiler, i l4xnat begge separator værdier (“,” og “:”) kan bruges i det 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.1/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.1/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 layer 7 load balancing. 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.1/zapi.cgi/farms/httpFarm

GET /farms/<farmname>

Vis alle konfigurationer om en given gård.

Svar eksempel:

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

Response parametre

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

Farm Object:

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

Parametre objekt for HTTP gårde:

Field Type Beskrivelse
certlist Objekt[] Kun i https profil. Certifikat aktiveret i gården, i pem format, er det tilladt at tilføje kun ét pem certifikat til samme gård. lytter med https værdi er påkrævet. Enhver pem 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, alle cifre vil 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.
disable_sslv2 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af SSL-sikkerhedsprotokol med version 2 er ikke tilladt eller falsk hvis protokollen SSLv2 er tilladt.
disable_sslv3 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af SSL-sikkerhedsprotokol med version 3 er ikke tilladt eller falsk hvis protokollen SSLv3 er tilladt.
disable_tlsv1 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1 er ikke tilladt eller falsk hvis protokollen TLSv1 er tilladt.
disable_tlsv1_1 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1.1 er ikke tilladt eller falsk hvis protokollen TLSv1.1 er tilladt.
disable_tlsv1_2 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1.2 er ikke tilladt eller falsk hvis protokollen TLSv1.2 er tilladt.
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 tilgængelige statusværdier er: nedgården går ikke; nødvendige genstart, gården er op, men den afventer en genstart kritisk, gården er op og alle backends er uopnåelige eller vedligeholdelse; problem, gården er op, og der er noget backend unreachable, men næsten en backend er i up status; vedligeholdelse, gården er op, og der er backends in up status, men næsten en backend er i vedligeholdelsestilstand; up, gården er op og alle backends arbejder succes.
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.

Servicesobjekt for HTTP-bedrifter:

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 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. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.
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.1/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" : {
      "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,"ignore_100_continue":"true",
"restimeout":47,"resurrectime":12,"reqtimeout":32,"rewritelocation":"enabled","httpverb":"standardHTTP", 
"error414":"Message error 414","error500":"Message error 500","error501":"Message error 501", 
"error503":"Message error 503","listener":"https","ciphers":"customsecurity","disable_sslv2":"true",
"disable_sslv3":"false","disable_tlsv1":"false","disable_tlsv1_1":"true","disable_tlsv1_2":"false",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/FarmHTTP 

PUT /farms/<farmname>

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.
disable_sslv2 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af SSL-sikkerhedsprotokol med version 2 er ikke tilladt eller falsk hvis protokollen SSLv2 er tilladt.
disable_sslv3 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af SSL-sikkerhedsprotokol med version 3 er ikke tilladt eller falsk hvis protokollen SSLv3 er tilladt.
disable_tlsv1 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1 er ikke tilladt eller falsk hvis protokollen TLSv1 er tilladt.
disable_tlsv1_1 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1.1 er ikke tilladt eller falsk hvis protokollen TLSv1.1 er tilladt.
disable_tlsv1_2 String Kun i https-lytteren. Hvis dette felt har værdien sand forbindelserne ved hjælp af TLS-sikkerhedsprotokol med version 1.2 er ikke tilladt eller falsk hvis
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 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, alle cifre vil 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,
      "disable_sslv2" : "true",
      "disable_sslv3" : "false",
      "disable_tlsv1" : "false",
      "disable_tlsv1_1" : "true",
      "disable_tlsv1_2" : "false",
      "error414" : "Message error 414",
      "error500" : "Message error 500",
      "error501" : "Message error 501",
      "error503" : "Message error 503",
      "httpverb" : "standardHTTP",
      "listener" : "https",
      "newfarmname" : "FarmHTTP",
      "reqtimeout" : 32,
      "restimeout" : 47,
      "resurrectime" : 12,
      "rewritelocation" : "enabled",
      "vip" : "178.62.126.152",
      "vport" : 88
   }
}

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.1/zapi.cgi/farms/httpFarm/certificates

POST /farms/<farmname>/certificates

Skift PEM-certifikatet for en HTTP-bedrift 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 farm httpFarm, you need restart the farm to apply",
   "success" : "true",
   "status": "needed restart"
}

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.

Hent service med ID

Hent service med ID

Forespørgselseksempel:

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

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

Vis alle konfigurationer om en given tjeneste.

Svar eksempel:

{
   "description" : "Get services of a farm",
   "services" : {
      "backends" : [
         {
            "id" : 0,
            "ip" : "192.168.100.254",
            "port" : 80,
            "status" : "up",
            "timeout" : 20,
            "weight" : null
         },
         {
            "id" : 0,
            "ip" : "192.168.100.254",
            "port" : 80,
            "status" : "up",
            "timeout" : null,
            "weight" : null
         }
      ],
      "fgenabled" : "false",
      "fglog" : "false",
      "fgscript" : "check_tcp -H HOST -p PORT",
      "fgtimecheck" : 5,
      "httpsb" : "false",
      "id" : "serv",
      "leastresp" : "false",
      "persistence" : "COOKIE",
      "redirect" : "",
      "redirecttype" : "",
      "sessionid" : "JSESSIONID",
      "ttl" : 18,
      "urlp" : "(?i)^/music$",
      "vhost" : ""
   }
}

Response parametre

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

Servicesobjekt for HTTP-bedrifter:

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 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. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.
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 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.1/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.1/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.
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" : [],
      "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.1/zapi.cgi/farms/FarmHTTP/fg

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.

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

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.1/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.1/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 Unik 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. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.

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.1/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.1/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

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.

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","mode":"cut"}'
 https://<zenlb_server>:444/zapi/v3.1/zapi.cgi/farms/httpfarm/services/newsrv/backends/0/maintenance

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

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 påkrævet
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. sand
tilstand String Vælg en vedligeholdelsestilstand. De tilgængelige muligheder er: dræne, backend accepterer ikke nye forbindelser, men den vil fortsat håndtere de nuværende forbindelser; eller skære, de aktuelle forbindelser vil blive lukket. Hvis dette felt ikke er angivet, vil standardindstillingen være dræne.

Svar eksempel:

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

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.1/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.1/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",
         "max_conns" : 0,
         "port" : "88",
         "priority" : 2,
         "status" : "undefined",
         "weight" : 1
      },
      {
         "id" : 1,
         "ip" : "192.168.55.41",
         "max_conns" : 0,
         "port" : "88",
         "priority" : 3,
         "status" : "undefined",
         "weight" : 2
      }
   ],
   "description" : "List farm l4farm",
   "params" : {
      "algorithm" : "weight",
      "fgenabled" : "false",
      "fglog" : "false",
      "fgscript" : "",
      "fgtimecheck" : 5,
      "listener" : "l4xnat",
      "nattype" : "nat",
      "persistence" : "",
      "protocol" : "tcp",
      "status" : "down",
      "ttl" : 120,
      "vip" : "192.168.100.241",
      "vport" : "88"
   }
}

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[] Alle rigtige servere skabt i denne gård og dens konfiguration.

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 tilgængelige statusværdier er: nedgården går ikke; nødvendige genstart, gården er op, men den afventer en genstart kritisk, gården er op og alle backends er uopnåelige eller vedligeholdelse; problem, gården er op, og der er noget backend unreachable, men næsten en backend er i up status; vedligeholdelse, gården er op, og der er backends in up status, men næsten en backend er i vedligeholdelsestilstand; up, gården er op og alle backends arbejder succes.
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.
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.
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. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.
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.1/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.1/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.
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.1/zapi.cgi/farms/l4farm/fg

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.

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.

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.1/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. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.
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.1/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.1/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","mode":"cut"}'
 https://<zenlb_server>:444/zapi/v3.1/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 påkrævet
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. sand
tilstand String Vælg en vedligeholdelsestilstand. De tilgængelige muligheder er: dræne, backend accepterer ikke nye forbindelser, men den vil fortsat håndtere de nuværende forbindelser; eller skære, de aktuelle forbindelser vil blive lukket. Hvis dette felt ikke er angivet, vil standardindstillingen være dræne.

Svar eksempel:

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

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.1/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"
}

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.1/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,
         "status" : "undefined",
         "weight" : 2
      },
      {
         "id" : 1,
         "interface" : "eth0",
         "ip" : "192.168.100.11",
         "priority" : 2,
         "status" : "undefined",
         "weight" : 1
      }
   ],
   "description" : "List farm dlink",
   "params" : {
      "algorithm" : "weight",
      "status" : "down",
      "vip" : "192.168.100.199"
   }
}

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 tilgængelige statusværdier er: nedgården går ikke; nødvendige genstart, gården er op, men den afventer en genstart kritisk, gården er op og alle backends er uopnåelige; problem, gården er op, og der er noget backend unreachable, men næsten en backend er i up status; up, gården er op og alle backends arbejder succes.
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
status String Backend status. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; undefined, statusen for backend er ikke markeret.
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.1/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.1/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.1/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,
      "status" : "undefined",
      "weight" : 2
   },
   {
      "id" : 7,
      "interface" : "eth0",
      "ip" : "192.168.100.11",
      "priority" : 2,
      "status" : "undefined",
      "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.
status String Backend status. De mulige værdier er: up, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; undefined, statusen for backend er ikke markeret.
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.1/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.1/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.1/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 og virtuelle 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.

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.1/zapi.cgi/interfaces/nic

GET /interfaces

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

Svar eksempel:

{
   "description" : "List interfaces",
   "interfaces" : [
      {
         "gateway" : "192.168.100.5",
         "has_vlan" : "true",
         "ip" : "192.168.100.241",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0",
         "netmask" : "255.255.255.0",
         "status" : "up",
         "type" : "nic"
      },
      {
         "gateway" : "192.168.120.1",
         "ip" : "192.168.120.120",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0.1",
         "netmask" : "255.255.255.0",
         "status" : "down",
         "type" : "vlan"
      },
      {
         "gateway" : "",
         "ip" : "192.168.100.155",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0:virt",
         "netmask" : "255.255.255.0",
         "status" : "up",
         "type" : "virtual"
      },
      {
         "gateway" : "192.168.100.5",
         "has_vlan" : "false",
         "ip" : "192.168.100.102",
         "mac" : "62:30:43:36:29:ac",
         "name" : "eth1",
         "netmask" : "255.255.255.0",
         "status" : "up",
         "type" : "nic"
      }
   ]
}

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.
has_vlan String Dette felt viser, om denne grænseflade er forælder til en VLAN-grænseflade. Dette felt er kun til NIC-grænseflader.
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 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 or virtuelt.

Hent standard gateway

Hent standard gateway

Forespørgselseksempel:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3.1/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.1/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.1/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 og virtuelt.

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.1/zapi.cgi/interfaces/nic

Svar eksempel:

{
   "description" : "List NIC interfaces",
   "interfaces" : [
      {
         "gateway" : "192.168.100.5",
         "has_vlan" : "true",
         "ip" : "192.168.100.241",
         "is_slave" : "false",
         "mac" : "c2:56:f6:54:ff:a0",
         "name" : "eth0",
         "netmask" : "255.255.255.0",
         "status" : "up"
      },
      {
         "gateway" : "192.168.100.5",
         "has_vlan" : "false",
         "ip" : "192.168.100.102",
         "mac" : "62:30:43:36:29:ac",
         "name" : "eth1",
         "netmask" : "255.255.255.0",
         "status" : "up"
      }
   ]
}

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.
has_vlan String Dette felt viser, om denne grænseflade er forælder til en VLAN-grænseflade. Dette felt er kun til NIC-grænseflader.
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.

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.1/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",
      "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.

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.1/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.1/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.1/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 - VLAN-interfaces

VLAN interface gør det muligt at bruge et NIC interface i et andet netværk, så IP, gateway og 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 et punkt "." 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.1/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.1/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.1/zapi.cgi/interfaces/vlan

POST /interfaces/vlan

Opret en VLAN-grænseflade fra en NIC-grænseflade. 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.1/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.1/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.1/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 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.1/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.1/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.
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.1/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.1/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.1/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.1/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.

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.1/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" : {
         "eth0 in in" : 2702.29,
         "eth0 out out" : 50701.95,
         "eth0.1 in in" : 0,
         "eth0.1 out out" : 0,
         "eth1 in in" : 234.72,
         "eth1 out out" : 0,
      }
   }
}

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.1/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" : "2703.88",
            "interface" : "eth0",
            "out" : "50917.65"
         },
         {
            "in" : "815.69",
            "interface" : "eth0.1",
            "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 gårdsstatistik

Vis gårdsstatistik

Forespørgselseksempel:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3.1/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"
      }
   ]
}

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 or https. Hver profil er defineret i sin sektion.
status String Farm status. De tilgængelige statusværdier er: nedgården går ikke; nødvendige genstart, gården er op, men den afventer en genstart kritisk, gården er op og alle backends er uopnåelige eller vedligeholdelse; problem, gården er op, og der er noget backend unreachable, men næsten en backend er i up status; vedligeholdelse, gården er op, og der er backends in up status, men næsten en backend er i vedligeholdelsestilstand; up, gården er op og alle backends arbejder succes.
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.1/zapi.cgi/stats/farms/httpFarm

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, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.

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.

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" : "down"
      },
      {
         "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, gården løber og bagenden er klar til at modtage forbindelser; ned, gården kører og tjenesten har opdaget, at backend ikke virker; vedligeholdelse, backend er markeret som ikke klar til modtagelse af forbindelser af administratoren, denne mulighed er nyttig til backend's vedligeholdelsesopgaver; undefined, statusen for backend er ikke markeret.

Datalink gårdsstatistik er ikke tilgængelig faktisk.

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.1/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",
      "nwl4farm",
      "httpweb"
   ],
   "interfaces" : [
      "eth0.1",
      "eth1",
      "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 og 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.1/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.1/zapi.cgi/graphs/interfaces/eth0

Anmod om eksempel på en disk:

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

GET /graphs/<graph>

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.1/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.1/zapi.cgi/graphs/interfaces/eth0/monthly

Anmod om eksempel på en disk:

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

GET /graphs/<graph>/<frequency>

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.

System

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.1/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 Community Edition version.

Vis DNS

Vis DNS

Forespørgselseksempel:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3.1/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.1/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 SNMP

Vis SNMP

Forespørgselseksempel:

curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>" 
https://<zevenet_server>:444/zapi/v3.1/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.1/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.1/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.1/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.1/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.

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.1/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.1/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.1/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. De mulige værdier er: muliggøre for at aktivere zapi-bruger eller deaktivere for at deaktivere zapi-brugeren. Hvis zapi-brugeren er deaktiveret, kan du ikke sende forespørgsler.

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.1/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.1/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.

Vis linjer af en logfiler

Vis linjer af en logfiler

Forespørgselseksempel:

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

GET /system/logs/<file>/lines/<lines>

Skriv en række linjer i en logfil. URI param fil er logfilen fra læsning. Lines er antallet af linjer at vise fra finalen.

Svar eksempel:

{
   "description" : "Show a log file",
   "log" : [
      "Aug 28 09:44:00 maq2 kernel: [258451.740173] Netfilter messages via NETLINK v0.30.\n",
      "Aug 28 09:44:00 maq2 kernel: [258451.775666] ctnetlink v0.93: registering with nfnetlink.\n"
   ]
}

Response parametre

Svaret vil være et JSON med en række logfiler. Nøglen er log og dens værdi er et array med antallet af ønskede linjer.

Download en logfil

Download en logfiler

Forespørgselseksempel:

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

GET /system/logs/<file>

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.1/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.1/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.1/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.1/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.1/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.1/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"
   }
}

Download en supportsave

Download en supportsave

Forespørgselseksempel:

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

GET /system/supportsave

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.