Zevenet API v3 참조 문서
ZAPI (Zevenet Application Programming Interface)는 시스템 관리자가 Zevenet 로드 밸런서 수행을 제어하는 도구입니다.
사용하기 전에 웹 인터페이스에서 zapi 사용자를 활성화해야 합니다. 시스템/사용자.
zapi 사용자가 생성되면 URL https://로 요청을 보낼 수 있습니다.zevenet_server: 444 / zapi / v3 / zapi.cgi /URI_경로.
zevenet_server HTTP 서비스가 수신 대기 중인 IP입니다.
URI_path 행동할 대상이나 행동을 정의합니다. 해당 동작 및 해당 매개변수는 각 문서 섹션 내에서 정의됩니다.
이 API에서 사용되는 동사는 바로, POST, PUT or 삭제. PUT 또는 POST 요청에는 필수 매개변수가 필요하지 않지만 항상 거의 매개변수가 필요합니다.
인증서
Zevenet은 PEM 형식의 인증서를 지원하여 HTTPS 수신기가 있는 HTTP 팜과 함께 사용할 수 있습니다. pem 인증서를 만드는 방법에 대해 자세히 알아보려면 다음 문서를 참조하십시오. PEM 형식의 인증서 생성
모든 인증서 나열
모든 인증서 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates
GET /certificates
인증서 저장소에있는 모든 CSR 및 PEM 인증서를 나열하면 해당 인증서를 HTTPS 팜과 함께 사용할 수 있습니다.
응답은 JSON 객체가 될 것입니다. 매개 변수. 이것의 값은 각각 아래의 키 속성을 포함하는 인증서 객체의 배열입니다.
응답 예 :
{
"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"
}
]
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 매개 변수 | 개체 [] | 인증서 개체 목록입니다. |
인증서 개체
| 분야 | 타입 | 설명: |
|---|---|---|
| CN | 끈 | 도메인 공통 이름. |
| 창조 | 끈 | 제작 일. |
| 만료 | 끈 | 만료일. |
| 파일 | 끈 | 인증서의 파일 이름, 고유 ID. |
| 발행자 | 끈 | 인증서에 서명 한 공인 기관. |
| 유형 | 끈 | CSR 또는 인증서. |
인증서 다운로드
인증서 다운로드
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem
GET /certificates/<file>
인증서 저장소에 설치된 인증서를 다운로드하고 요청의 파일 이름을 사용하여 인증서 저장소를 식별합니다.
응답에는 파일에 대한 정보와 함께 아래에 표시된 헤더가 포함됩니다. 응답의 본문은 파일의 내용이됩니다.
응답 헤더 :
HTTP/1.1 200 OK
Date: Thu, 22 Dec 2016 09:27:47 GMT
Content-Disposition: attachment; filename="example.pem"
Content-Type: application/x-download; charset=ISO-8859-1
Content-Length: 2359
인증서 세부 정보 표시
인증서 세부 정보 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem/info
GET /certificates/<file>/info
서명을 포함하여 인증서 저장소에 주어진 인증서에 포함된 모든 정보를 표시합니다. 참조할 파일 이름이 필요합니다.
응답 예 :
Certificate:
Data:
Version: 3 (0x2)
Serial Number: 14346016480403539444 (0xc71749fb005a45f4)
Signature Algorithm: sha1WithRSAEncryption
Issuer: C=ES, ST=Spain, L=Spain, O=Sofintel, OU=Telecommunications, CN=Zen Load Balancer/emailAddress=zenloadbalancer-support@lists.sourceforge.net
Validity
Not Before: Jan 12 14:49:03 2011 GMT
Not After : Jan 9 14:49:03 2021 GMT
Subject: C=ES, ST=Spain, L=Spain, O=Sofintel, OU=Telecommunications, CN=Zen Load Balancer/emailAddress=zenloadbalancer-support@lists.sourceforge.net
Subject Public Key Info:
Public Key Algorithm: rsaEncryption
Public-Key: (1024 bit)
Modulus:
...
활성화 인증서 세부 정보 표시
활성화 인증서 세부 정보 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/activation
GET /certificates/activation
서명을 포함하여 활성화 인증서에 포함 된 모든 정보를 표시합니다.이 인증서는 인증서 저장소에 저장됩니다. 정품 인증을 삭제하면 제품이 비활성화됩니다.
인증서 삭제
인증서 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem
DELETE /certificates/<file>
인증서 저장소의 파일 이름으로 인증서를 삭제합니다.
응답 예 :
{
"description" : "Delete certificate",
"message" : "The Certificate example.pem has been deleted.",
"success" : "true"
}
활성화 인증서 삭제
활성화 인증서 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/activation
DELETE /certificates/activation
인증서 저장소에 설치된 정품 인증 인증서를 삭제하십시오. 이 인증서가 삭제되면로드 밸런서가 비활성화됩니다.
응답 예 :
{
"description" : "Delete activation certificate",
"message" : "The activation certificate has been deleted",
"success" : "true"
}
CSR 인증서 만들기
CSR 인증서 만들기
요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"NewCSR","fqdn":"host.domain.com","division":"IT","organization":"Example Corp.",
"locality":"Madrid","state":"Madrid","country":"ES","mail":"info@domain.com"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates
POST /certificates
인증서 서명 요청 (CSR 파일)을 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| name | 끈 | 인증서 ID 이름. | 참된 |
| fqdn | 끈 | 서버의 정규화 된 도메인 이름입니다. | 참된 |
| 분할 | 끈 | 인증서를 처리하는 조직의 부서. | 참된 |
| 조직 | 끈 | 조직의 법적 이름. | 참된 |
| 소재지 | 끈 | 조직이 위치한 도시입니다. | 참된 |
| 상태 | 끈 | 조직이 위치한 주 / 지역. | 참된 |
| 국가 | 끈 | 조직이 위치한 국가의 두 글자 ISO 코드입니다. | 참된 |
| 우편 | 끈 | 조직에 연락하는 데 사용되는 전자 메일 주소입니다. | 참된 |
응답 예 :
{
"description" : "Create CSR",
"message" : "Certificate NewCSR created",
"success" : "true"
}
인증서 업로드
인증서 업로드
요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: text/plain'
--tcp-nodelay --data-binary @/local_path/to/example.pem
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/example.pem
POST /certificates/<file>
HTTPS 수신기를 사용하여 HTTP 팜에 대한 PEM 인증서를 업로드합니다.
매개 변수가 필요합니다. --tcp-nodelay --data-binary 바이너리 모드로 파일을 업로드 할 수 있습니다.
URI 매개 변수 요청
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 파일 | 끈 | 인증서 저장소에 업로드하고 저장할 인증서 파일 이름입니다. | 참된 |
응답 예 :
{
"description" : "Upload PEM certificate",
"message" : "Certificate uploaded",
"success" : "true"
}
활성화 인증서 업로드
활성화 인증서 업로드
요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: text/plain'
--tcp-nodelay --data-binary @/path/to/example.pem
https://<zevenet_server>:444/zapi/v3/zapi.cgi/certificates/activation
POST /certificates/activation
PEM 형식의 활성화 인증서를 업로드하십시오. 이 인증서는 모든 기능을 활성화하는 데 필요합니다. 이 인증서는 인증서 저장소에 저장되며 활성화 인증서가 인증서 저장소에 있으면 이전 인증서를 덮어씁니다.
응답 예 :
{
"description" : "Upload activation certificate",
"message" : "Activation certificate uploaded",
"success" : "true"
}
농장
Zevenet은 세 가지 방법으로 트래픽을 관리할 수 있으며 각 방법은 다른 모듈, 로컬 서비스 부하 분산 장치 또는 LSLB 모듈, 글로벌 서비스 부하 분산 장치 또는 GSLB 모듈 및 Datalink 서비스 부하 분산 장치 또는 DSLB 모듈에 의해 관리됩니다.
모든 모듈은 팜 프로필 개념과 함께 작동합니다. 팜 프로필은 네트워크 트래픽으로 특정 작업을 수행할 준비가 된 매개 변수 그룹입니다. Zevenet의 최상의 결과를 얻으려면 각 팜 프로필을 수행할 수 있는 것을 이해하는 것이 중요합니다. ADC.
- LSLB: 이 모듈은 HTTP 및 l4xnat 프로필 농장. 웹 역 프록시 또는 라우터로 작동합니다.
- GSLB: 이 모듈은 GSLB 프로필 팜. 도메인 이름 서버로 작동합니다.
- DSLB: 이 모듈은 데이터 링크 프로필 팜. 그것은 게이트웨이로 작동합니다.
모든 농장 목록보기
모든 농장 목록보기
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms
GET /farms
사용 가능한 모든 팜 나열
응답은 JSON 객체가 될 것입니다. 매개 변수. 이 값은 팜 재개 개체의 배열이며 각 개체에는 아래의 키 특성이 포함됩니다.
농장 개체
| 분야 | 타입 | 설명: |
|---|---|---|
| 농장 이름 | 끈 | 농장을 설명하는 이름입니다. 고유 식별자로 사용됩니다. |
| 윤곽 | 끈 | 프로파일 유형, 사용 가능한 프로파일 값은 다음과 같습니다. HTTP, HTTPS or l4xnat LSLB 모듈, GSLB GLSB 모듈 및 데이터 링크 DSLB 모듈 용 |
| 지위 | 끈 | 팜 상태에서 사용 가능한 상태 값은 다음과 같습니다. up, 팜이 실행 중이거나 아래 (down), 팜이 중지됨 |
| VIP | 끈 | 팜이 트래픽을 수신하는 가상 IP |
| vport | 끈 | 팜이 트래픽을 수신하는 가상 포트, 사용 가능한 포트 값은 http [s], l4xnat 및 gslb 프로필의 포트 번호, ","로 구분 된 포트 그룹 또는 l4xnat 프로필의 경우 ":"로 구분 된 포트 범위입니다. l4xnat 두 구분 기호 값 ( ","및 ":")을 동일한 필드에서 사용할 수 있습니다. |
응답 예 :
{
"description" : "List farms",
"params" : [
{
"farmname" : "httpFarm",
"profile" : "http",
"status" : "up",
"vip" : "192.168.101.146",
"vport" : "81"
}
]
}
팜 삭제
팜 삭제
요청 예 :
curl --tlsv1 -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP
DELETE /farms/<farmname>
팜 이름 식별자를 통해 팜을 삭제합니다.
응답 예 :
{
"description" : "Delete farm FarmHTTP",
"message" : "The Farm FarmHTTP has been deleted.",
"success" : "true"
}
팜에서 작업 설정
팜에서 작업 설정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"stop"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmTCP/actions
PUT /farms/<farmname>/actions
팜에 작업을 적용하려면 요청 매개 변수 테이블에서 작업을 참조하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 원하는 동작을 설정하십시오. 조치는 다음과 같습니다. 중지, 팜이 중지됩니다. 스타트, 농장이 시작되고 다시 시작, 팜이 자동으로 중지되고 시작됩니다. |
응답 예 :
{
"description" : "Set a new action in FarmHTTP",
"params" : [
{
"action" : "stop"
}
]
}
응답 매개 변수
구성에 문제가 없으면 zapi는 요청된 작업을 반환합니다.
HTTP 팜
HTTP 프로필은 프록시 특수 속성이 있는 고급 계층 7 부하 분산(또는 Application Delivery Controller)입니다. 이 프로파일은 SSL 오프로드 가속과 결합된 HTTPS 계층 7 로드 밸런싱과 같은 일부 기능을 제공합니다. 이 프로필은 웹 서비스(웹 응용 프로그램 서버 포함) 및 WebDav, RDP over HTTP, ICA over HTTP 등과 같은 HTTP 및 HTTPS 프로토콜을 기반으로 하는 모든 응용 프로그램 프로토콜에 적합합니다. 이 팜 프로필을 구성하려면 가상 IP 주소와 가상 TCP 포트가 필요합니다.
이름으로 팜 검색
이름으로 팜 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm
GET /farms/<farmname>
지정된 팜에 대한 모든 구성을 표시합니다.
응답 예 :
{
"description" : "List farm httpFarm",
"ipds" : {
"blacklists" : [
"rem"
],
"dos" : []
},
"params" : {
"certlist" : [
{
"file" : "zencert.pem",
"id" : 1
}
],
"cipherc" : "ALL",
"ciphers" : "all",
"contimeout" : 20,
"error414" : "Request URI is too long.",
"error500" : "An internal server error occurred. Please try again later.",
"error501" : "This method may not be used.",
"error503" : "The service is not available. Please try again later.",
"httpverb" : "MSRPCext",
"listener" : "https",
"reqtimeout" : 30,
"restimeout" : 45,
"resurrectime" : 10,
"rewritelocation" : "enabled",
"status" : "down",
"vip" : "192.168.100.211",
"vport" : 200
},
"services" : [
{
"backends" : [],
"cookiedomain" : "",
"cookieinsert" : "false",
"cookiename" : "",
"cookiepath" : "",
"cookiettl" : 0,
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "service3",
"leastresp" : "false",
"persistence" : "",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "",
"ttl" : 0,
"urlp" : "",
"vhost" : ""
},
{
"backends" : [
{
"id" : 0,
"ip" : "192.168.0.168",
"port" : 80,
"status" : "up",
"timeout" : null,
"weight" : null
}
],
"cookiedomain" : "",
"cookieinsert" : "false",
"cookiename" : "",
"cookiepath" : "",
"cookiettl" : 0,
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "tcp_check",
"fgtimecheck" : 5,
"httpsb" : "false",
"id" : "srv",
"leastresp" : "false",
"persistence" : "",
"redirect" : "",
"redirecttype" : "",
"sessionid" : "",
"ttl" : 0,
"urlp" : "",
"vhost" : ""
},
]
}
응답 매개 변수
응답은 아래 형식의 JSON 객체가 될 것입니다.
농장 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ipds | 목적 | 이 팜에 적용되는 IPDS 규칙 목록입니다. |
| 매개 변수 | 목적 | 팜 구성의 매개 변수입니다. |
| 서비스 | 목적[] | 이 팜에서 생성 된 모든 서비스와 구성으로 구성됩니다. |
IPDS 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 블랙리스트 | 끈[] | 팜에 블랙리스트 규칙이 적용되었습니다. |
| 내부 | 끈[] | 팜에 적용되는 DoS 규칙 |
HTTP 팜의 매개 변수 객체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 인증 목록 | 목적[] | https 프로필에서만. 팜에서 활성화된 인증서 목록은 pem 형식으로 SNI 지원을 위해 동일한 팜에 둘 이상의 pem 인증서를 추가할 수 있습니다. https 값이 있는 리스너가 필요합니다. 인증서 저장소의 모든 인증서를 여기에서 사용할 수 있습니다. |
| 암호 | 끈 | https 리스너에서만. 이것은 OpenSSL 암호에서와 동일한 형식의 문자열인 SSL 연결에서 허용되는 허용되는 사용자 지정 암호 목록입니다. 이 속성은 다음 경우에만 사용됩니다. 암호 필드의 값은 sutomsecurity입니다. |
| 암호 | 끈 | https 값을 가진 리스너에서만. SSL 연결을 강화하기 위해 SSL 연결에서 허용하는 암호 목록을 작성하는 데 사용됩니다. 옵션은 다음과 같습니다. 모든, 모든 암호가 허용됩니다. 높은 보안 성, 높은 보안을 위한 암호만 허용되거나 맞춤 보안,로드 된 암호 만 암호 필드가 허용됩니다. |
| contimeout | 번호 | 팜이 초 단위로 백엔드에 대한 TCP 연결을 대기하는 기간. |
| error414 | 끈 | 414 HTTP 오류 코드로 응답하기 위한 개인화된 메시지입니다. |
| error500 | 끈 | 500 HTTP 오류 코드로 응답하기 위한 개인화된 메시지입니다. |
| error501 | 끈 | 501 HTTP 오류 코드로 응답하기 위한 개인화된 메시지입니다. |
| error503 | 끈 | 503 HTTP 오류 코드로 응답하기 위한 개인화된 메시지입니다. |
| httpverb | 끈 | 이 필드는 HTTP 클라이언트 요청에 허용 할 작업을 나타냅니다. 사용할 수있는 값은 다음과 같습니다. 표준 HTTP, naccepted http 요청 GET, POST, HEAD. extendedHTTP, 이전 http 요청과 PUT, DELETE를 수락했습니다. standardWebDAV, 수락된 이전 http 요청과 LOCK, UNLOCK, PROPFIND, PROPPATCH, SEARCH, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV 수락된 이전 http 요청과 SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT 또는 MSRPCext, 이전 http 요청과 RPC_IN_DATA, RPC_OUT_DATA를 수락했습니다. 해당 값은 대소문자를 구분합니다. |
| 경청자 | 끈 | 수신기는 클라이언트의 요청으로 팜을 재생하는 방법을 정의합니다. 옵션은 다음과 같습니다. HTTP 보안되지 않은 프로토콜 또는 HTTPS 보안 프로토콜 용. |
| reqtimeout | 번호 | 팜이 클라이언트 요청을 몇 초 만에 기다릴 시간. |
| restimeout | 번호 | 팜이 백엔드의 응답을 몇 초 만에 기다릴 예정입니다. |
| 부활 | 번호 | 이 기간이 지나면 실제 서버가 살아 있는지 (초)로드 밸런서가 검사합니다. |
| 재기록 | 끈 | 이 옵션을 사용하면 가상 호스트가있는 클라이언트에 대한 응답에서 Location : 및 Content-location : 헤더가 팜에서 강제로 수정됩니다. 옵션은 다음과 같습니다. 사용 가능, 활성화됨 사용, 비활성화 또는 enabled-backends 백엔드 주소 만 비교됩니다. |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up, 팜이 실행 중입니다. 아래 (down), 팜이 중지되거나 재시작 필요, 최신 변경 사항을 적용하려면 팜을 다시 시작해야 합니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 번호 | 가상 서비스가 수신하는 팜의 포트 |
Certlist 객체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 파일 | 끈 | 인증서 이름, 인증서 저장소의 인증서에 대한 참조입니다. |
| id | 번호 | Certificate ID, The order in the list, the order in the list, the first one will be used by default if virtual host header is not match with CN field in the certificate. SNI에 사용됩니다. |
HTTP 팜용 서비스 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 백엔드 | 목적[] | 서비스에 정의 된 백엔드. |
| Cookiedomain | 끈 | 쿠키 내용에서 도메인이 일치하면 쿠키 삽입이 실행됩니다. 할 수 있게 하다 쿠키 삽입 필드는 필수입니다. |
| 쿠키 삽입 | 끈 | 그것은 백엔드 sticky 세션을위한 쿠키 삽입을 가능하게합니다. 옵션은 다음과 같습니다. 참된, 프로필은 필드의 주어진 쿠키를 검색합니다 요리사, 존재하지 않으면이 쿠키가 추가됩니다. 그릇된, 조치가 취해지지 않습니다. |
| 요리사 | 끈 | 쿠키 이름 (세션 ID)은 백엔드에 대한 고정 프로세스를 식별하는 데 사용됩니다. 사용 쿠키 삽입 필드는 필수입니다. |
| 요리법 | 끈 | 그것은 주어진 쿠키에 대한 쿠키 경로 값을 관리합니다. 사용 쿠키 삽입 필드는 필수입니다. |
| 요리사 | 번호 | 쿠키의 최대 수명 (초)입니다. 사용 쿠키 삽입 필드는 필수입니다. |
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 농장 보호자가 활성화되어 있고 백엔드 상태를 확인하고 있습니다. 그릇된 농장 보호자가 비활성화되어 백엔드 상태를 확인하지 않습니다. HTTP 프로필에서 check_tcp는 팜 가디언이 비활성화된 경우에도 기본적으로 실행됩니다. |
| fglog | 끈 | Farm Guardian에서 로그 사용을 활성화합니다. 참된 사용 가능, 그릇된, 장애가 있는. fg 가능 필요합니다. |
| fgscript | 끈 | 농장 보호자가 백엔드 상태를 확인하는 데 사용할 명령입니다. 참된 사용 가능, 그릇된, 장애가 있는. fg 가능 필요합니다. |
| fgtimecheck | 번호 | 농장 보호자는 각 'timetocheck'초마다 백엔드 상태를 확인합니다. fg 가능 필요합니다. |
| httpsb | 끈 | 이 매개변수는 현재 서비스에 정의된 백엔드 서버가 HTTPS 언어를 사용하고 있으며 데이터가 전송되기 전에 암호화됨을 팜에 나타냅니다. 참된, 프로파일은 HTTPS 프로토콜로 트래픽을 백엔드로 보냅니다. 그릇된, 프로파일은 HTTP 프로토콜로 트래픽을 백엔드로 보냅니다. |
| id | 끈 | 서비스 이름입니다. 서비스가 생성되면 수정할 수 없습니다. |
| 최소값 | 끈 | 응답이 가장 적은 밸런싱 방법을 사용할 수 있습니다. 참된 프로필은 더 많은 연결을 보내기 위해 어떤 백엔드가 응답하는 데 더 적은 시간이 걸리는지 자주 확인합니다. 그릇된 프로필은 응답하는 데 시간이 덜 걸리는 백엔드를 확인하지 않습니다. |
| 고집 | 끈 | 이 매개 변수는 HTTP 서비스가 클라이언트 세션을 관리하는 방법을 정의합니다. 옵션은 다음과 같습니다. "" 빈 문자열, 아무 조치도 취하지 않고, IP 지속성 세션은 클라이언트 IP의 기반으로 이루어지며, BASIC 퍼시스턴스 세션은 BASIC 헤더의 기반으로 이루어지며, URL 영속 세션은 URI의 필드의 기저로 이루어지며, 파름 영속 세션은 URI의 끝에있는 값을 기반으로 이루어지며, COOKIE 지속성 세션은 쿠키 이름을 기반으로 이루어지며,이 쿠키는 백엔드에 의해 만들어 져야하며, 머리글지속성 세션은 헤더 이름을 기반으로 수행됩니다. |
| 리디렉션 | 끈 | 클라이언트 요청이 새 URL로의 리디렉션에 의해 자동으로 응답되므로 특별한 백엔드로 작동합니다. 리디렉션이 구성된 경우 요청이 백엔드로 전달되지 않고 리디렉션이 클라이언트에 대신 응답됩니다. |
| redirecttype | 끈 | 리디렉션이 어떻게 수행 될지, 두 가지 옵션 : 디폴트 값, URL은 리디렉션할 절대 호스트 및 경로로 사용됩니다. 추가원래 요청 경로 또는 URI가 기본 옵션으로 지정된 호스트 및 경로에 추가됩니다. 만약 리디렉션 필드가 구성되어 있지 않으면이 필드는 빈 문자열이됩니다. |
| sessionid | 끈 | 경우에 사용 가능 고집 필드가 URL, COOKIE 또는 HEADER인 경우 매개 변수 값은 http 헤더에서 팜별로 검색되어 클라이언트 세션을 관리합니다. |
| TTL | 번호 | 지속성 만 있으면. 이 값은 비활성 클라이언트 세션 (최대 세션 수명)의 최대 수명 (초)을 나타냅니다. |
| urlp | 끈 | 구문적으로 검사될 특정 URL 패턴을 통해 클라이언트가 요청하는 URL에 관한 웹 서비스를 결정할 수 있습니다. PCRE 정규식이 지원됩니다. |
| 유령 | 끈 | HTTP 팜에서 정의한 동일한 가상 IP 및 포트를 통해 도메인 이름으로 결정되는 조건을 지정합니다. PCRE 정규식이 지원됩니다. |
HTTP 팜의 백엔드 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 지정된 서비스 내부의 백엔드 식별자. |
| ip | 끈 | 실제 서비스가 실행되는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 실행되는 백엔드의 포트입니다. |
| 지위 | 끈 | 백엔드 상태. 값은 다음과 같습니다. up 백엔드가 연결을 수신할 준비가 되었습니다. 유지 백엔드가 연결을 수신할 준비가 되지 않은 것으로 표시되면 이 옵션은 백엔드의 유지 관리 작업에 유용합니다. |
| 시간 제한 | 번호 | 특정 요청에 초 단위로 응답하는 백엔드 제한 시간입니다. null인 경우 시스템은 전역 매개변수 백엔드 시간 초과를 사용합니다. |
| 무게 | 번호 | 현재 실제 서버에 대한 가중치 값이며 가중치 값이 높은 백엔드가 더 많은 연결을 수신합니다. 기본값 null, 이 백엔드에 사용되는 특수 가중치가 아닙니다. |
새 팜 만들기
새 팜 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"newHTTPfarm", "profile":"http", "vip":"192.168.100.23",
"vport":80}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms
POST /farms
새 HTTP 팜을 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 농장 이름 | 끈 | 농장을 설명하는 이름입니다. 고유 식별자로 사용됩니다. | 참된 |
| 윤곽 | 끈 | 생성된 팜의 프로필입니다. http 농장의 경우 HTTP. | 참된 |
| VIP | 끈 | 가상 서비스가 실행될 팜의 IP 표시된 IP가 시스템에 구성되어 있고 UP | 참된 |
| vport | 번호 | 가상 서비스가 수신할 팜의 포트입니다. 동일한 가상 포트와 가상 IP를 다른 팜에서 사용하지 않아야 합니다. | 참된 |
응답 예 :
{
"description" : "Creating farm 'newHTTPfarm'",
"params" : {
"interface" : "eth0.2",
"farmname" : "newHTTPfarm",
"profile" : "http",
"vip" : "192.168.100.23",
"vport" : 80
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 수정
농장 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"contimeout":22,"newfarmname":"FarmHTTP2","vip":"178.62.126.152","vport":88,
"restimeout":47,"resurrectime":12,"reqtimeout":32,"rewritelocation":"enabled","httpverb":"standardHTTP",
"error414":"Message error 414","error500":"Message error 500","error501":"Message error 501",
"error503":"Message error 503","listener":"https","ciphers":"customsecurity",
"cipherc":"TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP
PUT /farms/<farmname>
지정된 HTTP 팜에 대한 전역 매개 변수를 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| contimeout | 번호 | 팜이 백엔드에 대한 연결을 몇 초 만에 기다릴 시간. |
| restimeout | 번호 | 팜이 백엔드의 응답을 몇 초 만에 기다릴 예정입니다. |
| 부활 | 번호 | 초 단위의 이 값은 블랙리스트에 있는 백엔드를 꺼내고 활성 여부를 확인하는 기간입니다. |
| reqtimeout | 번호 | 팜이 클라이언트 요청을 몇 초 만에 기다릴 시간. |
| 재기록 | 끈 | 이 옵션을 사용하면 가상 호스트가있는 클라이언트에 대한 응답에서 Location : 및 Content-location : 헤더가 팜에서 강제로 수정됩니다. 옵션은 다음과 같습니다. 사용 가능, 활성화됨 사용, 비활성화 또는 enabled-backends 백엔드 주소 만 비교됩니다. |
| httpverb | 끈 | 이 필드는 HTTP 클라이언트 요청에 허용 할 작업을 나타냅니다. 사용할 수있는 값은 다음과 같습니다. 표준 HTTP, naccepted http 요청 GET, POST, HEAD. extendedHTTP, 이전 http 요청과 PUT, DELETE를 수락했습니다. standardWebDAV, 수락된 이전 http 요청과 LOCK, UNLOCK, PROPFIND, PROPPATCH, SEARCH, MKCOL, MOVE, COPY, OPTIONS, TRACE, MKACTIVITY, CHECKOUT, MERGE, REPORT, MSextWebDAV 수락된 이전 http 요청과 SUBSCRIBE, UNSUBSCRIBE, NOTIFY, BPROPFIND, BPROPPATCH, POLL, BMOVE, BCOPY, BDELETE, CONNECT 또는 MSRPCext, 이전 http 요청과 RPC_IN_DATA, RPC_OUT_DATA를 수락했습니다. 해당 값은 대소문자를 구분합니다. |
| error414 | 끈 | 맞춤 메시지 오류 414. |
| error500 | 끈 | 맞춤 메시지 오류 500. |
| error501 | 끈 | 맞춤 메시지 오류 501. |
| error503 | 끈 | 맞춤 메시지 오류 503. |
| 경청자 | 끈 | 수신기는 클라이언트의 요청으로 팜을 재생하는 방법을 정의합니다. 옵션은 다음과 같습니다. HTTP 보안되지 않은 프로토콜 또는 HTTPS 보안 프로토콜 용. |
| 암호 | 끈 | https 리스너에서만. 이 필드는 SSL 연결을 강화하기 위해 SSL 연결에서 허용하는 암호 목록을 작성하는 데 사용됩니다. 옵션은 다음과 같습니다. 모든, 모든 암호가 허용됩니다. 높은 보안 성, 높은 보안을 위한 암호만 허용되거나 맞춤 보안,로드 된 암호 만 암호 필드가 허용됩니다. |
| 암호 | 끈 | https 리스너에서만. 이것은 OpenSSL 암호에서와 동일한 형식의 문자열인 SSL 연결에서 허용되는 허용되는 사용자 지정 암호 목록입니다. 이 속성은 다음 경우에만 사용됩니다. 암호 필드의 값은 sutomsecurity입니다. |
| newfarmname | 끈 | 새 농장의 이름입니다. 농장을 멈춰야 합니다. |
| vport | 번호 | 가상 서비스가 수신하는 팜의 포트 |
| VIP | 끈 | 가상 서비스가 수신 대기중인 팜의 IP.이 IP는 시스템에 구성되어 있어야합니다. |
응답 예 :
{
"description" : "Modify farm FarmHTTP",
"params" : {
"cipherc" : "TLSv1+SSLv3+HIGH:-MEDIUM:-LOW*:-ADH*",
"ciphers" : "customsecurity",
"contimeout" : 22,
"error414" : "Message error 414",
"error500" : "Message error 500",
"error501" : "Message error 501",
"error503" : "Message error 503",
"httpverb" : "standardHTTP",
"listener" : "https",
"newfarmname" : "FarmHTTP",
"reqtimeout" : 32,
"restimeout" : 47,
"resurrectime" : 12,
"rewritelocation" : "enabled",
"vip" : "178.62.126.152",
"vport" : 88
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
인증서 추가
인증서 추가
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"file":"example.pem"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/certificates
POST /farms/<farmname>/certificates
사용 가능한 PEM 인증서를 SNI 목록에 포함 시키거나 certlist HTTPS 리스너가있는 HTTP 팜의 배열입니다. 사용 된 인증서는 이미 시스템에 업로드되어 있어야합니다. 인증서> 모든 인증서 나열 사용 가능한 인증서 목록.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 파일 | 끈 | 인증서 파일 이름은 이전에 인증서가 시스템에 업로드되어야합니다. | 참된 |
응답 예 :
{
"description" : "Add certificate",
"message" : "The certificate example.pem has been added to the SNI list of farm httpFarm, you need restart the farm to apply",
"success" : "true",
"status": "needed restart"
}
인증서 삭제
인증서 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/MyHttpFarm/certificates/example.pem
DELETE /farms/<farmname>/certificates/<file>
HTTPS 수신기가 있는 HTTP 팜의 인증서 목록에서 선택한 파일 이름의 인증서를 삭제합니다. 인증서는 인증서 저장소에서 삭제되지 않습니다.
응답 예 :
{
"description" : "Delete farm certificate",
"message" : "The Certificate example.pem has been deleted.",
"success" : "true",
"status": "needed restart"
}
IPDS 규칙 추가
IPDS 규칙 추가
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists>
블랙리스트 또는 DoS 규칙을 팜에 적용합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 고유 식별자로 사용되는 IPDS 규칙 이름입니다. |
응답 예 :
{
"description" : "Apply a rule to a farm",
"message" : "Blacklist rule china was applied successful to the farm httpFarm.",
"success" : "true"
}
IPDS 규칙 제거
IPDS 규칙 제거
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/httpFarm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>
해당 식별자를 사용하여 지정된 팜에서 블랙리스트 또는 DoS 규칙 제거 name.
응답 예 :
{
"description" : "Delete a rule form a farm",
"message" : "Blacklist rule china was removed successful from the farm httpFarm.",
"success" : "true"
}
HTTP - 서비스
HTTP 프로필 팜 내의 서비스는 모든 클라이언트 요청에 대해 올바른 서비스를 일치시키기 위해 팜 코어에서 사용하는 일부 결정적 조건을 통해 속성, 백엔드 또는 지속성 방법이 다른 여러 웹 서비스를 제공하는 콘텐츠 전환 방법을 제공합니다. 이 서비스 정의는 클라이언트에 응답을 전달할 수 있는 백엔드 서버를 결정하기 위해 팜에서 사용됩니다.
서비스 개체 내부에는 서비스 관련 및 농장 보호 관련의 두 가지 값이 있습니다.
Farmguardian은 백엔드의 고급 모니터링 상태에 사용되며 현재 서비스에 대한 자체 스크립트에 대해 완전히 개인화됩니다. farmguardian이 문제를 감지하면 자동으로 실제 서버를 비활성화하고 블랙리스트로 표시됩니다.
HTTP 팜의 서비스 개체에 대한 전체 설명은 다음을 참조하세요. HTTP 팜 > 이름으로 팜 검색 > HTTP 팜에 대한 테이블 서비스 개체
새 서비스 만들기
새 서비스 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"newserv"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services
POST /farms/<farmname>/services
주어진 HTTP 프로필 Farm에서 서비스를 만듭니다. 이 변경 내용을 적용하려면 팜에서 다시 시작 작업이 필요합니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| id | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. 영숫자 값만 허용됩니다. | 참된 |
응답 예 :
{
"description" : "New service newserv",
"params" : {
"id" : "newserv"
},
"status" : "needed restart"
}
서비스 수정
서비스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"vhost":"www.mywebserver.com","urlp":"^/myapp1$","persistence":"URL",
"redirect":"http://zenloadbalancer.com","ttl":125,"sessionid":"sid","leastresp":"true",
"httpsb":"true"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services/sev2
PUT /farms/<farmname>/services/<id>
HTTP 프로필에서 서비스의 매개변수를 수정합니다. id 수정할 서비스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 유령 | 끈 | HTTP 프로필 팜에서 정의한 동일한 가상 IP 및 포트를 통해 도메인 이름으로 결정되는 조건을 지정합니다. PCRE 정규식이 지원됩니다. |
| urlp | 끈 | 구문적으로 검사될 특정 URL 패턴을 통해 클라이언트가 요청하는 URL에 관한 웹 서비스를 결정할 수 있습니다. PCRE 정규식이 지원됩니다. |
| 리디렉션 | 끈 | 특별한 백엔드로 작동하며 클라이언트 요청은 새 URL로 자동으로 리디렉션됩니다. |
| redirecttype | 끈 | 리디렉션이 어떻게 수행 될지, 두 가지 옵션 : 디폴트 값, URL은 리디렉션할 절대 호스트 및 경로로 사용됩니다. 추가, 원래 요청 경로 또는 URI가 호스트에 추가되고에서 지정한 경로 리디렉션 필드. 이 동작은 다음 경우에만 적용됩니다. 리디렉션 빈 값이 아닙니다. |
| 쿠키 삽입 | 끈 | 그것은 백엔드 sticky 세션을위한 쿠키 삽입을 가능하게합니다. 옵션은 다음과 같습니다. 참된, 프로필은 필드의 주어진 쿠키를 검색합니다 요리사, 존재하지 않으면이 쿠키가 추가됩니다. 그릇된, 삽입 쿠키가 비활성화됩니다. |
| 요리사 | 끈 | 쿠키 이름 (세션 ID)은 백엔드에 대한 고정 프로세스를 식별하는 데 사용됩니다. 사용 쿠키 삽입 필드는 필수입니다. |
| Cookiedomain | 끈 | 쿠키 내용에서 도메인이 일치하면 쿠키 삽입이 실행됩니다. 할 수 있게 하다 쿠키 삽입 필드는 필수입니다. |
| 요리법 | 끈 | 클라이언트 요청 또는 백엔드 응답의 URI가 쿠키 경로와 일치하지 않으면 쿠키 삽입 지속성 방법이 적용되지 않는 경우 지정된 쿠키의 쿠키 경로 값을 관리합니다. 활성화 쿠키 삽입 필드는 필수입니다. |
| 요리사 | 번호 | 쿠키의 최대 수명 (초)입니다. 사용 쿠키 삽입 필드는 필수입니다. |
| 고집 | 끈 | 이 매개 변수는 HTTP 서비스가 클라이언트 세션을 관리하는 방법을 정의합니다. 옵션은 다음과 같습니다. "" 빈 문자열, 아무 조치도 취하지 않고, IP 지속성 세션은 클라이언트 IP의 기반으로 이루어지며, BASIC 퍼시스턴스 세션은 BASIC 헤더의 기반으로 이루어지며, URL 영속 세션은 URI의 필드의 기저로 이루어지며, 파름 지속성 세션은 ";"로 구분 된 값을 기준으로 수행됩니다. URI 끝에서 COOKIE 지속성 세션은 쿠키 이름을 기반으로 이루어지며,이 쿠키는 백엔드에 의해 만들어 져야하며, 머리글지속성 세션은 헤더 이름을 기반으로 수행됩니다. |
| TTL | 번호 | 지속성 만 있으면. 비활성 클라이언트 세션의 최대 수명 (최대 세션 수명) (초). |
| sessionid | 끈 | 경우에 사용 가능 고집 필드 URL, COOKIE or 머리글, 매개 변수 값은 http 헤더에서 프로필로 검색되며 클라이언트 세션을 관리합니다. |
| 최소값 | 끈 | 응답이 가장 적은 밸런싱 방법을 사용할 수 있습니다. 참된, 프로필은 더 많은 연결을 보내기 위해 어떤 백엔드가 응답하는 데 더 적은 시간이 걸리는지 자주 확인합니다. 그릇된, 프로필은 응답하는 데 시간이 덜 걸리는 백엔드를 확인하지 않습니다. |
| httpsb | 끈 | 현재 서비스에 정의된 백엔드 서버가 HTTPS 언어를 사용하고 있음을 팜에 알리고 데이터가 전송되기 전에 암호화됩니다. 참된, 프로파일은 HTTPS 프로토콜로 트래픽을 백엔드로 보냅니다. 그릇된, 프로파일은 HTTP 프로토콜로 트래픽을 백엔드로 보냅니다. |
응답 예 :
{
"description" : "Modify service newsrv in farm newHTTPfarm",
"info" : "There're changes that need to be applied, stop and start farm to apply them!",
"params" : {
"backends" : [],
"cookiedomain" : "",
"cookieinsert" : "false",
"cookiename" : "",
"cookiepath" : "",
"cookiettl" : 0,
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"httpsb" : "true",
"id" : "newsrv",
"leastresp" : "true",
"persistence" : "",
"redirect" : "http://zenloadbalancer.com",
"redirecttype" : "default",
"sessionid" : "sid",
"ttl" : 125,
"urlp" : "^/myapp1$",
"vhost" : "www.mywebserver.com"
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청된 매개변수가 업데이트된 json이며 지위 필드 재시작 필요 값. 변경 사항을 적용하려면 다시 시작 조치를 취해야 합니다.
농장 보호자 수정
농장 보호자 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"check_tcp","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/fg
Farmguardian은 백엔드의 고급 모니터링 상태에 사용되며 현재 서비스에 대한 자체 스크립트에 대해 완전히 개인화됩니다. farmguardian이 문제를 감지하면 자동으로 실제 서버를 비활성화하고 블랙리스트로 표시됩니다.
PUT /farms/<farmname>/fg
주어진 HTTP 프로필에서 농장 보호자의 매개변수를 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| fgtimecheck | 번호 | 농장 보호자는 'timetocheck'초마다 백엔드 상태를 확인합니다. | |
| fgscript | 끈 | 백엔드 상태를 확인하기 위해 Farm Guardian이 실행할 명령 | |
| fg 가능 | 끈 | 표시된 서비스에서 팜 가디언을 활성화합니다. 참된 Farm Guardian은 백엔드 상태를 확인하는 데 사용됩니다. 그릇된 농장 보호자가 비활성화됩니다 | |
| fglog | 끈 | Farm Guardian에서 로그 사용을 활성화합니다. 참된 농장 보호자는 모든 작업을 기록할 것입니다. 그릇된 팜 가디언은 어떤 작업도 기록하지 않으므로 활성화하는 것이 좋습니다. fglog 문제 해결을 위해서만. | |
| 서비스 | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. | 참된 |
응답 예 :
{
"description" : "Modify farm FarmHTTP",
"params" : {
"fgenabled" : "true",
"fglog" : "true",
"fgscript" : "checktcp",
"fgtimecheck" : 5,
"service" : "service1"
}
}
서비스 이동
서비스 이동
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"position":0}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services/service1/actions
POST /farms/<farmname>/services/<id>/actions
이 조치는 서비스 목록에서 주어진 서비스를 위로 또는 아래로 이동합니다. 이 옵션은 우선순위 순서를 변경해야 하는 경우 유용합니다. 서비스는 표시된 순서대로 평가됩니다. 이 작업은 팜을 자동으로 다시 시작합니다.
id 수정할 서비스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 위치 | 번호 | 서비스가 될 위치. 첫 번째 위치의 인덱스는 0입니다. | 참된 |
응답 예 :
{
"description" : "Move service",
"message" : "service1 was moved successful.",
"params" : {
"position" : 0
}
}
서비스 삭제
서비스 삭제
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/services/service1
DELETE /farms/<farmname>/services/<id>
http 프로필의 지정된 서비스를 삭제합니다. id 삭제할 서비스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete service service1 in farm FarmHTTP",
"message" : "The service service1 in farm FarmHTTP has been deleted.",
"success" : "true",
"status": "needed restart"
}
HTTP - 서비스 - 백엔드
백엔드 나열
백엔드 나열
요청 예 :
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/service1/backends
GET /farms/<farmname>/services/<id>/backends
서비스에서 백엔드 목록을 가져옵니다. id 서비스 고유 식별자입니다.
응답 예 :
{
"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
}
]
}
응답 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 서비스의 백엔드에 대한 고유 식별자. 이 식별자는 시스템에 의해 생성됩니다. |
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 수신하는 백엔드의 포트입니다. |
| 시간 제한 | 번호 | 몇 초 안에 특정 요청에 응답하는 것이 백엔드 시간 초과입니다. |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. |
| 지위 | 끈 | 백엔드 상태. 값은 다음과 같습니다. up 백엔드가 연결을 수신할 준비가 되었습니다. 유지 백엔드가 연결을 수신할 준비가 되지 않은 것으로 표시되면 이 옵션은 백엔드의 유지 관리 작업에 유용합니다. |
새 백엔드 만들기
새 백엔드 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.102.244","port":80, "weight":2,"timeout":2}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/newsrv/backends
POST /farms/<farmname>/services/<id>/backends
주어진 HTTP 프로파일에 새 백엔드를 작성하십시오. id 서비스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. | 참된 |
| 포트 | 번호 | 실제 서비스가 수신하는 백엔드의 포트입니다. | 참된 |
| 시간 제한 | 번호 | 특정 요청에 응답하는 것은 백엔드 시간 초과입니다. | |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. |
응답 예 :
{
"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"
}
응답 매개 변수
응답은 요청된 매개변수가 업데이트된 json이며 지위 필드 재시작 필요 팜을 다시 시작해야 하는 경우 값입니다. 변경 사항을 적용하려면 다시 시작 조치를 취해야 합니다.
백엔드 수정
백엔드 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.0.10","port":88,"timeout":12,"service":"sev2", "weight":1}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/FarmHTTP/service/service1/backends/1
PUT /farms/<farmname>/service/<id>/backends/<id>
HTTP 프로필 서비스에서 백엔드의 매개변수를 수정합니다.
이름 id 서비스 고유 식별자입니다. id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 수신하는 백엔드의 포트입니다. |
| 시간 제한 | 번호 | 몇 초 안에 특정 요청에 응답하는 것이 백엔드 시간 초과입니다. |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. |
응답 예 :
{
"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"
}
응답 매개 변수
응답은 요청된 매개변수가 업데이트된 json이며 지위 필드 재시작 필요 팜을 다시 시작해야 하는 경우 값입니다. 변경 사항을 적용하려면 다시 시작 조치를 취해야 합니다.
유지 보수의 백엔드
유지 보수의 백엔드
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"maintenance"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/httpfarm/services/newsrv/backends/0/maintenance
PUT /farms/<farmname>/services/<id>/backends/<id>/maintenance
HTTP 팜의 백엔드에서 지정된 작업을 설정합니다. 사용 가능한 작업은 아래에 설명되어 있습니다.
이름 id 서비스 고유 식별자입니다. id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 원하는 동작을 설정하십시오. 조치는 다음과 같습니다. up 백엔드는 클라이언트 요청을 수신 할 준비가되어 있으며, 유지 백엔드가 클라이언트 요청을 수신할 준비가 되지 않은 경우 이 작업은 클라이언트에 영향을 주지 않고 백엔드 서버를 중지하는 데 유용합니다. |
응답 예 :
{
"description" : "Set service backend status",
"params" : {
"action" : "maintenance"
}
}
백엔드 삭제
백엔드 삭제
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/newfarmHTTP/services/service1/backends/4
DELETE /farms/<farmname>/services/<id>/backends/<id>
HTTP 프로필 서비스에서 지정된 백엔드를 삭제합니다.
이름 id 서비스 고유 식별자입니다. id 백엔드 고유 식별자입니다.
응답 예 :
{
"description" : "Delete service backend",
"message" : "Backend removed",
"success" : "true"
}
L4xNAT 농장
L4xNAT 프로필 팜을 사용하면 HTTP 팜 프로필과 같은 레이어 4의 로드 밸런서 코어보다 훨씬 더 많은 동시 연결과 성능이 매우 높은 L7 팜을 생성할 수 있습니다. 이러한 레이어 4 성능 향상은 레이어 7 프로필이 관리할 수 있는 고급 콘텐츠 처리에 대응합니다.
또한 L4xNAT 팜은 다른 계층 7 프로파일과 함께 사용되는 하나의 가상 포트뿐만 아니라 다양한 포트를 바인딩할 수 있습니다. L4xNAT 팜에서 가상 포트 범위 또는 특정 가상 포트를 선택하려면 프로토콜 유형을 선택해야 합니다. 그렇지 않으면 팜은 가상 IP(' 문자로 표시됨)의 모든 포트에서 수신 대기합니다.'). TCP 또는 UDP 프로토콜을 선택하면 포트, ',' 사이의 여러 포트, ':' 사이의 포트 범위 또는 '가 있는 모든 포트를 지정할 수 있습니다.'. 그들 모두의 조합도 유효합니다.
이름으로 팜 검색
이름으로 팜 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4farm
GET /farms/<farmname>
지정된 팜에 대한 모든 구성을 표시합니다.
응답 BODY :
{
"backends" : [
{
"id" : 0,
"ip" : "192.168.55.40",
"port" : "88",
"priority" : 2,
"status" : "up",
"weight" : 1
},
{
"id" : 1,
"ip" : "192.168.55.41",
"port" : "88",
"priority" : 3,
"status" : "up",
"weight" : 2
}
],
"description" : "List farm l4farm",
"ipds" : {
"blacklists" : [],
"dos" : []
},
"params" : {
"algorithm" : "weight",
"fgenabled" : "false",
"fglog" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"listener" : "l4xnat",
"nattype" : "nat",
"persistence" : "",
"protocol" : "tcp",
"status" : "down",
"ttl" : 120,
"vip" : "192.168.100.241",
"vport" : "88"
}
}
응답 매개 변수
응답은 아래 형식의 JSON 객체가 될 것입니다.
농장 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ipds | 목적 | 이 팜에 적용되는 IPDS 규칙 목록입니다. |
| 매개 변수 | 목적 | 팜 구성의 매개 변수입니다. |
| 백엔드 | 목적[] | 이 팜에서 생성 된 모든 실제 서버 및 해당 구성. |
IPDS 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 블랙리스트 | 끈[] | 팜에 적용되는 블랙리스트 규칙. |
| 내부 | 끈[] | 팜에 적용되는 DoS 규칙 |
L4xNAT 팜의 매개 변수 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 연산 | 끈 | 팜에서 사용되는로드 균형 조정 알고리즘의 유형입니다. 옵션은 다음과 같습니다. 최소 접속 항상 최소 연결 서버에 연결, 무게 중량에 의한 연결 선형 디스패치, 프리 오 항상 사용 가능한 가장 우선 순위에 연결합니다. |
| 경청자 | 끈 | 리스너는 팜이 클라이언트의 요청을 처리하는 방법을 정의합니다. 정보 필드는 수정할 수 없습니다. |
| Nattype | 끈 | 로드 밸런서 레이어 4 코어가 작동하는 방법. 옵션은 다음과 같습니다. NAT sNAT 모드라고도 하는 백엔드는 클라이언트에 응답을 보내기 위해 로드 밸런서에 응답합니다. 담낭 백엔드는 클라이언트에 직접 응답하므로 로드 밸런서는 백엔드 서버에서 게이트웨이로 구성되어야 합니다. |
| 고집 | 끈 | 동일한 IP 주소가 동일한 서버에 연결됩니다. 옵션은 다음과 같습니다. "" 빈 값, 지속성이 비활성화됨, ip 지속성은 세션에서 고유 ID처럼 원본 IP를 사용합니다. |
| 프로토콜 | 끈 | 4 계층에서 균형을 유지할 프로토콜. 옵션은 다음과 같습니다. 모든 프로필은 모든 L4 프로토콜의 부하를 분산합니다. TCP 로드 밸런서는 TCP L4 프로토콜의 균형만 조정합니다. udp 로드 밸런서는 UDP L4 프로토콜의 균형만 조정합니다. 한모금 로드 밸런서는 SIP 또는 VoIP L7 프로토콜의 균형만 조정합니다. FTP 로드 밸런서는 FTP L7 프로토콜의 균형만 조정합니다. TFTP 로드 밸런서는 TFTP L7 프로토콜의 균형만 조정합니다. |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up 팜이 실행 중이고 트래픽을 캡처하고 있습니다. 아래 (down) 팜이 다운되어 트래픽을 캡처하지 않습니다. |
| TTL | 번호 | 이 필드 값은 클라이언트 소스와 백엔드 간의 지속성이 할당되는 초 수를 초 단위로 나타냅니다. 지속성을 구성해야합니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 끈 | 가상 서비스가 수신 대기 중인 팜의 포트입니다. 고유한 포트를 지정할 수 있고 범위 포트를 구분 기호로 지정할 수 있습니다. : 구분 기호로 여러 포트를 지정할 수 있습니다. ,. |
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 팜 가디언이 활성화되었습니다. 그릇된 농장 보호자가 비활성화되었습니다. |
| fglog | 끈 | Farm Guardian에서 로그 사용을 활성화합니다. fg 가능 사용하도록 설정해야합니다. |
| fgscript | 끈 | 농장 보호자가 확인할 명령입니다. 사용 가능한 명령은 libexec 경로에 있습니다. fg 가능 사용하도록 설정해야합니다. |
| fgtimecheck | 번호 | 농장 보호자는 각 'timetocheck'초를 확인합니다. fg 가능 사용하도록 설정해야합니다. |
L4xNAT 팜의 백 엔드 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 팜에서 백엔드를 식별하기 위한 ID입니다. |
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 수신 대기 중인 백엔드의 포트. 빈 값이 허용되며 가상 포트와 동일한 구성을 사용합니다. |
| 지위 | 끈 | 백엔드 상태. 값은 다음과 같습니다. up 백엔드가 연결을 수신할 준비가 되었습니다. 유지 백엔드가 연결을 수신할 준비가 되지 않았습니다. |
| 우선 | 번호 | 현재 실제 서버의 우선 순위 값입니다. 1이 가장 우선 순위인 가장 우선 순위에 항상 연결합니다. |
| 무게 | 번호 | 현재 실제 서버에 대한 가중치 값입니다. 가중치가 더 큰 백엔드는 더 많은 연결을 수신합니다. |
새 팜 만들기
새 팜 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"profile":"l4xnat", "vip":"192.168.100.241", "vport":"88","farmname":"newl4farm"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms
POST /farms
새 L4xNAT 팜을 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 농장 이름 | 끈 | 농장 이름, 고유 식별자. | 참된 |
| 윤곽 | 끈 | 생성 된 팜의 프로필입니다. L4xNAT 농장의 경우 l4xnat, 정보 메시지,이 값은 변경할 수 없습니다. | 참된 |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP | 참된 |
| vport | 끈 | 가상 서비스가 수신하는 팜의 포트 L4xNAT 팜은 다음에 의해 구분 된 다중 포트를 허용합니다. , 또는로 구분 된 범위 포트 :. | 참된 |
응답 예 :
{
"description" : "Creating farm 'newl4farm'",
"params" : {
"farmname" : "newl4farm",
"interface" : "eth0",
"profile" : "l4xnat",
"vip" : "192.168.100.241",
"vport" : "88"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 수정
농장 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"algorithm":"weight","persistence":"","newfarmname":"l4farm", "protocol":"tcp",
"nattype":"nat","ttl":125,"vip":"178.62.126.152","vport":"81"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/newfarml4
PUT /farms/<farmname>
L4xNAT 팜의 구성을 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| newfarmname | 끈 | 새 농장의 이름입니다. 농장을 멈춰야 합니다. |
| 연산 | 끈 | 팜에서 사용되는로드 균형 조정 알고리즘의 유형입니다. 옵션은 다음과 같습니다. 최소 접속 항상 최소 연결 서버에 연결, 무게 중량에 의한 연결 선형 디스패치, 프리 오 항상 사용 가능한 가장 우선 순위에 연결합니다. |
| 경청자 | 끈 | 리스너는 팜이 클라이언트의 요청을 처리하는 방법을 정의합니다. 정보 필드는 수정할 수 없습니다. |
| Nattype | 끈 | 로드 밸런서 레이어 4 코어가 작동하는 방법. 옵션은 다음과 같습니다. NAT sNAT 모드라고도 하는 백엔드는 클라이언트에 응답을 보내기 위해 로드 밸런서에 응답합니다. 담낭 백엔드는 클라이언트에 직접 응답하므로 로드 밸런서는 백엔드 서버에서 게이트웨이로 구성되어야 합니다. |
| 고집 | 끈 | 동일한 IP 주소가 동일한 서버에 연결됩니다. 옵션은 다음과 같습니다. "" 빈 값, 지속성이 비활성화됨, ip 지속성은 세션에서 고유 ID처럼 원본 IP를 사용합니다. |
| 프로토콜 | 끈 | 4 계층에서 균형을 유지할 프로토콜. 옵션은 다음과 같습니다. 모든 프로필은 모든 L4 프로토콜의 부하를 분산합니다. TCP 로드 밸런서는 TCP L4 프로토콜의 균형만 조정합니다. udp 로드 밸런서는 UDP L4 프로토콜의 균형만 조정합니다. 한모금 로드 밸런서는 SIP 또는 VoIP L7 프로토콜의 균형만 조정합니다. FTP 로드 밸런서는 FTP L7 프로토콜의 균형만 조정합니다. TFTP 로드 밸런서는 TFTP L7 프로토콜의 균형만 조정합니다. |
| TTL | 번호 | 이 필드 값은 클라이언트 소스와 백엔드 간의 지속성이 할당되는 초 수를 초 단위로 나타냅니다. 지속성을 구성해야합니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 끈 | 가상 서비스가 수신 대기 중인 팜의 포트입니다. 고유한 포트를 지정할 수 있고 범위 포트를 구분 기호로 지정할 수 있습니다. : 구분 기호로 여러 포트를 지정할 수 있습니다. ,. |
응답 예 :
{
"description" : "Modify farm l4farm",
"params" : {
"algorithm" : "weight",
"nattype" : "nat",
"newfarmname" : "l4farm",
"persistence" : "",
"protocol" : "tcp",
"ttl" : 125,
"vip" : "178.62.126.152",
"vport" : "81"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 보호자 수정
농장 보호자 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":5,"fgscript":"Command of Farm Guardian","fgenabled":"true",
"fglog":"true","service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4farm/fg
Farmguardian은 백엔드의 고급 모니터링 상태에 사용되며 현재 서비스에 대한 자체 스크립트에 대해 완전히 개인화됩니다. farmguardian이 문제를 감지하면 자동으로 실제 서버를 비활성화하고 블랙리스트로 표시됩니다.
PUT /farms/<farmname>/fg
L4xNAT 서비스에서 팜 가디언의 매개변수를 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 팜 가디언이 활성화되었습니다. 그릇된 농장 보호자가 비활성화되었습니다. |
| fglog | 끈 | Farm Guardian에서 로그 사용을 활성화합니다. fg 가능 사용하도록 설정해야합니다. |
| fgscript | 끈 | 농장 보호자가 확인할 명령입니다. 사용 가능한 명령은 libexec 경로에 있습니다. fg 가능 사용하도록 설정해야합니다. |
| fgtimecheck | 번호 | 농장 보호자는 각 'timetocheck'초를 확인합니다. fg 가능 사용하도록 설정해야합니다. |
응답 예 :
{
"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
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
IPDS 규칙 추가
IPDS 규칙 추가
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4Farm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists>
블랙리스트 또는 DoS 규칙을 팜에 적용합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 고유 식별자로 사용되는 IPDS 규칙 이름입니다. |
응답 예 :
{
"description" : "Apply a rule to a farm",
"message" : "Blacklist rule china was applied successful to the farm l4Farm.",
"success" : "true"
}
IPDS 규칙 제거
IPDS 규칙 제거
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/l4Farm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>
해당 식별자를 사용하여 지정된 팜에서 IPDS 모듈의 블랙리스트 또는 DoS 규칙을 제거합니다. name.
응답 예 :
{
"description" : "Delete a rule from a farm",
"message" : "Blacklist rule china was removed successful from the farm l4Farm.",
"success" : "true"
}
L4xNAT - 백엔드
백엔드 나열
백엔드 나열
요청 예 :
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends
GET /farms/<farmname>/backends
서비스에서 백엔드 목록을 가져옵니다.
응답 예 :
{
"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
},
]
}
응답 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 팜에서 백엔드를 식별하기 위한 ID입니다. |
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 수신 대기 중인 백엔드의 포트. 빈 값이 허용되며 가상 포트와 동일한 구성을 사용합니다. |
| 지위 | 끈 | 백엔드 상태. 값은 다음과 같습니다. up 백엔드가 연결을 수신할 준비가 되었습니다. 유지 백엔드가 연결을 수신할 준비가 되지 않았습니다. |
| max_conns | 번호 | 백엔드에 대한 최대 동시 연결 수입니다. 이 필드의 값이 0이면 백엔드에서 연결 제한을 구성하지 않은 것입니다. |
| 우선 | 번호 | 현재 실제 서버의 우선 순위 값입니다. 1이 가장 우선 순위인 가장 우선 순위에 항상 연결합니다. |
| 무게 | 번호 | 현재 실제 서버에 대한 가중치 값입니다. 가중치가 더 큰 백엔드는 더 많은 연결을 수신합니다. |
새 백엔드 만들기
새 백엔드 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.100","port":8080,"max_conns":400}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends
POST /farms/<farmname>/backends
주어진 L4xNAT Farm에 새 백엔드를 작성하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. | 참된 |
| 포트 | 번호 | 실제 서비스가 수신 대기 중인 백엔드의 포트. 빈 값이 허용되며 가상 포트와 동일한 구성을 사용합니다. | |
| max_conns | 번호 | 백엔드에 대한 최대 동시 연결 수입니다. 이 필드의 값이 0이면 백엔드에서 연결 제한을 구성하지 않은 것입니다. | |
| 우선 | 번호 | 현재 실제 서버의 우선 순위 값입니다. 1이 가장 우선 순위인 가장 우선 순위에 항상 연결합니다. 기본값은 1입니다. | |
| 무게 | 번호 | 현재 실제 서버에 대한 가중치 값입니다. 가중치가 더 큰 백엔드는 더 많은 연결을 수신합니다. 기본값은 1입니다. |
응답 예 :
{
"description" : "New farm backend",
"message" : "Backend added",
"params" : {
"id" : 5,
"ip" : "192.168.5.100",
"port" : 8080,
"max_conns" : 400,
"priority" : null,
"weight" : null
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 수정
백엔드 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.5.40","port":8080,"max_conns":220,"priority":4,"weight":7}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/2
PUT /farms/<farmname>/backends/<id>
L4xNAT 팜 서비스에서 백엔드 매개변수를 수정합니다. id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
| 포트 | 번호 | 실제 서비스가 수신 대기 중인 백엔드의 포트. 빈 값이 허용되며 가상 포트와 동일한 구성을 사용합니다. |
| max_conns | 번호 | 백엔드에 대한 최대 동시 연결 수입니다. 이 필드의 값이 0이면 백엔드에서 연결 제한을 구성하지 않은 것입니다. |
| 우선 | 번호 | 현재 실제 서버의 우선 순위 값입니다. 1이 가장 우선 순위인 가장 우선 순위에 항상 연결합니다. |
| 무게 | 번호 | 현재 실제 서버에 대한 가중치 값입니다. 가중치가 더 큰 백엔드는 더 많은 연결을 수신합니다. |
응답 예 :
{
"description" : "Modify backend",
"message" : "Backend modified",
"params" : {
"ip" : "192.168.5.40",
"port" : 8080,
"max_conns" : 220,
"priority" : 4,
"weight" : 7
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
유지 보수의 백엔드
유지 보수의 백엔드
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"maintenance"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/1/maintenance
PUT /farms/<farmname>/backends/<id>/maintenance
L4xNAT 팜의 백엔드에서 지정된 작업을 설정합니다. id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 원하는 동작을 설정하십시오. 조치는 다음과 같습니다. up 백엔드는 클라이언트 요청을 수신 할 준비가되어 있으며, 유지 백엔드가 클라이언트 요청을 수신할 준비가 되지 않은 경우 이 작업은 클라이언트에 영향을 주지 않고 백엔드 서버를 중지하는 데 유용합니다. |
응답 예 :
{
"description" : "Set backend status",
"params" : {
"action" : "maintenance"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 삭제
백엔드 삭제
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/l4farm/backends/4
DELETE /farms/<farmname>/backends/<id>
L4xNAT 팜 서비스에서 지정된 백엔드를 삭제합니다.
id 백엔드 고유 식별자입니다.
응답 예 :
{
"description" : "Delete backend",
"message" : "Backend removed",
"success" : "true"
}
GSLB 농장
일반적으로 GSLB라고 하는 글로벌 서비스 로드 밸런싱을 사용하면 DNS 서비스 계층 구조를 기반으로 로드 밸런싱 서비스를 생성할 수 있습니다. 이러한 종류의 팜은 DNS 애플리케이션 계층에서 로드 밸런싱 알고리즘 및 서비스 상태 감지 기능을 갖춘 신뢰할 수 있는 전용 DNS를 제공합니다.
이름으로 팜 검색
이름으로 팜 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm
GET /farms/<farmname>
지정된 팜에 대한 모든 구성을 표시합니다.
응답 예 :
{
"description" : "List farm gslbfarm",
"ipds" : {
"blacklists" : [],
"dos" : []
},
"params" : {
"status" : "needed restart",
"vip" : "192.168.100.155",
"vport" : 60
},
"services" : [
{
"algorithm" : "roundrobin",
"backends" : [
{
"id" : 1,
"ip" : "127.0.0.1"
},
{
"id" : 2,
"ip" : "192.168.55.40"
},
{
"id" : 4,
"ip" : "192.135.10.2"
}
],
"deftcpport" : 53,
"fgenabled" : "true",
"fgscript" : "check_tcp",
"fgtimecheck" : 5,
"id" : "service1"
},
{
"algorithm" : "prio",
"backends" : [
{
"id" : 1,
"ip" : "127.0.0.1"
},
{
"id" : 2,
"ip" : "127.0.0.1"
}
],
"deftcpport" : 80,
"fgenabled" : "false",
"fgscript" : "",
"fgtimecheck" : 5,
"id" : "prioServ"
}
],
"zones" : [
{
"defnamesv" : "ns3",
"id" : "global.com",
"resources" : [
{
"id" : 0,
"rdata" : "ns3",
"rname" : "@",
"ttl" : null,
"type" : "NS"
},
{
"id" : 1,
"rdata" : "192.168.100.155",
"rname" : "ns3",
"ttl" : null,
"type" : "A"
},
{
"id" : 3,
"rdata" : "resource2",
"rname" : "ns2",
"ttl" : null,
"type" : "NS"
},
{
"id" : 4,
"rdata" : "192.168.200.30",
"rname" : "resource2",
"ttl" : null,
"type" : "A"
}
]
},
{
"defnamesv" : "ns1",
"id" : "DOM.com",
"resources" : [
{
"id" : 0,
"rdata" : "ns1",
"rname" : "@",
"ttl" : null,
"type" : "NS"
},
{
"id" : 1,
"rdata" : "192.168.100.155",
"rname" : "ns1",
"ttl" : null,
"type" : "A"
}
]
}
]
}
응답 매개 변수
응답은 아래 형식의 JSON 객체가 될 것입니다.
농장 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ipds | 목적 | 이 팜에 적용되는 IPDS 규칙 목록입니다. |
| 매개 변수 | 목적 | 팜 구성의 매개 변수입니다. |
| 서비스 | 목적[] | 이 팜에서 생성 된 모든 서비스와 구성으로 구성됩니다. |
| 지역 | 목적[] | 이 팜에서 생성 된 모든 영역 및 구성을 가진 배열입니다. |
IPDS 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 블랙리스트 | 끈[] | 팜에 적용된 블랙리스트. |
| 내부 | 끈[] | 팜에 적용되는 DoS 규칙 |
GSLB 농장의 매개 변수 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 번호 | 가상 서비스가 수신하는 팜의 포트 |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up, 팜이 실행 중입니다. 아래 (down), 팜이 중지되거나 재시작 필요, 최신 변경 사항을 적용하려면 팜을 다시 시작해야 합니다. |
GSLB 팜의 서비스 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 백엔드 | 목적[] | 서비스에 정의 된 백엔드. |
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 농장 보호자가 활성화되어 있고 백엔드 상태를 확인하고 있습니다. 그릇된 농장 보호자가 비활성화되어 백엔드 상태를 확인하지 않습니다. GSLB 프로필에서는 팜 가디언이 비활성화된 경우에도 기본적으로 tcp 검사가 실행됩니다. |
| fgscript | 끈 | 농장 보호자가 백엔드 상태를 확인하는 데 사용할 명령입니다. 참된 사용 가능, 그릇된, 장애가 있는. fg 가능 필요합니다. |
| fgtimecheck | 번호 | Farm Guardian은 각 'timetocheck'초마다 백엔드 상태를 확인합니다. fg 가능 필요합니다. |
| id | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. |
| 연산 | 끈 | 서비스에 사용되는로드 밸런싱 알고리즘의 유형. 옵션은 다음과 같습니다. 라운드 로빈모든 백엔드 연결의 균형을 유지합니다. 프리 오 사용 가능한 첫 번째 백엔드로 모든 연결을 보냅니다. |
| 탈북자 지원 | 번호 | 기본 TCP 포트 상태 확인. 이는 백엔드 서비스가 활성 상태인지 확인하기 위해 서비스가 확인할 상태 확인 TCP 포트입니다. 빈 값은 비활성화됩니다. |
GSLB 팜의 백엔드 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 서비스의 백엔드에 대한 고유 식별자입니다. 이 식별자는 시스템에 의해 생성됩니다. |
| ip | 끈 | 실제 서비스가 수신하는 백엔드의 IP입니다. |
영역 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 고유 식별자처럼 사용되는 영역 이름입니다. |
| defnamesv | 끈 | 이것은 SOA (Start of Authority) DNS 레코드로 사용할 수있는 진입 점 루트 이름 서버입니다. |
| 자원 | 목적[] | 참고자료 영역에서 정의됩니다. |
자원 객체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 영역의 리소스에 대한 고유 식별자입니다. |
| 이름 | 끈 | 리소스 이름은 DNS 서비스가 필드의 실제 필수 데이터를 변환합니다. 자료. |
| TTL | 번호 | 현재 이름이 캐시 될 시간을 결정하는 데 필요한 현재 레코드의 Time to Live (선택 사항) 값. |
| 유형 | 끈 | DNS 레코드 유형. 옵션은 다음과 같습니다. NS, A, AAAA, CNAME, 다이나, MX, SRV, TXT, PTR or NAPTR). 더 자세한 정보는에서 GSLB - 영역 - 리소스 안내 |
| 자료 | 끈 | 레코드 유형에 필요한 실제 데이터이며 입력 값은 리소스 이름의 종류에 따라 다릅니다. 이름 및 자원 유형 유형. |
새 팜 만들기
새 팜 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"gslbfarm","profile":"gslb","vip":"192.168.100.241","vport":53}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms
POST /farms
새 GSLB 팜을 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 농장 이름 | 끈 | 팜 이름, 팜의 고유 식별자입니다. | 참된 |
| 윤곽 | 끈 | 생성 된 팜의 프로필입니다. GSLB 농장의 경우 GSLB. | 참된 |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP | 참된 |
| vport | 번호 | 가상 서비스가 수신하는 팜의 포트 | 참된 |
응답 예 :
{
"description" : "Creating farm 'gslbfarm'",
"params" : {
"farmname" : "gslbfarm",
"interface" : "eth0",
"profile" : "gslb",
"vip" : "192.168.100.241",
"vport" : 53
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 수정
농장 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"newfarmname":"gslbnewname","vip":"192.168.100.155","vport":60}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm
PUT /farms/<farmname>
GSLB 팜의 구성을 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| newfarmname | 끈 | 새 농장의 이름입니다. 이 변경을 수행하려면 팜을 중지해야 합니다. |
| vport | 번호 | 가상 서비스가 수신하는 팜의 포트 |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
응답 예 :
{
"description" : "Modify farm gslbnewname",
"params" : {
"newfarmname" : "gslbnewname",
"vip" : "192.168.100.155",
"vport" : 60
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
IPDS 규칙 추가
IPDS 규칙 추가
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"china"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbFarm/ipds/blacklists
POST /farms/<farmname>/ipds/<dos|blacklists>
블랙리스트 또는 DoS 규칙을 팜에 적용합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 고유 식별자로 사용되는 IPDS 규칙 이름입니다. |
응답 예 :
{
"description" : "Apply a rule to a farm",
"message" : "Blacklist rule china was applied successful to the farm gslbFarm.",
"success" : "true"
}
IPDS 규칙 제거
IPDS 규칙 제거
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbFarm/ipds/blacklists/china
DELETE /farms/<farmname>/ipds/<dos|blacklists>/<name>
해당 식별자를 사용하여 지정된 팜에서 블랙리스트 또는 DoS 규칙 제거 name.
응답 예 :
{
"description" : "Delete a rule form a farm",
"message" : "Blacklist rule china was removed successful from the farm gslbFarm.",
"success" : "true"
}
GSLB - 서비스
GSLB 서비스는 실제 서버 그룹과 이들에 사용될 관련 알고리즘을 나타냅니다. 새 서비스를 생성하려면 유효한 식별 이름과 사용할 알고리즘을 설정해야 합니다.
사용 가능한 서비스는 다음과 같습니다.
라운드 로빈: 동등한 공유. 모든 활성 실제 서버에 대한 균등한 트래픽 균형. 들어오는 모든 연결에 대해 밸런서는 다음 라운드 로빈 실제 서버를 할당하여 요청을 전달합니다.
우선 순위: 항상 사용 가능한 가장 우선 순위에 연결합니다. 우선 순위가 가장 높은 동일한 서버에 대한 모든 연결의 균형을 맞춥니다. 이 서버가 다운되면 다음으로 높은 서버로 연결이 전환됩니다. 이 알고리즘을 사용하면 여러 실제 서버로 Active-Pasive 클러스터 서비스를 구축할 수 있습니다.
GSLB 농장 용 서비스 개체
| 분야 | 타입 | 설명: |
|---|---|---|
| 백엔드 | 목적[] | 서비스에 정의 된 백엔드. |
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 농장 보호자가 활성화되어 있고 백엔드 상태를 확인하고 있습니다. 그릇된 농장 보호자가 비활성화되어 백엔드 상태를 확인하지 않습니다. GSLB 프로필에서는 팜 가디언이 비활성화된 경우에도 기본적으로 tcp 검사가 실행됩니다. |
| fgscript | 끈 | 농장 보호자가 백엔드 상태를 확인하는 데 사용할 명령입니다. 참된 사용 가능, 그릇된, 장애가 있는. fg 가능 필요합니다. |
| fgtimecheck | 번호 | Farm Guardian은 각 'timetocheck'초마다 백엔드 상태를 확인합니다. fg 가능 필요합니다. |
| id | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. |
| 연산 | 끈 | 서비스에 사용되는로드 밸런싱 알고리즘의 유형. 옵션은 다음과 같습니다. 라운드 로빈모든 백엔드 연결의 균형을 유지합니다. 프리 오 사용 가능한 첫 번째 백엔드로 모든 연결을 보냅니다. |
| 탈북자 지원 | 끈 | 기본 TCP 포트 상태 확인. 이는 백엔드 서비스가 활성 상태인지 확인하기 위해 서비스가 확인할 상태 확인 TCP 포트입니다. 빈 값은 비활성화됩니다. |
새 서비스 만들기
새 서비스 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"service1","algorithm":"roundrobin"}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services
POST /farms/<farmname>/services
주어진 GSLB Farm에 서비스를 만듭니다. 이 변경 내용을 적용하려면 팜을 다시 시작해야합니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| id | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. | 참된 |
| 연산 | 끈 | 서비스에 사용되는로드 밸런싱 알고리즘의 유형. 옵션은 다음과 같습니다. 라운드 로빈모든 백엔드 연결의 균형을 유지합니다. 프리 오 사용 가능한 첫 번째 백엔드로 모든 연결을 보냅니다. | 참된 |
응답 예 :
{
"description" : "New service service1",
"params" : {
"algorithm" : "roundrobin",
"id" : "service1"
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
서비스 수정
서비스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"deftcpport":53}' https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1
PUT /farms/<farmname>/services/<id>
GSLB 팜에서 서비스의 매개변수를 수정합니다. id 수정할 서비스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 탈북자 지원 | 번호 | 이는 백엔드 서비스가 활성 상태인지 확인하기 위해 서비스가 확인할 상태 확인 TCP 포트입니다. |
응답 예 :
{
"description" : "Modify service service1 in farm gslbfarm",
"info" : "There're changes that need to be applied, stop and start farm to apply them!",
"params" : {
"deftcpport" : 53
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 보호자 수정
농장 보호자 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"fgtimecheck":"5","fgscript":"check_tcp","fgenabled":"true",
"service":"service1"}' https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/fg
Farmguardian은 백엔드의 고급 모니터링 상태에 사용되며 현재 서비스에 대한 자체 스크립트에 대해 완전히 개인화됩니다. farmguardian이 문제를 감지하면 자동으로 실제 서버를 비활성화하고 블랙리스트로 표시됩니다.
PUT /farms/<farmname>/fg
GSLB 서비스에서 팜 가디언의 매개변수를 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| fg 가능 | 끈 | 팜 가디언 사용을 활성화합니다. 참된 농장 보호자가 활성화되어 있고 백엔드 상태를 확인하고 있습니다. 그릇된 농장 보호자가 비활성화되어 백엔드 상태를 확인하지 않습니다. GSLB 프로필에서는 fgenabled가 비활성화된 경우에도 기본적으로 tcp 검사가 실행됩니다. | |
| fgscript | 끈 | 농장 보호자가 백엔드 상태를 확인하는 데 사용할 명령입니다. 참된 사용 가능, 그릇된, 장애가 있는. | 참이면 fg 가능 사용 가능합니다. |
| fgtimecheck | 번호 | Farm Guardian은 각 'timetocheck'초마다 백엔드 상태를 확인합니다. fg 가능 필요합니다. | |
| 서비스 | 끈 | 서비스 식별자, id, 어느 농장 보호자가 수정할지. | 참된 |
응답 예 :
{
"description" : "Modify farm guardian",
"message" : "Success, some parameters have been changed in farm guardian in farm gslbfarm.",
"params" : {
"fgenabled" : "true",
"fgscript" : "check_tcp",
"fgtimecheck" : 5
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
서비스 삭제
서비스 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1
DELETE /farms/<farmname>/services/<id>
GSLB Farm의 주어진 서비스를 삭제하십시오. id 삭제할 서비스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete service service1 in farm gslbfarm",
"message" : "The service service1 in farm gslbfarm has been deleted.",
"success" : "true",
"status": "needed restart"
}
GSLB - 서비스 - 백엔드
이 섹션에서는 서비스와 관련된 실제 서비스 목록을 관리합니다.
백엔드 나열
백엔드 나열
요청 예 :
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends
GET /farms/<farmname>/services/<id>/backends
서비스에서 백엔드 목록을 가져옵니다. id 서비스 고유 식별자입니다.
응답 예 :
{
"description" : "List service backends",
"params" : [
{
"id" : 1,
"ip" : "127.0.0.1"
},
{
"id" : 2,
"ip" : "192.168.55.40"
}
]
}
응답 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 서비스의 백엔드에 대한 고유 식별자입니다. 이 식별자는 시스템에 의해 생성됩니다. |
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP |
새 백엔드 만들기
새 백엔드 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.135.10.2"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends
POST /farms/<farmname>/services/<id>/backends
GSLB Farm에서 주어진 서비스에 새로운 백엔드를 생성하십시오. id 백엔드가 추가 될 서비스 고유 식별자입니다.
우선 순위 서비스에는 2 백엔드가 maximun, 활성 호스트 및 수동 호스트로 있습니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP | 참된 |
응답 예 :
{
"description" : "New service backend",
"message" : "Added backend to service succesfully",
"params" : {
"id" : 4,
"ip" : "192.135.10.2"
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 수정
백엔드 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.2.30"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends/1
PUT /farms/<farmname>/services/<id>/backends/<id>
GSLB Farm의 서비스에서 백엔드의 매개변수를 수정합니다.
주의 사항 PUT 위의 첫 번째 id 서비스 고유 식별자이고 다음 id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP |
응답 예 :
{
"description" : "Modify service backend",
"info" : "There're changes that need to be applied, stop and start farm to apply them!",
"message" : "Backend modified",
"params" : {
"ip" : "192.168.2.30"
},
"status" : "needed restart"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 삭제
백엔드 삭제
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/services/service1/backends/3
DELETE /farms/<farmname>/services/<servicename>/backends/<id>
GSLB 팜 서비스에서 지정된 백엔드 삭제
응답 예 :
{
"description" : "Delete service backend",
"message" : "Backend removed",
"success" : "true"
}
GSLB - 구역
GSLB 영역 섹션에서는 정의된 서비스를 사용하여 추가 로드 밸런싱 레코드가 있는 완전한 DNS 영역을 생성하는 데 필요한 DNS 도메인 이름, 하위 도메인, 별칭 등을 설명합니다.
영역 만들기
영역 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"id":"global.conf"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones
POST /farms/<farmname>/zones
DNS 영역을 만듭니다.
요청 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| id | 번호 | 고유 식별자처럼 사용되는 영역 이름입니다. | 참된 |
응답 예 :
{
"description" : "New zone global.com",
"params" : {
"id" : "global.com"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
영역 수정
영역 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"defnamesv":"ns3"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com
PUT /farms/<farmname>/zones/<id>
영역의 매개 변수를 수정하십시오. id 수정 될 영역 고유 식별자입니다.
요청 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| defnamesv | 끈 | 이것은 SOA (Start of Authority) DNS 레코드로 사용할 수있는 진입 점 루트 이름 서버입니다. |
응답 예 :
{
"description" : "Modify zone global.com in farm gslbfarm",
"params" : {
"defnamesv" : "ns3"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
영역 삭제
영역 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/dom.com
DELETE /farms/<farmname>/zones/<id>
GSLB Farm의 지정된 영역을 삭제합니다.
응답 예 :
{
"description" : "Delete zone dom.com in farm gslbfarm.",
"message" : "The zone dom.com in farm gslbfarm has been deleted.",
"success" : "true"
}
GSLB - 영역 - 리소스
DNS 서비스로 정의 된 리소스는 요청을 해결합니다. Zevenet로드 밸런싱의 가능한 DNS 리소스는 다음과 같습니다.
- NS. 이름 서버 유형 레코드는 주어진 권위있는 이름 서버를 사용하도록 DNS 영역을 위임합니다.
- A. 주소 유형 레코드는 호스트의 IPv4 주소를 리턴합니다.
- CNAME. 정식 이름 형식 레코드는 지정된 이름의 별칭을 나타냅니다.
- 다이나. 동적 주소 유형 레코드는 해당 서비스에 대해 선택된 알고리즘에 따라 팜 구성에서 이미 생성 된 GSLB 서비스에서 지정한 동적 주소를 반환합니다.
- AAAA. 주소 유형 레코드는 호스트의 IPv6 주소를 리턴합니다.
- MX. 메일 교환 유형 레코드는 도메인 이름을 해당 도메인의 메시지 전송 에이전트 목록에 매핑합니다.
- SRV. 서비스 로케이터 유형 레코드, 일반화 된 서비스 위치 레코드. MX와 같은 프로토콜 특정 레코드를 작성하는 대신 최신 프로토콜에 사용됩니다.
- TXT. 텍스트 형식 레코드로, 필요할 때 움 직일 수있는 텍스트 기반 정보를 저장하는 데 사용됩니다. 가장 일반적으로 TXT 레코드는 SPF 데이터를 보유하고 도메인 소유권을 확인하는 데 사용됩니다.
- PTR. 포인터 레코드, 표준 이름에 대한 포인터. CNAME과 달리 DNS 처리가 중지되고 이름 만 반환됩니다. 가장 보편적 인 용도는 DNS 역방향 조회를 구현하는 것입니다.
- NAPTR. 명명 기관 포인터 (Naming Authority Pointer) : 도메인 이름의 정규 표현식 기반 재 작성을 허용합니다. 그런 다음 URI, 추가 도메인 이름 조회 등으로 사용될 수 있습니다.
자원 목록 표시
자원 목록 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources
GET /farms/<farmname>/zones/<id>/resources
영역의 리소스 목록을 가져옵니다. id 영역 고유 식별자입니다.
응답 예 :
{
"description" : "List zone resources",
"params" : [
{
"id" : 0,
"rdata" : "ns3",
"rname" : "@",
"ttl" : null,
"type" : "NS"
},
{
"id" : 1,
"rdata" : "192.168.100.155",
"rname" : "ns3",
"ttl" : null,
"type" : "A"
},
{
"id" : 2,
"rdata" : "192.168.0.9",
"rname" : "resource2",
"ttl" : 10,
"type" : "A"
},
{
"id" : 3,
"rdata" : "resource2",
"rname" : "ns2",
"ttl" : null,
"type" : "NS"
}
]
}
응답 매개 변수
이 호출은 벨로우즈 매개 변수가있는 자원 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 영역의 리소스에 대한 고유 식별자입니다. |
| 이름 | 끈 | 리소스 이름은 DNS 서비스가 필드의 실제 필수 데이터를 변환합니다. 자료. |
| TTL | 번호 | 현재 이름이 캐시 될 시간을 결정하는 데 필요한 현재 레코드의 Time to Live (선택 사항) 값. |
| 유형 | 끈 | DNS 레코드 유형. 옵션은 다음과 같습니다. NS, A, AAAA, CNAME, 다이나, MX, SRV, TXT, PTR or NAPTR). 더 자세한 정보는에서 GSLB - 영역 - 리소스 안내 |
| 자료 | 끈 | 레코드 유형에 필요한 실제 데이터이며 입력 값은 리소스 이름의 종류에 따라 다릅니다. 이름 및 자원 유형 유형. |
새 리소스 만들기
새 리소스 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"rname":"resource2", "rdata":"192.168.0.9", "ttl":10, "type":"A" }'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources
POST /farms/<farmname>/zones/<id>/resources
GSLB Farm의 지정된 영역에 새 리소스를 만듭니다. id 리소스가 추가될 수정될 영역 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 이름 | 끈 | 리소스 이름은 DNS 서비스가 필드의 실제 필수 데이터를 변환합니다. 자료. | 참된 |
| TTL | 번호 | 현재 레코드의 TTL(Time to Live) 값입니다. 죽을 때까지 요청할 수 있는 최대 라우터 장치 수입니다. 유용한 것은 패킷이 net 루프에 입력되지 않는다는 것입니다. | |
| 유형 | 끈 | DNS 레코드 유형. 옵션은 다음과 같습니다. NS, A, AAAA, CNAME, 다이나, MX, SRV, TXT, PTR or NAPTR). 더 자세한 정보는에서 GSLB - 영역 - 리소스 안내 | 참된 |
| 자료 | 끈 | 레코드 유형에 필요한 실제 데이터이며 입력 값은 리소스 이름의 종류에 따라 다릅니다. 이름 및 자원 유형 유형. 면 다이나 에서 선택됨 유형 rdata 값은 다음 중 하나 여야합니다. 서비스 이 구역에서. | 참된 |
응답 예 :
{
"description" : "New zone resource",
"message" : "Resource added",
"params" : {
"rdata" : "192.168.0.9",
"rname" : "resource2",
"ttl" : 10,
"type" : "A",
"zone" : "global.com"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
자원 수정
자원 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"rname":"resource2", "rdata":"192.168.200.30","ttl":null, "type":"A" }'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources/1
PUT /farms/<farmname>/zones/<id>/resources/<id>
GSLB Farm의 영역에있는 자원의 매개 변수를 수정하십시오.
이름 id 영역 고유 식별자이고, 다음 id 자원 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 이름 | 끈 | 리소스 이름은 DNS 서비스가 필드의 실제 필수 데이터를 변환합니다. 자료. |
| TTL | 번호 | 현재 이름이 캐시 될 시간을 결정하는 데 필요한 현재 레코드의 Time to Live (선택 사항) 값. |
| 유형 | 끈 | DNS 레코드 유형. 옵션은 다음과 같습니다. NS, A, AAAA, CNAME, 다이나, MX, SRV, TXT, PTR or NAPTR). 더 자세한 정보는에서 GSLB - 영역 - 리소스 안내 |
| 자료 | 끈 | 레코드 유형에 필요한 실제 데이터이며 입력 값은 리소스 이름의 종류에 따라 다릅니다. 이름 및 자원 유형 유형. 면 유형 가치가있다 다이나 그때 자료 사용 가능한 서비스 name |
응답 예 :
{
"description" : "Modify zone resource",
"message" : "Resource modified",
"params" : {
"rdata" : "192.168.200.30",
"rname" : "resource2",
"ttl" : null,
"type" : "A"
},
"success" : "true"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
자원 삭제
자원 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/gslbfarm/zones/global.com/resources/3
DELETE /farms/<farmname>/zones/<id>/resources/<id>
GSLB Farm의 영역에서 주어진 자원 삭제
에서 DELETE 첫 번째 URI 위에있는 URI id 영역 고유 식별자이고 다음 id 자원 고유 식별자입니다.
응답 예 :
{
"description" : "Delete zone resource",
"message" : "Resource removed",
"success" : "true"
}
데이터 링크 팜
데이터 링크 팜 프로필을 사용하면 백엔드가 업링크 라우터 또는 게이트웨이인 경로 기반 팜을 만들 수 있습니다. 이러한 종류의 팜 프로필은 로드 밸런서를 업링크 채널 멀티플렉서(입력 1개 및 라우터 라인 출력 여러 개)로 사용하여 여러 업링크 WAN 라우터 액세스를 공유할 준비가 되어 있습니다. 따라서 데이터 링크 팜은 고가용성 통신 링크로 사용될 수 있으며 추가로 라우터 백엔드 링크 간의 대역폭 양을 결합하는 대역폭 증가로 사용될 수 있습니다.
이름으로 팜 검색
이름으로 팜 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms/dlink
GET /farms/<farmname>
팜에 대한 모든 구성을 표시합니다.
응답 예 :
{
"backends" : [
{
"id" : 0,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"weight" : 2
},
{
"id" : 1,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"weight" : 1
}
],
"description" : "List farm dlink",
"params" : {
"algorithm" : "weight",
"status" : "down",
"vip" : "192.168.100.199"
}
}
응답 매개 변수
응답은 아래 형식의 JSON 객체가 될 것입니다.
농장 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 매개 변수 | 목적 | 팜 구성의 매개 변수입니다. |
| 백엔드 | 목적[] | 이 팜에서 생성 된 실제 서버 및 해당 구성. |
데이터 링크 팜의 매개 변수 객체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 연산 | 끈 | 팜에서 사용되는로드 균형 조정 알고리즘의 유형입니다. 옵션은 다음과 같습니다. 무게, 밸런서는 가중치 속성이 더 높은 더 많은 충전 백엔드가 주어지면 사용 가능한 모든 백엔드에 분배하거나 프리 오, 모든 연결을 작은 값으로 백엔드로 보냅니다. 우선. |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up, 팜이 실행 중이거나 아래 (down), 팜이 중지되었습니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
데이터 링크 팜의 백엔드 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 팜의 백엔드에 대한 고유 식별자입니다. |
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP |
| 인터페이스 | 끈 | 백엔드가 연결된 로컬 네트워크 인터페이스입니다. |
| 우선 | 번호 | 현재 실제 서버의 우선 순위 값입니다. 다음과 같은 경우에 사용됩니다. 연산 필드는 우선 순위로 구성되며 낮은 우선 순위가 우선합니다. |
| 무게 | 번호 | 현재 실제 서버의 가중치 값입니다. 다음과 같은 경우에 사용됩니다. 연산 필드는 무게로 구성입니다. |
새 팜 만들기
새 팜 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"farmname":"dlink", "vip":"192.168.100.241", "profile":"datalink" }'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/farms
POST /farms
새 데이터 링크 팜을 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 농장 이름 | 끈 | 농장 이름, 고유 식별자. | 참된 |
| 윤곽 | 끈 | 생성된 팜의 프로필입니다. 데이터 링크 팜의 경우 데이터 링크 | 참된 |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP | 참된 |
응답 예 :
{
"description" : "Creating farm 'dlink'",
"params" : {
"farmname" : "dlink",
"interface" : "eth0",
"profile" : "datalink",
"vip" : "192.168.100.241"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
농장 수정
농장 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"newfarmname":"dlink2", "vip":"192.168.100.199","algorithm":"weight"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink
PUT /farms/<farmname>
데이터 링크 팜의 구성을 수정하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| newfarmname | 끈 | 새 농장 이름입니다. 농장을 멈춰야 합니다. |
| 연산 | 끈 | 팜에서 사용되는로드 균형 조정 알고리즘의 유형입니다. 옵션은 다음과 같습니다. 무게, 밸런서는 가중치 속성이 더 높은 더 많은 충전 백엔드가 주어지면 사용 가능한 모든 백엔드에 분배하거나 프리 오, 모든 연결을 작은 값으로 백엔드로 보냅니다. 우선. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
응답 예 :
{
"description" : "Modify farm dlink",
"params" : {
"algorithm" : "weight",
"vip" : "192.168.100.199",
"newfarmname" : "dlink2"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
데이터 링크 - 백엔드
데이터 링크 팜의 백엔드는 서비스 라우팅을 통한 게이트웨이입니다. 서비스는 이 게이트웨이 간에 멀티플렉싱하며 일부는 사용할 수 없으며 서비스는 다른 게이트웨이를 사용합니다.
백엔드 나열
백엔드 나열
요청 예 :
curl -k -X GET -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends
GET /farms/<farmname>/backends
서비스에서 백엔드 목록을 가져옵니다.
응답 예 :
[
{
"id" : 6,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"weight" : 2
},
{
"id" : 7,
"interface" : "eth0",
"ip" : "192.168.100.11",
"priority" : 2,
"weight" : 1
}
]
응답 매개 변수
이 호출은 벨로우즈 매개 변수가있는 백엔드 객체 배열을 반환합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 팜의 백엔드에 대한 고유 식별자입니다. 이 식별자는 시스템에 의해 생성됩니다. |
| 인터페이스 | 끈 | 백엔드가 연결된 로컬 네트워크 인터페이스입니다. |
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP |
| 우선 | 번호 | 현재 백엔드의 우선 순위 값입니다. 다음과 같은 경우에 사용됩니다. 연산 필드는 우선 순위로 구성되며 낮은 우선 순위가 우선합니다. |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. 다음과 같은 경우에 사용됩니다. 연산 필드는 무게로 구성입니다. |
새 백엔드 만들기
새 백엔드 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.10","interface":"eth0","priority":2,"weight":2}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends
POST /farms/<farmname>/backends
주어진 데이터 링크 팜에서 새 백엔드를 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 실제 서비스가 듣고있는 백엔드의 IP | 참된 |
| 인터페이스 | 끈 | 백엔드가 연결된 로컬 네트워크 인터페이스입니다. | 참된 |
| 우선 | 번호 | 현재 실제 서버에 대한 우선 순위 값입니다. 다음 경우에 사용됩니다. 연산 필드는 우선 순위로 구성되며 낮은 우선 순위가 우선합니다. 기본값은 1입니다. | |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. 다음과 같은 경우에 사용됩니다. 연산 필드는 무게로 구성입니다. 기본값은 1입니다. |
응답 예 :
{
"description" : "New farm backend",
"message" : "Backend added",
"params" : {
"id" : 6,
"interface" : "eth0",
"ip" : "192.168.100.10",
"priority" : 2,
"weight" : 2
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 수정
백엔드 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.102.50","interface":"eth0", "weight":1,"timeout":1}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/datalink/backends/2
PUT /farms/<farmname>/backends/<id>
데이터 링크 팜의 서비스에서 백엔드 매개 변수를 수정합니다. id 백엔드 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 끈 | ip | 실제 서비스가 듣고있는 백엔드의 IP |
| 인터페이스 | 끈 | 백엔드가 연결된 로컬 네트워크 인터페이스입니다. |
| 시간 제한 | 번호 | 특정 요청에 응답하는 것은 백엔드 시간 초과입니다. |
| 무게 | 번호 | 현재 백엔드의 가중치 값입니다. |
응답 예 :
{
"description" : "Modify backend",
"message" : "Backend modified",
"params" : {
"interface" : "eth0",
"ip" : "192.168.102.50",
"timeout" : 1,
"weight" : 1
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
백엔드 삭제
백엔드 삭제
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/farms/dlink/backends/4
DELETE /farms/<farmname>/backends/<id>
데이터 링크 팜의 서비스에서 지정된 백엔드를 삭제합니다. id 백엔드 고유 식별자입니다.
응답 예 :
{
"description" : "Delete backend",
"message" : "Backend removed",
"success" : "true"
}
네트워크
Zevenet은 다양한 유형의 네트워크 인터페이스로 작동 할 수 있습니다.
이 섹션에서는 NIC, VLAN, 가상 및 본딩 인터페이스에서 작업을 나열, 생성, 구성, 삭제 및 설정할 수 있습니다.
NIC: 또는 네트워크 인터페이스 카드, 그것은 컴퓨터 하드웨어 구성 요소이며 tis 종류의 인터페이스는 Zevenet에서 정의하고 관리할 수 있는 다음과 같은 종류의 인터페이스의 기반입니다.
VLAN: 가상랜카드는 네트워크 분할 서비스를 제공하는 종류 또는 네트워크 인터페이스이다. NIC 인터페이스를 통해 둘 이상의 VLAN을 만들 수 있습니다. 본딩: 다른 공급업체에서 트렁크 인터페이스라고도 하는 이러한 종류의 NIC는 둘 이상의 NIC 인터페이스로 만들 수 있습니다. Zevenet은 7가지 유형의 본딩 인터페이스를 지원합니다.
가상: 이러한 종류의 인터페이스는 위에서 설명한 모든 종류의 인터페이스 위에 만들 수 있습니다. 이러한 종류의 인터페이스는 Farms에 사용되어야 하며 가상 인터페이스는 부모와 동일한 서브넷에 정의되어야 합니다.
모든 인터페이스 나열
모든 인터페이스 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic
GET /interfaces
구성이있는 시스템의 인터페이스 목록을 가져옵니다.
응답 예 :
{
"description" : "List interfaces",
"interfaces" : [
{
"gateway" : "",
"ip" : "",
"mac" : "66:eb:31:0e:07:71",
"name" : "bond2",
"netmask" : "",
"status" : "down",
"type" : "bond"
},
{
"gateway" : "192.168.100.1",
"ip" : "192.168.100.121",
"mac" : "a2:6d:80:29:87:c6",
"name" : "bondiface",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "bond"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.241",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "nic",
"is_slave" : "false"
},
{
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"status" : "down",
"type" : "vlan"
},
{
"gateway" : "",
"ip" : "192.168.100.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virt",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "virtual"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0",
"status" : "down",
"type" : "virtual"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up",
"type" : "nic",
"is_slave" : "false"
},
{
"gateway" : "",
"ip" : "",
"mac" : "66:eb:31:0e:07:71",
"name" : "eth2",
"netmask" : "",
"status" : "up",
"type" : "nic",
"is_slave" : "true"
},
{
"gateway" : "",
"ip" : "",
"mac" : "a2:6d:80:29:87:c6",
"name" : "eth3",
"netmask" : "",
"status" : "up",
"type" : "nic",
"is_slave" : "true"
}
]
}
응답 매개 변수
응답은 인터페이스 객체 배열이있는 JSON 객체입니다.
인터페이스 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 가상 인터페이스의 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. |
| 넷 마스크 | 끈 | 인터페이스의 넷마스크. 이 값은 가상 인터페이스에서 수정할 수 없으며 상위 인터페이스에서 상속됩니다. |
| 게이트웨이 | 끈 | 인터페이스의 게이트웨이. 이 값은 가상 인터페이스에서 수정할 수 없으며 상위 인터페이스에서 상속됩니다. |
| 맥 | 끈 | 인터페이스의 MAC. 이 값은 본딩 인터페이스의 첫 번째 NIC 슬레이브에서 상속됩니다. 가상 및 VLAN 인터페이스에서는 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| 유형 | 끈 | 다른 종류의 인터페이스는 다음과 같습니다. NIC, VLAN, 가상 or 증서. |
| is_slave | 끈 | NIC 인터페이스에서만 사용 가능 참된인터페이스는 본딩 인터페이스의 일부이며, 그릇된 인터페이스는 본딩 인터페이스의 일부가 아닙니다. |
기본 게이트웨이 검색
기본 게이트웨이 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/interfaces/gateway
GET /interfaces/gateway
기본 게이트웨이는로드 밸런서의 모든 인터페이스에서 로컬로 도달 할 수없는 모든 대상 트래픽을 보내는 노드입니다.
기본 게이트웨이 인터페이스의 매개 변수를 가져옵니다.
응답 예 :
{
"description" : "Default gateway",
"params" : {
"address" : "192.168.100.5",
"interface" : "eth0"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 주소 | 끈 | 그것은 게이트웨이의 IP입니다. |
| 인터페이스 | 끈 | 게이트웨이의 인터페이스 이름. |
기본 게이트웨이 수정
기본 게이트웨이 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"interface":"eth0","address":"192.168.100.5"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces
PUT /interfaces/gateway
게이트웨이 인터페이스의 구성을 수정하십시오.
응답 예 :
{
"description" : "Modify default gateway",
"message" : "The default gateway has been changed successfully",
"success" : "true"
}
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 주소 | 끈 | 그것은 게이트웨이의 IP입니다. |
| 인터페이스 | 끈 | 게이트웨이의 인터페이스 이름. |
게이트웨이 구성 삭제
DELETE /interfaces/gateway
기본 게이트웨이 구성의 구성을 삭제하십시오.
경고: 게이트웨이가 구성 해제되면 외부 네트워크 세그먼트에서 Zevenet에 연결할 수 없습니다.
게이트웨이 구성 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/gateway
응답 메시지
게이트웨이가 동일한 네트워크 세그먼트에서 구성 해제되면 이 메시지가 나타나고 그렇지 않으면 연결이 끊어집니다.
응답 예 :
{
"description" : "Remove default gateway",
"message" : "The default gateway has been deleted successfully",
"params" : {
"address" : null,
"interface" : null
}
}
네트워크 - NIC 인터페이스
NIC 인터페이스는 Zevenet로드 밸런서에 연결된 물리적 인 인터페이스입니다.
시스템은 새로운 인터페이스가 연결되면 자동으로 인식합니다.
NIC 인터페이스를 부모로 사용하면 특성이 다른 다른 유형의 인터페이스를 만들 수 있습니다. 사용 가능한 인터페이스는 다음과 같습니다. VLAN,가상 및 본딩.
NIC 인터페이스 나열
GET /interfaces/nic
NIC 인터페이스의 모든 매개 변수를 가져옵니다.
NIC 인터페이스 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic
응답 예 :
{
"description" : "List NIC interfaces",
"interfaces" : [
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.241",
"is_slave" : "false",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0",
"netmask" : "255.255.255.0",
"status" : "up"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"is_slave" : "false",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up"
},
{
"gateway" : "",
"ip" : "",
"is_slave" : "false",
"mac" : "a2:6d:80:29:87:c6",
"name" : "eth3",
"netmask" : "",
"status" : "down"
}
]
}
응답 매개 변수
응답은 NIC 인터페이스 객체 배열을 가진 JSON 객체입니다.
NIC 인터페이스 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트에 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 링크 레이어 고유 식별자. 수정할 수 없습니다. |
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| is_slave | 끈 | 참된 인터페이스는 결합 인터페이스의 일부이며, 그릇된 인터페이스는 본딩 인터페이스의 일부가 아닙니다. |
NIC 인터페이스 검색
NIC 인터페이스 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1
GET /interfaces/nic/<name>
NIC 인터페이스의 모든 매개 변수를 가져옵니다. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Show NIC interface",
"interface" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"is_slave" : "false",
"mac" : "62:30:43:36:29:ac",
"name" : "eth1",
"netmask" : "255.255.255.0",
"status" : "up"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트에 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 링크 레이어 고유 식별자. 수정할 수 없습니다. |
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| 유형 | 끈 | 다른 종류의 인터페이스는 다음과 같습니다. NIC, VLAN, 가상 or 증서. 각각은 네트워크 하위 메뉴에서 정의됩니다. |
| is_slave | 끈 | 참된 인터페이스는 결합 인터페이스의 일부이며, 그릇된 인터페이스는 본딩 인터페이스의 일부가 아닙니다. |
NIC 인터페이스 수정
NIC 인터페이스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.102","netmask":"255.255.255.0","gateway":"192.168.100.5"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1
PUT /interfaces/nic/<name>
NIC 인터페이스의 매개 변수를 수정하십시오. name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
응답 예 :
{
"description" : "Configure nic interface",
"params" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.102",
"netmask" : "255.255.255.0"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
NIC 구성 삭제
NIC 구성 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth3
DELETE /interfaces/nic/<name>
NIC 인터페이스의 구성을 삭제하십시오. 이 작업을 수행하면 인터페이스가 쓸모 없게되어 다시 구성 할 준비가됩니다. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete nic interface",
"message" : "The configuration for the network interface eth3 has been deleted.",
"success" : "true"
}
NIC 인터페이스 동작 설정
NIC 인터페이스 동작 설정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/nic/eth1/actions
POST /interfaces/nic/<name>/actions
NIC 인터페이스에 조치를 적용하십시오. 이 호출을 통해 네트워크 인터페이스를 활성화 또는 비활성화 할 수 있습니다.
name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 인터페이스에 적용 할 작업입니다. 사용할 수있는 값은 다음과 같습니다. up, 인터페이스를 활성화하고 사용 준비를하십시오. 아래 (down)패킷을 수신하지 않거나 보내지 않도록 인터페이스를 비활성화하십시오. | 참된 |
응답 예 :
{
"description" : "Action on nic interface",
"params" : {
"action" : "up"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
네트워크 - 본딩 인터페이스
Linux 본딩 인터페이스 또는 다른 공급업체에서 트렁크라고도 부르는 이 인터페이스는 여러 네트워크 인터페이스를 단일 논리적 "본드" 인터페이스로 통합하는 방법을 제공합니다. 결합 된 인터페이스의 동작은 모드에 따라 다르며 Zevenet Load Balancer는 다음 방법을 지원합니다.
라운드 로빈 정책: 사용 가능한 첫 번째 슬레이브에서 마지막 슬레이브로 순차적으로 패킷을 전송합니다. 이 모드는로드 균형 조정 및 내결함성을 제공합니다.
액티브 백업 정책: 본드에서 하나의 슬레이브만 활성화됩니다. 활성 슬레이브가 실패하는 경우에만 다른 슬레이브가 활성화됩니다. 본드의 MAC 주소는 스위치 혼동을 피하기 위해 하나의 포트(네트워크 어댑터)에서만 외부에서 볼 수 있습니다. 이 모드는 내결함성을 제공합니다. 기본 옵션은 이 모드의 동작에 영향을 미칩니다.
XOR 정책: 대상 MAC 주소와 함께 원본 MAC 주소 XOR을 기반으로 전송합니다. 이렇게하면 각 대상 MAC 주소에 대해 동일한 슬레이브가 선택됩니다. 이 모드는로드 균형 조정 및 내결함성을 제공합니다.
방송 정책: 모든 슬레이브 인터페이스의 모든 것을 전송합니다. 이 모드는 내결함성을 제공합니다.
IEEE 802.3ad LACP: 동일한 속도 및 이중 설정을 공유하는 집계 그룹을 만듭니다. 802.3ad 사양에 따라 활성 수집기의 모든 슬레이브를 사용합니다.
사전 요구 사항 :
각 슬레이브의 속도와 듀플렉스를 검색하기위한 기본 드라이버의 네트워크 인터페이스 지원.
IEEE 802.3ad 동적 링크 집계를 지원하는 스위치. 대부분의 스위치는 802.3ad 모드를 사용하려면 일부 유형의 구성이 필요합니다.
적응 형 전송로드 밸런싱: 특별한 스위치 지원이 필요하지 않은 채널 본딩. 나가는 트래픽은 각 슬레이브의 현재 부하(속도에 비례하여 계산됨)에 따라 분산됩니다. 들어오는 트래픽은 현재 슬레이브에서 수신합니다. 수신 슬레이브가 실패하면 다른 슬레이브가 실패한 수신 슬레이브의 MAC 주소를 인수합니다.
사전 요구 사항 :
각 슬레이브의 속도를 검색하기위한 기본 드라이버 지원.
적응 형로드 균형 조정: 적응형 전송 로드 밸런싱과 IPV4 트래픽에 대한 수신 로드 밸런싱을 포함하며 특별한 스위치 지원이 필요하지 않습니다. 수신 로드 밸런싱은 ARP 협상을 통해 이루어집니다. 본딩 드라이버는 나가는 도중에 로컬 시스템에서 보낸 ARP 응답을 가로채 소스 하드웨어 주소를 본딩에 있는 슬레이브 중 하나의 고유한 하드웨어 주소로 덮어써 서로 다른 피어가 서버에 대해 서로 다른 하드웨어 주소를 사용하도록 합니다.
목록 본딩 인터페이스
목록 본딩 인터페이스
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding
GET /interfaces/bonding
시스템의 모든 본딩 인터페이스에 대한 구성을 가져옵니다.
응답 예 :
{
"description" : "List bonding interfaces",
"interfaces" : [
{
"gateway" : "",
"ip" : "",
"mac" : "66:eb:31:0e:07:71",
"mode" : "broadcast",
"name" : "bond2",
"netmask" : "",
"slaves" : [
{
"name" : "eth2"
}
],
"status" : "down"
},
{
"gateway" : "192.168.100.1",
"ip" : "192.168.100.121",
"mac" : "a2:6d:80:29:87:c6",
"mode" : "balance-rr",
"name" : "bondiface",
"netmask" : "255.255.255.0",
"slaves" : [
{
"name" : "eth3"
},
{
"name" : "eth4"
}
],
"status" : "up"
}
]
}
응답 매개 변수
응답은 본딩 인터페이스 객체 배열이있는 JSON 객체입니다.
결합 매개 변수는 다음과 같습니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 링크 레이어 고유 식별자. 그것은 맥 첫 번째 NIC 인터페이스 슬레이브의 |
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| 노예 | 목적[] | 결합 인터페이스의 NIC 인터페이스 구성원입니다. |
| 모드 | 끈 | 본딩 인터페이스의 작동 모드입니다. 옵션은 다음과 같습니다. balance-rr, 라운드 로빈 정책; 활성 백업, 활성 백업 정책; 균형 xor, XOR 정책; 방송, 브로드 캐스트 정책; 802.3ad, IEEE 802.3ad LACP; 균형 -TIB, 적응 송신로드 밸런싱; 균형, 적응 형로드 균형 조정. 이러한 값은 섹션에 정의되어 있습니다. 네트워크 - 본딩 인터페이스. |
슬레이브 객체:
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 제목 NIC 슬레이브의 인터페이스 고유 식별자입니다. |
바인딩 본딩 인터페이스
바인딩 본딩 인터페이스
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface
GET /interfaces/bonding/<name>
인터페이스의 모든 매개변수를 가져옵니다. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Show bonding interface",
"interface" : {
"gateway" : "192.168.100.1",
"ip" : "192.168.100.121",
"mac" : "a2:6d:80:29:87:c6",
"mode" : "balance-rr",
"name" : "bondiface",
"netmask" : "255.255.255.0",
"slaves" : [
{
"name" : "eth3"
},
{
"name" : "eth2"
}
],
"status" : "up"
}
}
응답 매개 변수
응답은 본딩 인터페이스 객체가있는 JSON 객체입니다.
결합 매개 변수는 다음과 같습니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 링크 레이어 고유 식별자. 그것은 맥 첫 번째 NIC 인터페이스 슬레이브의 |
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| 노예 | 목적[] | 결합 인터페이스의 NIC 인터페이스 구성원입니다. |
| 모드 | 끈 | 본딩 인터페이스의 작동 모드입니다. 옵션은 다음과 같습니다. balance-rr, 라운드 로빈 정책; 활성 백업, 활성 백업 정책; 균형 xor, XOR 정책; 방송, 브로드 캐스트 정책; 802.3ad, IEEE 802.3ad LACP; 균형 -TIB, 적응 송신로드 밸런싱; 균형, 적응 형로드 균형 조정. 이러한 값은에서 정의됩니다. 네트워크> 본딩 인터페이스. |
노예 목적:
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 제목 NIC 슬레이브의 인터페이스 고유 식별자입니다. |
본딩 인터페이스 생성
본딩 인터페이스 생성
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"slaves":["eth3","eth2"],"name":"bondiface","mode":"balance-rr"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding
POST /interfaces/bonding
NIC 인터페이스를 결합하는 본딩 인터페이스를 작성하십시오.
본딩 MAC 주소는 첫 번째 NIC 인터페이스에서 가져옵니다. 본딩 인터페이스가 생성되면 본딩 모드를 변경할 수 없지만 필요한 경우 본딩 인터페이스에서 멤버 인터페이스를 추가하거나 삭제할 수 있습니다. 본딩 인터페이스의 일부인 경우 NIC 인터페이스가 잠길 것입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. | 참된 |
| 노예 | 끈[] | 본딩을 구축하는 모든 NIC 인터페이스 NIC 매개 변수가 필요합니다. name. | 참된 |
| 모드 | 끈 | 본딩 인터페이스의 작동 모드입니다. 옵션은 다음과 같습니다. balance-rr, 라운드 로빈 정책; 활성 백업, 활성 백업 정책; 균형 xor, XOR 정책; 방송, 브로드 캐스트 정책; 802.3ad, IEEE 802.3ad LACP; 균형 -TIB, 적응 송신로드 밸런싱; 균형, 적응 형로드 균형 조정. 이러한 값은에서 정의됩니다. 네트워크> 본딩 인터페이스. | 참된 |
응답 예 :
{
"description" : "Add a bond interface",
"params" : {
"mac" : "a2:6d:80:29:87:c6",
"mode" : "balance-rr",
"name" : "bondiface",
"slaves" : [
{
"name" : "eth3"
},
{
"name" : "eth2"
}
],
"status" : "down"
}
}
응답 매개 변수
응답은 결합 설정 매개 변수가있는 JSON 객체입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 맥 | 끈 | 링크 레이어 고유 식별자. 그것은 맥 첫 번째 NIC 인터페이스 슬레이브의 |
| name | 끈 | 인터페이스의 이름. 인터페이스 고유 식별자로 사용됩니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
| 노예 | 목적[] | 본딩 인터페이스를 구축하는 NIC 인터페이스. |
| 모드 | 끈 | 본딩 인터페이스의 작동 모드입니다. 옵션은 다음과 같습니다. balance-rr, 라운드 로빈 정책; 활성 백업, 활성 백업 정책; 균형 xor, XOR 정책; 방송, 브로드 캐스트 정책; 802.3ad, IEEE 802.3ad LACP; 균형 -TIB, 적응 송신로드 밸런싱; 균형, 적응 형로드 균형 조정. 이러한 값은에서 정의됩니다. 네트워크> 본딩 인터페이스. |
노예 목적:
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 제목 NIC 슬레이브의 인터페이스 고유 식별자입니다. |
본딩 인터페이스 수정
본딩 인터페이스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.121","netmask":"255.255.255.0","gateway":"192.168.100.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface
PUT /interfaces/bonding/<name>
본딩 인터페이스의 매개 변수를 수정하십시오. name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
응답 예 :
{
"description" : "Modify bond address",
"params" : {
"gateway" : "192.168.100.1",
"ip" : "192.168.100.121",
"netmask" : "255.255.255.0"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
본딩 구성 삭제
본딩 구성 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface
DELETE /interfaces/bonding/<name>
본딩 인터페이스 구성을 삭제하십시오. 구성 매개 변수는 다음과 같습니다. 게이트웨이, ip 및 넷 마스크.
name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete bonding network configuration",
"message" : "The configuration for the bonding interface bondiface has been deleted.",
"success" : "true"
}
본딩 인터페이스 동작 설정
본딩 인터페이스 동작 설정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"up"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/actions
POST /interfaces/bonding/<name>/actions
본딩 인터페이스에 조치를 적용하십시오. 이 호출을 통해 본딩 인터페이스를 삭제하고 활성화하거나 비활성화 할 수 있습니다.
본딩 인터페이스를 삭제하려면 파괴 본딩에서 사용된 NIC 인터페이스의 잠금을 해제하려는 경우 본딩 드라이버는 멤버 인터페이스가 본딩 인터페이스에 추가되기 전에 가지고 있던 MAC 주소를 복원합니다.
name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 인터페이스에 적용 할 작업입니다. 사용할 수있는 값은 다음과 같습니다. up 인터페이스를 활성화하고 사용 준비를하십시오. 아래 (down) 인터페이스가 패킷을 수신하지 않거나 보내지 않도록 비활성화합니다. 파괴 본딩을 삭제하고 NIC 슬레이브 인터페이스를 복원하십시오. | 참된 |
응답 예 :
{
"description" : "Action on bond interface",
"params" : {
"action" : "up"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
본딩 슬레이브 인터페이스 추가
본딩 슬레이브 인터페이스 추가
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"eth4"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/slaves
POST /interfaces/bonding/<name>/slaves
기존 본딩 인터페이스에 NIC 인터페이스를 슬레이브로 추가합니다.
name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| name | 끈 | NIC 인터페이스 name 본딩 인터페이스에 추가합니다. | 참된 |
응답 예 :
{
"description" : "Add a slave to a bond interface",
"params" : {
"mac" : "a2:6d:80:29:87:c6",
"mode" : "balance-rr",
"name" : "bondiface",
"slaves" : [
{
"name" : "eth3"
},
{
"name" : "eth2"
},
{
"name" : "eth4"
}
],
"status" : "up"
}
}
응답 매개 변수
응답은 업데이트된 구성 값이 포함된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
본딩 슬레이브 인터페이스 제거
본딩 슬레이브 인터페이스 제거
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/bonding/bondiface/slaves/eth2
DELETE /interfaces/bonding/<name>/slaves/<name>
본딩 인터페이스에서 NIC 슬레이브 인터페이스를 삭제합니다. 본딩 인터페이스에는 거의 하나의 NIC 슬레이브 인터페이스가 있어야 합니다.
이름 name 이다 DELETE call은 본딩 이름 고유 식별자이고, next name 에서 DELETE call은 NIC의 인터페이스 이름 고유 식별자입니다.
응답 예 :
{
"description" : "Remove bonding slave interface",
"message" : "The bonding slave interface eth2 has been removed.",
"success" : "true"
}
네트워크 - VLAN 인터페이스
VLAN 인터페이스를 사용하면 NIC 또는 본딩 인터페이스가 다른 네트워크에서 작동하므로 IP, 게이트웨이 및 넷 마스크 필드는 상위 인터페이스와 다를 수 있습니다. VLAN 인터페이스는 상위 인터페이스에서 MAC 주소를 상속합니다.
VLAN 인터페이스 필드 name 점 "."과 함께 나타납니다. VLAN 인터페이스에 대한 식별자 태그를 설정하는 데 사용할 문자입니다.
VLAN 인터페이스 나열
VLAN 인터페이스 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan
GET /interfaces/vlan
VLAN 인터페이스의 모든 매개 변수를 가져옵니다.
응답 예 :
{
"description" : "List VLAN interfaces",
"interfaces" : [
{
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "down"
}
]
}
응답 매개 변수
응답은 VLAN 인터페이스 객체 배열이있는 JSON 객체입니다.
VLAN 매개 변수는 다음과 같습니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. 상위 인터페이스 IP와 다를 수 있습니다. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 인터페이스의 MAC. 이 값은 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스 이름인 점 문자 "."로 형식이 지정된 체인입니다. vlan 네트워크 인터페이스 또는 vlan 태그에 대한 번호입니다. |
| 부모의 | 끈 | 이 인터페이스를 생성하는 데 사용되는 인터페이스입니다. |
| 지위 | 끈 | 값은 up 인터페이스는 패킷을 수신 할 수 있으며, 아래 (down) 인터페이스가 패킷을 수신할 수 없습니다. |
VLAN 인터페이스 검색
VLAN 인터페이스 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1
GET /interfaces/vlan/<name>
VLAN 인터페이스의 모든 매개변수를 가져옵니다. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Show VLAN interface",
"interface" : {
"gateway" : "192.168.131.1",
"ip" : "192.168.131.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0.1",
"netmask" : "255.255.255.0",
"status" : "up"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
| 맥 | 끈 | 인터페이스의 MAC. 이 값은 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스 이름인 점 문자 "."로 형식이 지정된 체인입니다. 및 VLAN 네트워크 인터페이스에 대한 번호입니다. |
| 지위 | 끈 | 값은 up 인터페이스는 패킷을 수신 할 수 있으며, 아래 (down) 인터페이스가 패킷을 수신할 수 없습니다. |
VLAN 인터페이스 생성
VLAN 인터페이스 생성
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.120.120","netmask":"255.255.255.0","gateway":"192.168.120.1", "name":"eth0.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan
POST /interfaces/vlan
NIC 또는 본딩 인터페이스에서 VLAN 인터페이스를 생성하십시오. 다음 VLAN 매개 변수가 달라야하지만 새 VLAN 인터페이스는 MAC을 공유합니다. ip다음과 같이 바뀔 수 있습니다. 게이트웨이, 넷 마스크.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 인터페이스의 IP. 상위 인터페이스 IP와 달라야 합니다. | 참된 |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. | 참된 |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. | 참된 |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스 이름인 점 문자 "."로 형식이 지정된 체인입니다. 및 VLAN 네트워크 인터페이스에 대한 번호입니다. | 참된 |
응답 예 :
{
"description" : "Add a vlan interface",
"params" : {
"gateway" : "192.168.120.1",
"ip" : "192.168.120.120",
"mac" : null,
"name" : "eth0.1",
"netmask" : "255.255.255.0"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
VLAN 인터페이스 수정
VLAN 인터페이스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155","netmask":"255.255.255.0","gateway":"192.168.131.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1
PUT /interfaces/vlan/<name>
VLAN 인터페이스의 매개 변수를 수정하십시오. name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. 상위 인터페이스 IP와 다를 수 있습니다. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의하십시오. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. |
응답 예 :
{
"description" : "Modify VLAN interface",
"params" : {
"gateway" : "192.168.131.1",
"ip" : "192.168.131.155",
"netmask" : "255.255.255.0"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
VLAN 인터페이스 삭제
VLAN 인터페이스 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1
DELETE /interfaces/vlan/<name>
VLAN 인터페이스 삭제. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete VLAN interface",
"message" : "The VLAN interface eth0.1 has been deleted.",
"success" : "true"
}
VLAN 인터페이스 동작 설정
VLAN 인터페이스 동작 설정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/vlan/eth0.1/actions
POST /interfaces/vlan/<name>/actions
VLAN 인터페이스에 조치를 적용하십시오. 이 호출을 통해 네트워크 인터페이스를 활성화 또는 비활성화 할 수 있습니다.
name 이름은 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 인터페이스에 적용 할 작업입니다. 사용할 수있는 값은 다음과 같습니다. up, 인터페이스를 활성화하고 사용 준비를하십시오. 아래 (down)패킷을 수신하지 않거나 보내지 않도록 인터페이스를 비활성화하십시오. | 참된 |
응답 예 :
{
"description" : "Action on vlan interface",
"params" : {
"action" : "down"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
네트워크 - 가상 인터페이스
네트워크 인터페이스를 사용하면 사용자가 부모와 동일한 네트워크 세그먼트에 다른 네트워크 인터페이스를 가질 수 있으므로 가상 인터페이스는 항상 부모로부터 네트워크 구성을 상속합니다. 다른 매개변수는 ip. 가상 인터페이스는 NIC, 본딩 또는 VLAN에서 생성할 수 있습니다. 새 가상 인터페이스를 만들면 가상 인터페이스에 대한 식별을 설정하는 데 사용되는 콜론 ":" 문자가 있는 필드가 나타납니다.
가상 인터페이스 나열
가상 인터페이스 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual
GET /interfaces/virtual
가상 인터페이스의 모든 매개변수를 가져옵니다.
응답 예 :
{
"description" : "List virtual interfaces",
"interfaces" : [
{
"gateway" : "",
"ip" : "192.168.100.155",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virt",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "up"
},
{
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0",
"parent" : "eth0",
"status" : "down"
}
]
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의합니다. 상위 인터페이스에서 상속됩니다. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. 상위 인터페이스에서 상속됩니다. |
| 맥 | 끈 | 인터페이스의 MAC. 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스, 콜론 문자 ":" 및 가상 네트워크 인터페이스의 이름으로 구성된 체인이며 영숫자 문자가 허용됩니다. |
| 부모의 | 끈 | 이 인터페이스를 생성하는 데 사용되는 인터페이스입니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
가상 인터페이스 검색
가상 인터페이스 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface
GET /interfaces/virtual/<name>
가상 인터페이스의 모든 매개 변수를 가져옵니다. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Show virtual interface",
"interface" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0",
"status" : "down"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의합니다. 상위 인터페이스에서 상속됩니다. |
| 게이트웨이 | 끈 | 다른 네트워크 세그먼트의 패킷을 보내는 데 사용되는 IP입니다. 상위 인터페이스에서 상속됩니다. |
| 맥 | 끈 | 인터페이스의 MAC. 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스, 콜론 문자 ":" 및 가상 네트워크 인터페이스에 대한 영숫자 문자열로 구성된 체인입니다. |
| 부모의 | 끈 | 이 인터페이스를 생성하는 데 사용되는 인터페이스입니다. |
| 지위 | 끈 | 값은 up인터페이스는 패킷을 수신 할 수 있습니다. 아래 (down)인터페이스가 패킷을 수신 할 수 없습니다. |
가상 인터페이스 생성
가상 인터페이스 생성
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.41", "name":"eth0:virtiface"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual
POST /interfaces/virtual
가상 인터페이스를 만듭니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. | 참된 |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스, 콜론 문자 ":" 및 가상 네트워크 인터페이스에 대한 영숫자 문자열로 구성된 체인입니다. | 참된 |
응답 예 :
{
"description" : "Add a virtual interface",
"params" : {
"gateway" : "192.168.100.5",
"ip" : "192.168.100.41",
"mac" : "c2:56:f6:54:ff:a0",
"name" : "eth0:virtiface",
"netmask" : "255.255.255.0"
}
}
응답 매개 변수
응답은 인터페이스 구성이 포함된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. |
| 넷 마스크 | 끈 | 인터페이스가 작동하는 네트워크 세그먼트를 정의합니다. 상위 인터페이스에서 상속됩니다. |
| 게이트웨이 | 끈 | 패킷을 다른 네트워크 세그먼트로 보내는 데 사용되는 IP입니다. 상위 인터페이스에서 상속됩니다. |
| 맥 | 끈 | 인터페이스의 MAC. 상위 인터페이스에서 상속됩니다. |
| name | 끈 | 인터페이스의 이름. 고유 식별자로 사용됩니다. 이 이름은 상위 인터페이스, 콜론 문자 ":" 및 가상 네트워크 인터페이스에 대한 영숫자 문자열로 구성된 체인입니다. |
가상 인터페이스 수정
가상 인터페이스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.131.155"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface
PUT /interfaces/virtual/<name>
가상 인터페이스의 매개 변수를 수정하십시오. name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 인터페이스의 IP. IP는 상위 인터페이스와 동일한 네트워크 세그먼트에 있어야 합니다. |
응답 예 :
{
"description" : "Modify virtual interface",
"params" : {
"ip" : "192.168.100.10"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
가상 인터페이스 삭제
가상 인터페이스 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface
DELETE /interfaces/virtual/<name>
가상 인터페이스를 삭제하십시오. name 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete virtual interface",
"message" : "The virtual interface eth0:virtiface has been deleted.",
"success" : "true"
}
가상 인터페이스 동작 설정
가상 인터페이스 동작 설정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"down"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/virtual/eth0:virtiface/actions
POST /interfaces/virtual/<name>/actions
가상 인터페이스에 작업을 적용하십시오. 이 호출을 통해 네트워크 인터페이스를 활성화 또는 비활성화 할 수 있습니다.
name 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 인터페이스에 적용 할 작업입니다. 사용할 수있는 값은 다음과 같습니다. up, 인터페이스를 활성화하고 사용 준비를하십시오. 아래 (down)패킷을 수신하지 않거나 보내지 않도록 인터페이스를 비활성화하십시오. | 참된 |
응답 예 :
{
"description" : "Action on virtual interface",
"params" : {
"action" : "down"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
네트워크 - 플로팅 인터페이스
이러한 종류의 인터페이스는 정의 된 가상 인터페이스를 사용하고 NIC, 본딩 or VLAN 아이와의 인터페이스 가상 상호 작용. 이 인터페이스는 클러스터가 구성된 경우 l4xnat 프로필의 상태 저장 장애 조치 동작에 사용됩니다.
플로팅 인터페이스 나열
플로팅 인터페이스 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating
GET /interfaces/floating
유동 IP가 생성된 사용 가능한 모든 인터페이스 또는 구성된 인터페이스를 표시합니다.
응답 예 :
{
"description" : "List floating interfaces",
"params" : [
{
"floating_ip" : null,
"interface" : "bondiface"
},
{
"floating_ip" : "192.168.100.199",
"interface" : "eth0"
},
{
"floating_ip" : null,
"interface" : "eth0.1"
},
{
"floating_ip" : null,
"interface" : "eth1"
}
]
}
응답 매개 변수
응답은 부동 인터페이스 객체 배열이있는 JSON 객체입니다.
부유 목적:
| 분야 | 타입 | 설명: |
|---|---|---|
| floating_ip | 끈 | 플로팅 IP에서 사용되는 인터페이스. floating_ip 가상 인터페이스의 하위 항목으로 존재해야합니다. 인터페이스. |
| 인터페이스 | 끈 | 유동 IP로 마스크 된 인터페이스. |
플로팅 인터페이스 검색
플로팅 인터페이스 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0
GET /interfaces/floating/<name>
인터페이스에 구성된 유동 IP가 있는지 표시합니다. 하나가 구성된 경우 여기에 표시됩니다.
name nic, bond 또는 vlan 유형일 수 있는 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Show floating interface",
"params" : {
"floating_ip" : "192.168.100.199",
"interface" : "eth0"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| floating_ip | 끈 | 플로팅 IP에서 사용되는 인터페이스. floating_ip 가상 인터페이스의 하위 항목으로 존재해야합니다. 인터페이스. |
| 인터페이스 | 끈 | 유동 IP로 마스크 된 인터페이스. |
플로팅 인터페이스 수정
플로팅 인터페이스 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"floating_ip":"192.168.100.199"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0
PUT /interfaces/floating/<name>
NIC, 본딩 또는 VLAN 인터페이스에 대해 유동 IP를 구성합니다.
name nic, bond 또는 vlan 유형일 수 있는 인터페이스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| floating_ip | 끈 | 플로팅 IP에서 사용되는 인터페이스. floating_ip 가상 인터페이스의 하위 항목으로 존재해야합니다. 인터페이스. | 참된 |
응답 예 :
{
"description" : "Modify floating interface",
"message" : "Floating interface modification done",
"success" : "true"
}
플로팅 구성 삭제
플로팅 구성 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/interfaces/floating/eth0
DELETE /interfaces/floating/<name>
인터페이스에서 유동 IP 구성을 제거하십시오.
name nic, bond 또는 vlan 유형일 수 있는 인터페이스 고유 식별자입니다.
응답 예 :
{
"description" : "Remove floating interface",
"message" : "The floating interface has been removed.",
"success" : "true"
}
모니터링 - 통계
시스템 및 팜에 대한 정보를 표시합니다. 이 정보는 Zevenet 부하 분산기 상태를 모니터링하는 데 유용합니다.
시스템 통계 표시
시스템 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats
GET /stats
전역 시스템 통계를 얻으십시오.
응답 예 :
{
"description" : "System stats",
"params" : {
"cpu" : {
"cores" : 2,
"idle" : 94.42,
"iowait" : 0,
"irq" : 0,
"nice" : 0,
"softirq" : 0,
"sys" : 2.54,
"usage" : 5.58,
"user" : 3.05
},
"date" : "Fri Jan 27 11:40:32 2017",
"hostname" : "api3",
"load" : {
"Last_1" : 1.17,
"Last_15" : 0.36,
"Last_5" : 0.6
},
"memory" : {
"Buffers" : 21.68,
"Cached" : 147.95,
"MemFree" : 348.06,
"MemTotal" : 2005.01,
"MemUsed" : 1656.95,
"SwapCached" : 2.67,
"SwapFree" : 614.38,
"SwapTotal" : 672,
"SwapUsed" : 57.62
},
"network" : {
"bond0 in in" : 234.72,
"bond0 out out" : 0,
"bond0.10 in in" : 0,
"bond0.10 out out" : 0,
"bond1 in in" : 234.72,
"bond1 out out" : 0,
"bond3 in in" : 815.69,
"bond3 out out" : 4300.38,
"eth0 in in" : 2702.29,
"eth0 out out" : 50701.95,
"eth0.2 in in" : 0,
"eth0.2 out out" : 0,
"eth1 in in" : 234.72,
"eth1 out out" : 0,
"eth2 in in" : 234.72,
"eth2 out out" : 0,
"eth3 in in" : 0,
"eth3 out out" : 0,
"eth4 in in" : 436.89,
"eth4 out out" : 4300.38,
"eth4.6 in in" : 0,
"eth4.6 out out" : 0,
"eth5 in in" : 301.39,
"eth5 out out" : 0,
"eth5.5 in in" : 0,
"eth5.5 out out" : 0,
"eth6 in in" : 77.42,
"eth6 out out" : 0
}
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| CPU | 목적 | CPU 통계. |
| 데이터 | 끈 | 시스템 날짜. |
| 호스트 이름 | 끈 | 호스트의 이름. |
| 하중 | 목적 | 코어로드 통계. |
| 기억 | 목적 | 사용 된 메모리 통계. |
| 네트워크 | 목적 | 네트워크 트래픽 통계. |
CPU 개체:
| 분야 | 타입 | 설명: |
|---|---|---|
| 코어 | 번호 | 프로세서의 코어 수입니다. |
| 유휴 | 번호 | 어떤 프로그램에서도 CPU를 사용하지 않습니다. |
| 아이오와 | 번호 | CPU는 입력 또는 출력 프로세스에서 사용됩니다. |
| irq | 번호 | 하드웨어 interrrupcions에 의해 사용되는 CPU. |
| 좋은 | 번호 | CPU 스케줄링 우선 순위. |
| softirq | 번호 | 소프트웨어 중단에 의해 사용되는 CPU. |
| sys | 번호 | 시스템에서 사용하는 CPU. |
| 용법 | 번호 | 사용 된 총 CPU. |
| 사용자 | 번호 | 사용자가 사용하는 CPU. |
개체로드:
| 분야 | 타입 | 설명: |
|---|---|---|
| Last_1 | 번호 | 마지막 순간에 시스템 백분율을 로드합니다. |
| Last_5 | 번호 | XNUMX분 전에 시스템 백분율을 로드합니다. |
| Last_15 | 번호 | XNUMX분 전에 시스템 백분율을 로드합니다. |
메모리 개체.
| 분야 | 타입 | 설명: |
|---|---|---|
| 버퍼 | 번호 | 버퍼에 사용되는 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 캐시 된 | 번호 | 시스템에 캐시 된 전체 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemFree | 번호 | 시스템에서 캐시하지 않은 전체 여유 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemTotal | 번호 | 시스템의 총 램 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemUsed | 번호 | 시스템에서 사용하는 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 스왑 캐쉬 | 번호 | 예약 된 전체 캐시 메모리입니다. |
| 스왑 프리 | 번호 | 시스템에서 캐시하지 않은 전체 여유 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 스왑 총액 | 번호 | 예약 된 전체 스왑 메모리입니다. |
| 스왑 사용 | 번호 | 그것은 시스템에 의해 스왑 메모리가 사용되는 최적의 시스템에서 0이어야합니다. |
네트워크 개체:
| 분야 | 타입 | 설명: |
|---|---|---|
| 안으로 | 번호 | 이 입력 트래픽 인터페이스. |
| 밖으로 | 번호 | 이 출력 트래픽 인터페이스. |
네트워크 통계 표시
네트워크 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/network
GET /stats/system/network
네트워크 인터페이스를 통해 전체 입출력 트래픽에 대한 요약 정보를 얻을 수 있습니다.
응답 예 :
{
"description" : "Network interfaces usage",
"params" : {
"date" : "Fri Jan 27 11:58:05 2017",
"hostname" : "api3",
"interfaces" : [
{
"in" : "234.72",
"interface" : "bond1",
"out" : "0.00"
},
{
"in" : "77.42",
"interface" : "eth6",
"out" : "0.00"
},
{
"in" : "2703.88",
"interface" : "eth0",
"out" : "50917.65"
},
{
"in" : "815.69",
"interface" : "bond2",
"out" : "4300.38"
}
]
}
}
응답 매개 변수
응답은 키가있는 JSON이됩니다. 매개 변수 값은 다음 키가 있는 객체입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 데이터 | 끈 | 시스템 날짜. |
| 호스트 이름 | 끈 | 호스트의 이름. |
| 인터페이스 | 목적[] | 네트워크 트래픽 통계. |
인터페이스 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| in | 끈 | 총 입력 트래픽 (MB). |
| 인터페이스 | 끈 | 인터페이스 이름. |
| 아웃 | 끈 | 총 출력 트래픽(MB). |
인터페이스 통계 표시
인터페이스 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/network/interfaces
GET /stats/system/network/interfaces
각 네트워크 인터페이스에 대한 요약 정보를 얻으십시오.
응답 예 :
{
"description" : "Interfaces info",
"params" : {
"bond" : [
{
"in" : "234.72",
"interface" : "bond1",
"ip" : "",
"mac" : "3a:3a:a7:e3:33:73",
"out" : "0.00",
"slaves" : [
"eth2"
],
"status" : "down",
"virtual" : [],
"vlan" : []
},
{
"in" : "815.70",
"interface" : "bond3",
"ip" : "",
"mac" : "ea:00:7d:88:1d:bd",
"out" : "4300.38",
"slaves" : [
"eth4",
"eth5",
"eth6"
],
"status" : "up",
"virtual" : [],
"vlan" : []
},
{
"in" : "234.72",
"interface" : "bond0",
"ip" : "",
"mac" : "c2:d0:d7:64:df:68",
"out" : "0.00",
"slaves" : [
"eth1"
],
"status" : "down",
"virtual" : [],
"vlan" : [
"bond0.10"
]
}
],
"nic" : [
{
"in" : "77.42",
"interface" : "eth6",
"ip" : "",
"mac" : "ea:00:7d:88:1d:bd",
"out" : "0.00",
"status" : "up",
"virtual" : [],
"vlan" : []
},
{
"in" : "2704.81",
"interface" : "eth0",
"ip" : "192.168.101.46",
"mac" : "9e:2e:3e:a5:2e:6a",
"out" : "51039.13",
"status" : "up",
"virtual" : [
"eth0:1",
"eth0:2",
"eth0.2:6"
],
"vlan" : [
"eth0.2"
]
},
{
"in" : "234.72",
"interface" : "eth1",
"ip" : "192.168.101.58",
"mac" : "c2:d0:d7:64:df:68",
"out" : "0.00",
"status" : "up",
"virtual" : [],
"vlan" : []
},
{
"in" : "234.72",
"interface" : "eth2",
"ip" : "",
"mac" : "3a:3a:a7:e3:33:73",
"out" : "0.00",
"status" : "up",
"virtual" : [],
"vlan" : []
},
{
"in" : "0.00",
"interface" : "eth3",
"ip" : "192.168.101.72",
"mac" : "16:97:ab:43:87:02",
"out" : "0.00",
"status" : "down",
"virtual" : [
"eth3:1",
"eth3:8",
"eth3:6"
],
"vlan" : []
},
{
"in" : "436.89",
"interface" : "eth4",
"ip" : "",
"mac" : "ea:00:7d:88:1d:bd",
"out" : "4300.38",
"status" : "up",
"virtual" : [
"eth4.6:5"
],
"vlan" : [
"eth4.6"
]
},
{
"in" : "301.39",
"interface" : "eth5",
"ip" : "",
"mac" : "ea:00:7d:88:1d:bd",
"out" : "0.00",
"status" : "up",
"virtual" : [],
"vlan" : [
"eth5.5"
]
}
]
}
}
응답 매개 변수
응답은 키가있는 JSON이됩니다. 매개 변수 그 값은 키가있는 객체입니다. 증서 및 NIC.
| 분야 | 타입 | 설명: |
|---|---|---|
| 증서 | 목적[] | 본드 인터페이스 통계. |
| NIC | 목적[] | NIC 인터페이스 통계. |
본드 객체:
| 분야 | 타입 | 설명: |
|---|---|---|
| in | 끈 | 총 입력 트래픽 (MB). |
| 인터페이스 | 끈 | 고유 식별자로 사용되는 인터페이스 이름입니다. |
| ip | 끈 | 인터페이스의 IP. |
| 맥 | 끈 | 인터페이스의 MAC. |
| 아웃 | 끈 | 총 출력 트래픽 (MB). |
| 노예 | 문자열 [] | 채권 인터페이스를 만드는 노예의 목록. |
| 지위 | 끈 | 인터페이스 상태. 값은 아래 (down), 인터페이스가 비활성화됩니다. up인터페이스가 활성화됩니다. |
| 가상 | 문자열 [] | 이 인터페이스를 상속 한 가상 인터페이스. |
| VLAN | 문자열 [] | 이 인터페이스를 상속 한 VLAN 인터페이스 |
닉 개체:
| 분야 | 타입 | 설명: |
|---|---|---|
| in | 끈 | 총 입력 트래픽 (MB). |
| 인터페이스 | 끈 | 고유 식별자로 사용되는 인터페이스 이름입니다. |
| ip | 끈 | 인터페이스의 IP. |
| 맥 | 끈 | 인터페이스의 MAC. |
| 아웃 | 끈 | 총 출력 트래픽 (MB). |
| 지위 | 끈 | 인터페이스 상태. 값은 아래 (down), 인터페이스가 비활성화됩니다. up인터페이스가 활성화됩니다. |
| 가상 | 문자열 [] | 이 인터페이스를 상속 한 가상 인터페이스. |
| VLAN | 문자열 [] | 이 인터페이스를 상속 한 VLAN 인터페이스 |
메모리 통계 표시
메모리 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/memory
GET /stats/system/memory
시스템 메모리 요약을 가져옵니다.
응답 예 :
{
"description" : "Memory usage",
"params" : {
"Buffers" : 1.01,
"Cached" : 42.47,
"MemFree" : 880.11,
"MemTotal" : 2005.01,
"MemUsed" : 1124.91,
"SwapCached" : 8.27,
"SwapFree" : 565.15,
"SwapTotal" : 672,
"SwapUsed" : 106.84,
"date" : "Fri Jan 27 12:27:11 2017",
"hostname" : "api3"
}
}
응답 매개 변수
응답은 키가있는 JSON이됩니다. 매개 변수 그 값은 메모리 객체이다.
Memory 목적.
| 분야 | 타입 | 설명: |
|---|---|---|
| 버퍼 | 번호 | 버퍼에 사용되는 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 캐시 된 | 번호 | 시스템에 캐시 된 전체 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemFree | 번호 | 시스템에서 캐시하지 않은 전체 여유 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemTotal | 번호 | 시스템의 총 램 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| MemUsed | 번호 | 시스템에서 사용하는 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 스왑 캐쉬 | 번호 | 예약 된 전체 캐시 메모리입니다. |
| 스왑 프리 | 번호 | 시스템에서 캐시하지 않은 전체 여유 메모리입니다. 이 금액은 Mb로 표시됩니다. |
| 스왑 총액 | 번호 | 예약 된 전체 스왑 메모리입니다. |
| 스왑 사용 | 번호 | 그것은 시스템에 의해 스왑 메모리가 사용되는 최적의 시스템에서 0이어야합니다. |
| 데이터 | 끈 | 시스템 날짜. |
| 호스트 이름 | 끈 | 호스트의 이름. |
로드 통계 표시
로드 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/load
GET /stats/system/load
CPU 시스템로드 요약.
응답 예 :
{
"description" : "System load",
"params" : {
"Last_1" : 0.66,
"Last_15" : 0.39,
"Last_5" : 0.49,
"date" : "Fri Jan 27 13:15:01 2017",
"hostname" : "api3"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| Last_1 | 번호 | 마지막으로 시스템 사용량을로드하십시오. |
| Last_5 | 번호 | 마지막 XNUMX분 동안 시스템 사용량을 로드합니다. |
| Last_15 | 번호 | 지난 XNUMX분 동안 시스템 사용량을 로드합니다. |
| 데이터 | 끈 | 시스템 날짜. |
| 호스트 이름 | 끈 | 호스트의 이름. |
CPU 통계 표시
CPU 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/cpu
GET /stats/system/cpu
응답 예 :
{
"description" : "System CPU usage",
"params" : {
"cores" : 2,
"date" : "Fri Jan 27 13:30:52 2017",
"hostname" : "api3",
"idle" : 94.9,
"iowait" : 0,
"irq" : 0,
"nice" : 0,
"softirq" : 0,
"sys" : 3.06,
"usage" : 5.1,
"user" : 2.04
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 코어 | 번호 | 프로세서의 코어 수입니다. |
| 유휴 | 번호 | 어떤 프로그램에서도 CPU를 사용하지 않습니다. |
| 아이오와 | 번호 | CPU는 입력 또는 출력 프로세스에서 사용됩니다. |
| irq | 번호 | 하드웨어 interrrupcions에 의해 사용되는 CPU. |
| 좋은 | 번호 | CPU 스케줄링 우선 순위. |
| softirq | 번호 | 소프트웨어 중단에 의해 사용되는 CPU. |
| sys | 번호 | 시스템에서 사용하는 CPU. |
| 용법 | 번호 | 사용 된 총 CPU. |
| 사용자 | 번호 | 사용자가 사용하는 CPU. |
| 데이터 | 끈 | 시스템 날짜. |
| 호스트 이름 | 끈 | 호스트의 이름. |
연결 통계 표시
연결 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/system/connections
GET /stats/system/connections
시스템의 총 현재 연결을 가져옵니다. 카운터는 ASSURED, ESTABLISHED, SYN_SENT, TIME_WAIT, LISTEN…과 같은 모든 유형의 추적 된 연결을 합산합니다.
응답 예 :
{
"description" : "System connections",
"params" : {
"connections" : 324
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 연결 | 번호 | 실제로 추적된 총 연결 수입니다. |
농장 수 표시
농장 수 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/farms/total
GET /stats/farms/total
시스템에서 생성 된 팜의 총계를 표시합니다.
응답 예 :
{
"description" : "Number of farms.",
"number" : 8
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 번호 | 번호 | 시스템에있는 팜의 수입니다. |
농장 통계 표시
농장 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/farms
GET /stats/farms
시스템의 모든 팜에 대한 연결 및 구성 요약을 가져옵니다.
응답 예 :
{
"description" : "List all farms stats",
"farms" : [
{
"established" : 0,
"farmname" : "testHttps",
"pending" : 0,
"profile" : "https",
"status" : "up",
"vip" : "192.168.101.20",
"vport" : "120"
},
{
"established" : 0,
"farmname" : "httpFarm",
"pending" : 0,
"profile" : "http",
"status" : "up",
"vip" : "192.168.10.31",
"vport" : "8080"
},
{
"established" : 0,
"farmname" : "testDL",
"pending" : 0,
"profile" : "datalink",
"status" : "up",
"vip" : "192.168.102.72",
"vport" : "eth1"
},
{
"established" : 0,
"farmname" : "testL4",
"pending" : 0,
"profile" : "l4xnat",
"status" : "up",
"vip" : "192.168.10.31",
"vport" : "30"
},
{
"established" : 0,
"farmname" : "testGSLB",
"pending" : 0,
"profile" : "gslb",
"status" : "up",
"vip" : "192.168.10.31",
"vport" : "53"
}
]
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 확립 된 | 번호 | 현재 설정된 총 연결 수입니다. |
| 농장 이름 | 끈 | 농장 이름, 고유 식별자. |
| 대기 | 번호 | 보류중인 연결 수입니다. |
| 윤곽 | 끈 | 농장의 유형. 가능한 값은 다음과 같습니다. 데이터 링크, l4xnat, HTTP, HTTPS or GSLB. 각 프로파일은 해당 섹션에서 정의됩니다. |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up, 팜이 실행 중입니다. 아래 (down), 팜이 중지되거나 재시작 필요, 최신 변경 사항을 적용하려면 팜을 다시 시작해야 합니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 끈 | 가상 서비스가 수신하는 팜의 포트 |
팜 통계 표시
팜 통계 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/farms/farmname
GET /stats/farms/<farmname>
현재 팜 상태, 백엔드 상태 및 연결을 표시합니다. 각 팜은 프로필에 따라 다른 개체로 응답합니다.
HTTP 팜에 대한 응답 예 :
{
"backends" : [
{
"established" : 0,
"id" : 0,
"ip" : "192.168.0.168",
"pending" : 0,
"port" : 80,
"service" : "srv1",
"status" : "up"
}
],
"description" : "List farm stats",
"sessions" : [
{
"client" : "0",
"id" : "0",
"service" : "srv1",
"session" : "192.168.0.186"
}
]
}
HTTP 팜의 응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 백엔드 | 목적[] | 백엔드에 대한 정보를 표시합니다. |
| 세션 | 목적[] | 세션에 대한 정보를 표시합니다. |
백엔드 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| 확립 된 | 번호 | 설정된 총 연결 수입니다. |
| id | 번호 | 백엔드 고유 식별자. |
| ip | 끈 | 실제 서비스가 듣고있는 IP. |
| 대기 | 번호 | 보류중인 연결 수입니다. |
| 포트 | 번호 | 실제 서비스가 수신하는 포트입니다. |
| 서비스 | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. |
| 지위 | 끈 | 백엔드 상태. 가능한 값은 다음과 같습니다. up, 백엔드는 연결을 수신할 준비가 되었습니다. 아래 (down), 서비스가 백엔드가 작동하지 않음을 감지했습니다. fgDOWN, farmguardian 확인이 실패했기 때문에 farmguardian이 백엔드를 비활성화했습니다. 유지, 백엔드는 관리자에 의해 연결을 수신할 준비가 되지 않은 것으로 표시됩니다. 이 옵션은 백엔드의 유지 관리 작업에 유용합니다. |
세션 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| 클라이언트 | 끈 | 클라이언트 고유 식별자. |
| id | 끈 | 클라이언트에 할당 된 백엔드 고유 식별자입니다. |
| 서비스 | 끈 | 클라이언트에 할당 된 서비스 고유 식별자입니다. |
| 세션 | 끈 | 세션 고유 식별자입니다. 이 값은 지속성 유형에 따라 다릅니다. |
GSLB 농장에 대한 응답 예 :
{
"backends" : [
{
"id" : 1,
"ip" : "127.0.0.1",
"port" : 53,
"service" : "service1",
"status" : "down"
},
{
"id" : 2,
"ip" : "192.168.55.40",
"port" : 53,
"service" : "service1",
"status" : "down"
},
{
"id" : 4,
"ip" : "192.135.10.2",
"port" : 53,
"service" : "service1",
"status" : "down"
},
{
"id" : 1,
"ip" : "127.0.0.1",
"port" : 80,
"service" : "prioServ",
"status" : "down"
},
{
"id" : 2,
"ip" : "127.0.0.1",
"port" : 80,
"service" : "prioServ",
"status" : "down"
}
],
"client" : {
"edns_big" : 0,
"edns_tc" : 0,
"recvfail" : 0,
"reqs" : 0,
"sendfail" : 0,
"tc" : 0
},
"description" : "List farm stats",
"extended" : {
"badvers" : 0,
"dropped" : 0,
"edns" : 0,
"edns_clientsub" : 0,
"formerr" : 0,
"noerror" : 0,
"notimp" : 0,
"nxdomain" : 0,
"refused" : 0,
"v6" : 0
},
"server" : {
"recvfail" : 0,
"reqs" : 0,
"sendfail" : 0
}
}
GSLB 농장의 응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 백엔드 | 목적[] | 백엔드에 대한 정보를 표시합니다. |
| 클라이언트 | 목적 | 클라이언트와 관련된 통계. |
| extended | 목적 | 서비스에 대한 확장 정보. |
| 섬기는 사람 | 목적 | 서버와 관련된 통계입니다. |
백엔드 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 백엔드 고유 식별자. |
| ip | 끈 | 실제 서비스가 듣고있는 IP. |
| 포트 | 번호 | 실제 서비스가 수신하는 포트입니다. |
| 서비스 | 끈 | 고유 식별자로 사용되는 서비스 이름입니다. |
| 지위 | 끈 | 백엔드 상태. 가능한 값은 다음과 같습니다. up, 백엔드는 연결을 수신할 준비가 되었습니다. 아래 (down), 서비스가 백엔드가 작동하지 않음을 감지했습니다. 유지, 백엔드는 관리자에 의해 연결을 수신할 준비가 되지 않은 것으로 표시됩니다. 이 옵션은 백엔드의 유지 관리 작업에 유용합니다. |
클라이언트 개체
| 분야 | 타입 | 설명: |
|---|---|---|
| edns_big | 번호 | 응답은 512 바이트보다 큽니다. |
| edns_tc | 번호 | 클라이언트가 지정한 확장 DNS 버퍼 크기가 요청된 데이터에 비해 너무 작습니다. |
| 회복하다 | 번호 | OS가 수신시 문제가 있음을 나타내는 UDP 오류 수입니다. |
| reqs | 번호 | 서버에서 처리한 총 UDP 요청 수입니다. |
| 송부 | 번호 | OS가 전송시에 문제가 있음을 나타내는 UDP 오류 수입니다. |
| tc | 번호 | TC 비트 세트로 잘린 응답. |
확장 개체
| 분야 | 타입 | 설명: |
|---|---|---|
| 나쁜 놈 | 번호 | 지원되지 않는 버전의 EDNS OPT-RR이있는 요청. |
| 떨어 뜨린 | 번호 | 형식이 잘못된 형식에 대한 요청이 삭제되었습니다. |
| Edns | 번호 | 요청에는 EDNS OPT-RR이 포함되었습니다. |
| edns_clientsub | 번호 | edns_client_subnet 옵션을 지정한 edns 요청의 서브 세트. |
| 이전 | 번호 | 요청 형식이 잘못되었지만 rcode FORMERR로 응답을 보낼 만큼 정상이었습니다. |
| 오류 없음 | 번호 | 성공적인 요청. |
| 노플프 | 번호 | 영역 전송 요청과 같이이 데몬이 구현하지 않은 요청 된 서비스입니다. |
| nxdomain | 번호 | 존재하지 않는 도메인 이름을 요청합니다. |
| 거부 | 번호 | 서버가 쿼리 된 이름에 대해 신뢰할 수 없기 때문에 요청이 서버에 의해 거부되었습니다. |
| v6 | 번호 | IPv6 클라이언트로부터의 요청. |
서버 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| 회복하다 | 번호 | OS가 수신시 문제가 있음을 나타내는 TCP 오류 수입니다. |
| reqs | 번호 | 서버에서 처리한 총 TCP 요청 수입니다. |
| 송부 | 번호 | OS가 전송시에 문제가 있음을 나타내는 TCP 오류 수입니다. |
L4xNAT 팜에 대한 응답 예 :
{
"backends" : [
{
"established" : 5,
"id" : 1,
"ip" : "192.168.5.40",
"pending" : 0,
"port" : "8080",
"status" : "maintenance"
},
{
"established" : null,
"id" : 3,
"ip" : "192.5.1.1",
"pending" : 0,
"port" : "787",
"status" : "fgDOWN"
},
{
"established" : null,
"id" : 5,
"ip" : "192.168.5.100",
"pending" : 0,
"port" : "8080",
"status" : "up"
}
],
"description" : "List farm stats"
}
L4xNAT 팜의 응답 매개 변수
응답은 키가있는 JSON이됩니다. 백엔드 아래 매개 변수를 사용하여 개체 배열의 값을 지정합니다.
백엔드 객체:
| 분야 | 타입 | 설명: |
|---|---|---|
| 확립 된 | 번호 | 현재 설정된 총 연결 수입니다. |
| id | 번호 | 백엔드 고유 식별자. |
| ip | 끈 | 실제 서비스가 듣고있는 IP. |
| 대기 | 번호 | 보류중인 연결 수입니다. |
| 포트 | 번호 | 실제 서비스가 수신하는 포트입니다. |
| 지위 | 끈 | 백엔드 상태. 가능한 값은 다음과 같습니다. up, 백엔드는 연결을 수신할 준비가 되었습니다. fgDOWN, 농장 보호자가 백엔드가 작동하지 않음을 감지했습니다. 유지, 백엔드는 관리자에 의해 연결을 수신할 준비가 되지 않은 것으로 표시됩니다. 이 옵션은 백엔드의 유지 관리 작업에 유용합니다. |
데이터 링크 팜의 응답 매개 변수
데이터 링크 팜 통계는 실제로 사용할 수 없습니다.
모듈 상태 표시
모듈 상태 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/farms/modules
GET /stats/farms/modules
모듈 통계 요약을 가져옵니다. 이 호출은 각 모듈 상태, 구성된 수, 내려진 팜의 수를 보여줍니다.
모듈에 대한 정의는 농장 안내
응답 예 :
{
"description" : "Module status",
"params" : {
"dslb" : {
"down" : 1,
"total" : 2,
"up" : 1
},
"gslb" : {
"down" : 0,
"total" : 1,
"up" : 1
},
"lslb" : {
"down" : 2,
"total" : 4,
"up" : 2
}
}
}
응답 매개 변수
응답은 세 가지 키가있는 JSON이됩니다. DSLB, GSLB 및 lslb.
| 분야 | 타입 | 설명: |
|---|---|---|
| 아래 (down) | 번호 | 중지된 농장의 수. 이 팜은 시스템 관리자에 의해 중지되었습니다. |
| 합계 | 번호 | 총 농장 수. |
| up | 번호 | 운영 중인 농장 수. |
모듈 통계보기
모듈 통계보기
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/stats/farms/modules/lslb
GET /stats/farms/modules/<module>
지정된 모듈의 팜 통계를 표시합니다.
그 (것)들을 위해 유효한 가치 모듈 매개 변수는 다음과 같습니다. lslb, GSLB or DSLB.
응답 예 :
{
"description" : "List lslb farms stats",
"farms" : [
{
"established" : 0,
"farmname" : "newfarm",
"pending" : 0,
"profile" : "http",
"status" : "up",
"vip" : "192.168.100.199",
"vport" : "40"
},
{
"established" : 0,
"farmname" : "nwl4farm",
"pending" : 0,
"profile" : "l4xnat",
"status" : "down",
"vip" : "192.168.100.241",
"vport" : "88"
},
{
"established" : 0,
"farmname" : "l4farm",
"pending" : 0,
"profile" : "l4xnat",
"status" : "up",
"vip" : "192.168.100.102",
"vport" : "70"
}
]
}
응답 매개 변수
응답은 모듈의 팜에 대한 정보가있는 JSON 객체입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 확립 된 | 번호 | 현재 설정된 총 연결 수입니다. |
| 농장 이름 | 끈 | 팜 이름, 팜의 고유 식별자입니다. |
| 대기 | 번호 | 보류중인 연결 수입니다. |
| 윤곽 | 끈 | 농장의 유형. 가능한 값은 다음과 같습니다. 데이터 링크, l4xnat, HTTP, HTTPS or GSLB. 각 프로파일은 자체 섹션으로 정의됩니다. |
| 지위 | 끈 | 농장 상태. 가능한 값은 다음과 같습니다. up, 팜이 실행 중입니다. 아래 (down), 팜이 중지되거나 재시작 필요, 최신 변경 사항을 적용하려면 팜을 다시 시작해야 합니다. |
| VIP | 끈 | 가상 서비스가 수신하는 팜의 IP |
| vport | 끈 | 가상 서비스가 수신하는 팜의 포트 |
모니터링 - 그래프
이 섹션은 내부로드 밸런서 시스템을 모니터링하여 CPU 사용량, 스왑 메모리, 램 메모리, 구성된 모든 nework 인터페이스,로드 및 하드 디스크 스토리지의 매개 변수를 통해 문제를 감지하는 데 유용합니다.
또한 주간, 월간 및 연간 기록에 액세스할 수 있습니다.
정보가 포함된 그래프는 base64 형식으로 응답됩니다.
사용 가능한 그래프 나열
사용 가능한 그래프 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs
GET /graphs
사용 가능한 모든 그래프가있는 객체를 시스템에 표시합니다. 가능한 요청을 보여줍니다.
응답 예 :
{
"description" : "These are the possible graphs, you`ll be able to access to the daily, weekly, monthly or yearly graph",
"farms" : [
"l4farm",
"newfarm",
"gslbfarm",
"nwl4farm",
"httpweb"
],
"interfaces" : [
"eth0.1",
"eth2",
"eth1",
"eth3",
"bondiface",
"eth0"
],
"system" : [
"cpu",
"load",
"ram",
"swap",
{
"disk" : [
"root/",
"root/boot",
"root/usr/local/zenloadbalancer/config",
"root/var/log"
]
}
]
}
응답 매개 변수
응답은 JSON의 세 가지 유형의 그래프가 될 것이며, 전원, 인터페이스 및 체계.
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 사용 가능한 팜 그래프 목록입니다. |
| 인터페이스 | 끈[] | 사용 가능한 인터페이스 그래프 목록입니다. |
| 체계 | 목적[] | 사용 가능한 시스템 그래프 목록입니다. 어레이에는 디스크 마운트 지점을 나타내는 어레이가 있는 개체가 있습니다. |
시스템 객체:
시스템 개체에는 시스템과 관련된 배열 목록과 다음 형식의 디스크 개체가 포함됩니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 디스크 | 끈[] | 이 배열의 값은 모두 기존입니다. 마운트 포인트 시스템에서 각 그래프에는 사용 가능한 그래프가 있습니다. |
그래프 표시
그래프 표시
팜에 대한 예제 요청 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/farms/httpweb
인터페이스 요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/interfaces/eth3
디스크 요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/system/disk/root/boot
GET /graphs/<graph>
사용할 수있는 값 그래프 위치 :
| 가치관 | 설명: |
|---|---|
farms/<farmname> |
농장 이름, 팜 고유 식별자. |
interfaces/<interface> |
인터페이스, 인터페이스 고유 식별자. |
system/<system> |
체계가능한 시스템 그래프는 다음과 같습니다. CPU, 하중, 숫양 or 교환. |
system/disk/<mount point> |
마운트 포인트,의 값이다 디스크 개체, 'GET / graphs'호출에 의해 반환됩니다. |
응답 예 :
{
"description" : "Get cpu graphs",
"graphs" : [
{
"frequency" : "daily",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "weekly",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "monthly",
"graph" : "PNG IN BASE 64"
},
{
"frequency" : "yearly",
"graph" : "PNG IN BASE 64"
}
]
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 주파수 | 끈 | 그래프를 생성하는 데 사용된 기간입니다. 가능한 값은 다음과 같습니다. 매일, 주간, 월 or 매년. |
| 그래프 | 끈 | Base 64 형식의 그래프. |
빈도 그래프 표시
빈도 그래프 표시
팜에 대한 예제 요청 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/farms/httpweb/daily
인터페이스 요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/interfaces/eth3/monthly
디스크 요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/graphs/system/disk/root/boot/yearly
GET /graphs/<graph>/<frequency>
사용할 수있는 값 그래프 위치 :
| 가치관 | 설명: |
|---|---|
farms/<farmname> |
농장 이름, 팜 고유 식별자. |
interfaces/<interface> |
인터페이스, 인터페이스 고유 식별자. |
system/<system> |
체계가능한 시스템 그래프는 다음과 같습니다. CPU, 하중, 숫양 or 교환. |
system/disk/<mount point> |
마운트 포인트,의 값이다 디스크 개체, 'GET / graphs'호출에 의해 반환됩니다. |
사용할 수있는 값 주파수 위치 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 주파수 | 끈 | 그래프를 생성하는 데 사용된 기간입니다. 가능한 값은 다음과 같습니다. 매일, 주간, 월 or 매년. |
응답 예 :
{
"description" : "Get farm graphs",
"graph" : "PNG IN BASE 64"
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 그래프 | 끈 | Base 64 형식의 그래프. |
IPDS
이 모듈은 IPS (침입 방지 시스템) 및 IDS (침입 탐지 시스템) 시스템으로 사용자에게 보안 계층을 제공합니다. IPDS 모듈은로드 밸런싱 모듈에 도달하기 직전의 트래픽을 검사합니다. LSLB or GSLB트래픽이 악성으로 탐지되면 거부됩니다.
다른 성격의 개체로 정의될 시스템에 보안 규칙을 적용하여 작동합니다. 각각은 외부의 악의적이거나 의심스러운 행동에 대한 솔루션을 제공합니다. 이 도구는 시스템 관리자가 위협 및 공격을 제어하는 데 도움이 됩니다.
Zevenet에 적용 할 수있는 규칙은 다음과 같습니다. 블랙리스트 및 서비스 거부.
IPDS - 블랙리스트
블랙리스트 사용자가 목록을 사용하여 소스 IP(수신 트래픽)에 따라 트래픽을 필터링하거나 허용할 수 있습니다.
목록에는 두 가지 유형이 있습니다.
- 원격: 목록은 URL에서 가져오며, 해당 목록은 수정할 수 없으며 다운로드하도록 예약할 수 있습니다.
- 로컬: 사용자는 주어진 정책으로 자신의 목록을 만들 수 있습니다. 거부 들어오는 IP가 일치하면 트래픽이 거부되거나 수 들어오는 IP가 일치하면 트래픽이 허용됩니다.
이 모듈에는 다음이 포함됩니다. 사전로드 Zevenet 팀에서 제공하는 목록, 목록을 농장에 적용할 준비가 되었습니다. 또한 사용자는 자신만의 개인화된 목록을 만들 수 있습니다.
동일한 팜에 여러 목록을 적용할 수 있습니다. 소스 IP가 일부 목록에서 일치하면 블랙리스트 정책에 따라 트래픽이 허용되거나 거부됩니다. IP가 일치하는 순간 소스 IP에 대해 더 이상 블랙리스트 검사가 수행되지 않습니다.
소스 IP가 서로 다른 두 목록에 있는 경우 거부 및 수그러면 항상 허용 정책이 먼저 평가됩니다.
모든 블랙리스트 규칙 나열
모든 블랙리스트 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists
GET /ipds/blacklists
사용자가 만들거나 팜에 적용 할 수있는 시스템에 미리로드 된 모든 블랙리스트를 나열합니다.
응답 예 :
{
"description" : "Get black lists",
"params" : [
{
"farms" : [],
"name" : "china",
"policy" : "deny",
"preload" : "true",
"type" : "local"
},
{
"farms" : [],
"name" : "russia",
"policy" : "deny",
"preload" : "true",
"type" : "local"
},
{
"farms" : [],
"name" : "northkorea",
"policy" : "deny",
"preload" : "true",
"type" : "local"
},
{
"farms" : [
"FarmHttp1",
"FarmGslb1",
],
"name" : "remoteList",
"policy" : "deny",
"preload" : "false",
"type" : "remote"
},
{
"farms" : [],
"name" : "myWhiteList",
"policy" : "allow",
"preload" : "false",
"type" : "local"
},
]
}
응답 매개 변수
응답은 JSON 객체가 될 것입니다. 매개 변수. 이것의 값은 각각 아래의 키 속성을 포함하는 블랙리스트 객체의 배열입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 블랙리스트가 적용된 팜 목록입니다. |
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| 프리로드 | 끈 | 가능한 값은 다음과 같습니다. 참된블랙리스트는 시스템에 사전로드되었습니다. 또는 그릇된, 시스템 관리자가 블랙리스트를 생성했습니다. |
| 유형 | 끈 | 목록이 저장되고 누가 그것을 관리하는지. 값은 다음과 같습니다. 지방의, 목록은 로컬 시스템에 저장되며 로컬에서 수정할 수 있습니다. 먼, 목록은 다음을 통해 원격 소스에서 다운로드됩니다. URL, 로컬에서 수정할 수 없으므로 원격 소스에서 수정해야합니다. |
블랙리스트 규칙 가져 오기
블랙리스트 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/loc
GET /ipds/blacklists/<name>
블랙리스트 구성 및 설명 매개 변수를 표시하십시오. name 블랙리스트 고유 식별자입니다.
응답 매개 변수
응답 로컬 목록 예 :
{
"description" : "Get list loc",
"params" : {
"farms" : [],
"name" : "loc",
"policy" : "deny",
"preload" : "false",
"sources" : [
{
"id" : 0,
"source" : "192.168.0.167"
},
{
"id" : 1,
"source" : "192.168.0.186"
}
],
"type" : "local"
}
}
로컬 블랙리스트 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 블랙리스트가 적용된 팜 목록입니다. |
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| 프리로드 | 끈 | 가능한 값은 다음과 같습니다. 참된블랙리스트는 시스템에 사전로드되었습니다. 또는 그릇된, 시스템 관리자가 블랙리스트를 생성했습니다. |
| 유형 | 끈 | 목록이 저장되고 누가 그것을 관리하는지. 값은 다음과 같습니다. 지방의, 목록은 시스템에 저장되고 시스템 관리자가 관리합니다. 또는 먼, 목록은 원격 URL에서 다운로드됩니다. |
| 소스 | 목적[] | 목록이 검사하는 IP 목록입니다. 허용 된 소스 네트워크 형식 : 네트워크 주소 / 마스크 조금 또는 IP |
응답 원격 목록 예 :
{
"description" : "Get list remoteList",
"params" : {
"day" : "thursday",
"farms" : [
"FarmHttp1",
"FarmGslb1",
],
"frequency" : "weekly",
"name" : "remoteList",
"policy" : "deny",
"sources" : [
{
"id" : 0,
"source" : "78.12.0.4"
},
{
"id" : 1,
"source" : "68.100.15.5"
},
{
"id" : 2,
"source" : "65.12.12.95"
}
],
"time" : {
"hour" : 0,
"minutes" : 0
},
"update_status" : "This list isn't downloaded yet.",
"type" : "remote",
"url" : "http://192.168.10.10/lists/test.txt"
}
}
원격 차단 목록 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 블랙리스트가 적용된 팜 목록입니다. |
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| 프리로드 | 끈 | 가능한 값은 다음과 같습니다. 참된블랙리스트는 시스템에 사전로드되었습니다. 또는 그릇된, 시스템 관리자가 블랙리스트를 생성했습니다. |
| 유형 | 끈 | 목록이 저장되고 누가 그것을 관리하는지. 값은 다음과 같습니다. 지방의, 목록은 시스템에 저장되고 시스템 관리자가 관리합니다. 또는 먼, 목록은 원격지에서 다운로드됩니다. URL. |
| 소스 | 목적[] | 검사를 나열하는 소스 IP. 목록이 다음과 같은 경우 유형 먼 목록 내용은 첫 번째 다운로드 때까지 표시되지 않습니다. |
| 업데이트 상태 | 끈 | 목록의 마지막 다운로드 상태 및 로컬 시스템에서 마지막으로 성공한 업데이트 날짜. |
| URL | 끈 | 원격 목록 다운로드 위치 원격 형식은 하나의 목록이어야합니다. 네트워크/비트 마스크 또는 라인당 IP. |
| 주파수 | 끈 | 원격 목록 업데이트 빈도. 옵션은 다음과 같습니다. 매일, 모든 요일을 한 번 또는 주기적으로 업데이트하십시오. frequency_type 들; 주간일주일에 한 번 업데이트; 또는 월한 달에 한 번 업데이트됩니다. |
| frequency_type | 끈 | 이 매개 변수는 주파수 매일 그 값이 매일 일 때. 가능한 값은 다음과 같습니다. 정확한. 하루 중 한 시간을 정의하십시오. 또는 기간하루 동안 업데이트 할 기간을 정의하십시오. |
| 일 | 문자열 또는 숫자 | 이 매개 변수는 매개 변수를 완성합니다. 주파수 언제 주파수 가치는 주간 or 월. 면 주파수 is 주간 이 매개변수는 요일이어야 합니다(월요일, 화요일, 수요일, 목요일, 금요일, 토요일 or 일요일) 만약 주파수 가치는 월 이 매개 변수는 월의 날짜 여야합니다 ( 1 및 31). |
| 시간 | 목적 | 필드에 의존하는 구조체입니다. 주파수. |
일일 빈도 및 기간에 대한 시간 개체 frequency_type
| 분야 | 타입 | 설명: |
|---|---|---|
| 기간 | 번호 | 얼마나 자주 목록이 업데이트됩니까? |
| 단위 | 끈 | 기간 단위. 옵션은 다음과 같습니다. 분목록이 구성된 모든 분마다 업데이트됨을 나타냅니다. 또는 시간, 목록은 구성된 시간마다 업데이트됩니다. |
다른 주파수의 시간 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| 시간 | 번호 | 목록을 업데이트 할 시간. 값은 사이의 숫자 여야합니다. 0 및 23. |
| 분 | 번호 | 목록을 업데이트하는 분. 값은 사이의 숫자 여야합니다. 0 및 59. |
소스 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 목록에서 소스 고유 식별자. |
| 끈 | 목록이 검사하는 IP 주소 또는 네트 세그먼트. |
블랙리스트 규칙 만들기
새 블랙리스트 만들기
지역 목록 요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"newListLoc", "type":"local", "policy":"allow"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists
원격 목록 요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"name":"newListRem", "type":"remote", "url":"https://192.168.10.12/lists/test.txt"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists
POST /ipds/blacklists
팜에서 사용할 블랙리스트를 만듭니다. 블랙리스트는 두 가지 유형이 있습니다.
- 로컬: 사용자가 소스를 추가합니다. 목록은 로컬에 저장됩니다.
- 원격 : 소스는 원격 위치에서 가져옵니다. 이 위치는 URL로 표시됩니다. 지원되는 원격 목록 형식은 하나입니다. 네트워크 주소 / 마스크 비트 or IP 라인 당 라인.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. | 참된 |
| 유형 | 끈 | 목록이 저장되고 누가 그것을 유지하는지. 값은 다음과 같습니다. 지방의, 목록은 시스템에 저장되고 관리 시스템에 유지됩니다. 또는 먼, 목록은 외부 서비스에서 URL 관리자 서비스는 목록을 유지 관리합니다. | 참된 |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록 소스의 트래픽을 수락합니다. 기본값은 거부입니다. | |
| URL | 끈 | 원격 목록 다운로드 위치 원격 형식은 하나의 목록이어야합니다. 형식으로 한 줄에 네트워크 주소 / 마스크 비트 or IP. | 원격 목록의 경우 true |
{
"description" : "Post list list1",
"params" : {
"farms" : [],
"name" : "newListLoc",
"policy" : "deny",
"preload" : "false",
"type" : "local"
}
}
응답 매개 변수
응답은 JSON 객체가 될 것입니다. 매개 변수. 이것의 값은 각각 다음 키 속성을 포함하는 블랙리스트 객체의 배열입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 블랙리스트가 적용된 팜 목록입니다. |
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| 프리로드 | 끈 | 가능한 값은 다음과 같습니다. 참된블랙리스트는 시스템에 사전로드되었습니다. 또는 그릇된, 시스템 관리자를 위한 블랙리스트가 생성되었습니다. |
| 유형 | 끈 | 목록이 저장되고 누가 그것을 유지하는지. 값은 다음과 같습니다. 지방의, 목록은 시스템에 저장되고 관리 시스템에 유지됩니다. 또는 먼, 목록은 외부 서비스에서 URL 관리자 서비스는 목록을 유지 관리합니다. |
블랙리스트 규칙 수정
블랙리스트 수정
지역 목록 요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"policy":"allow","source":["78.12.0.4","68.100.15.5","65.12.12.95"]}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/whiteList
PUT /ipds/blacklists/<name>
블랙리스트 규칙의 구성을 수정하십시오. name 블랙리스트 고유 식별자입니다.
로컬 목록에 대한 매개 변수 요청 :
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. 아니오에만 수정 가능합니다. 프리로드 목록. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| 끈[] | 목록이 확인하는 IP 주소 또는 네트 세그먼트 목록입니다. 소스만 변경하려면 문서 섹션을 참조하십시오. IPDS> 블랙리스트> 블랙리스트 소스 수정. 소스만 수정할 수 없음 프리로드 목록. |
응답 예 :
{
"description" : "Modify list whiteList.",
"params" : {
"name" : "whiteList",
"policy" : "allow",
"preload" : "false",
"type" : "local"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
원격 목록 요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"remoteList","url":"http://192.168.10.10/lists/test.txt","policy":"deny","frequency":"daily","frequency_type":"exact","time":{"hour":1,"minutes":0}}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem
목록을 2 시간마다 업데이트하는 요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"frequency":"daily","frequency_type":"period","time":{"period":2,"units":"hours"}}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem
2 : 00 AM에서 모든 요일을 업데이트하는 예를 요청하십시오.
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"frequency":"daily","frequency_type":"exact","time":{"hour":2,"minutes":0}}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem
모든 월요일을 0 : 00 AM :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"frequency":"weekly","day":"monday","time":{"hour":0,"minutes":0}}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem
1에서 해당 달의 12을 (를) 업데이트하기위한 요청 예 : 00 PM :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"frequency":"monthly","day":"1","time":{"hour":12,"minutes":0}}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/newListRem
원격 목록에 대한 매개 변수 요청
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 블랙리스트가 적용된 팜 목록입니다. |
| name | 끈 | 블랙리스트 이름. 고유 식별자로 사용됩니다. |
| 정책 | 끈 | 소스에 적용 할 작업입니다. 옵션은 다음과 같습니다. 거부, 목록의 출처에서 입력 트래픽을 차단하십시오. 또는 수 목록의 출처에서 트래픽을 수락하십시오. |
| URL | 끈 | 원격 목록 다운로드 위치 |
| 주파수 | 끈 | 원격 목록 업데이트 빈도. 옵션은 다음과 같습니다. 매일, 하루 종일, 한 번 또는 주기적으로 업데이트하면 다음과 같이 표시됩니다. frequency_type 들; 주간일주일에 한 번 업데이트; 또는 월한 달에 한 번 업데이트됩니다. |
| frequency_type | 끈 | 이 매개 변수는 주파수 매일 그 값이 매일 일 때. 가능한 값은 다음과 같습니다. 정확한. 하루 중 한 시간을 정의하십시오. 또는 기간하루 동안 업데이트 할 기간을 정의하십시오. |
| 일 | 문자열 또는 숫자 | 이 매개 변수는 주파수 값이 주간 또는 월간인 경우. 주간인 경우 이 매개변수는 요일(월요일, 화요일, 수요일, 목요일, 금요일, 토요일 or 일요일) else if 주파수 매월입니다.이 매개 변수는 월간 날짜 여야합니다 ( 1 및 31). |
| 시간 | 목적 | 필드에 의존하는 구조체입니다. 주파수. |
기간 개체
기간 시간이 구성되는 필드입니다.
필요한 설정입니다. 주파수 가치와 함께 매일 frequency_type 가치와 함께 기간.
| 분야 | 타입 | 설명: |
|---|---|---|
| 기간 | 번호 | 목록을 업데이트하는 빈도입니다. |
| 단위 | 끈 | 기간 단위. 옵션은 다음과 같습니다. 분 or 시간목록 업데이트에 대한 측정 단위를 나타냅니다. |
시간 정확한 시간 개체
정확한 시간이 구성되는 필드입니다.
이 개체는 다음 구성과 함께 사용됩니다.
주파수 필드에 값이있다. 매일 및 frequency_type is 정확한.
주파수 필드에 값이있다. 주간 및 일 목록이 업데이트되는 요일입니다.
주파수 필드에 값이있다. 월 및 일 목록이 업데이트되는 요일입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 시간 | 번호 | 목록을 업데이트 할 시간. 값은 사이의 숫자 여야합니다. 0 및 23. |
| 분 | 번호 | 목록을 업데이트하는 분. 값은 사이의 숫자 여야합니다. 0 및 59. |
응답 예 :
{
"description" : "Modify list newListRem.",
"params" : {
"day": 1,
"frequency" : "monthly",
"name" : "newListRem",
"policy" : "deny",
"preload" : "false",
"time" : {
"hour" : 12,
"minutes" : 0
},
"type" : "remote",
"update_status" : "Sync fail. Last update: 2017-02-16 14:23:00",
"url" : "https://192.168.10.12/lists/test.txt"
}
}
응답 매개 변수
응답은 모든 목록 구성이 포함된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
원격 블랙리스트 규칙 업데이트
원격 블랙리스트 업데이트
원격 목록 요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"update"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/remoteList/actions
POST /ipds/blacklists/<name>/actions
소스를 다운로드하여 원격 목록을 업데이트합니다. name 블랙리스트 고유 식별자입니다.
원격 목록에 대한 매개 변수 요청
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 목록에 보낼 작업입니다. 이 매개변수는 최신 정보. | 참된 |
응답 예 :
{
"description" : "Update a remote list",
"update" : "Sync OK. Last update: 2017-02-01 05:31:57"
}
응답 매개 변수
응답은 다운로드 상태가 포함된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 최신 정보 | 끈 | 마지막으로 다운로드 한 목록의 상태 및 마지막으로 성공한 업데이트 날짜 |
블랙리스트 규칙 삭제
블랙리스트 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/remoteList
DELETE /ipds/blacklists/<name>
주어진 블랙리스트를 삭제하십시오. name 블랙리스트 고유 식별자입니다.
응답 예 :
{
"description" : "Delete list 'remoteList'",
"message" : "The list remoteList has been deleted successful.",
"success" : "true"
}
블랙리스트의 소스 목록보기
블랙리스트의 소스 목록보기
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList
GET /ipds/blacklists/<name>/sources
블랙리스트의 출처를 열거하십시오. name 블랙리스트 고유 식별자입니다.
응답 예 :
{
"description" : "Get localList sources",
"params" : [
{
"id" : 0,
"source" : "78.12.0.4"
},
{
"id" : 1,
"source" : "68.100.15.5"
},
{
"id" : 2,
"source" : "65.12.12.95"
}
]
}
응답 매개 변수
응답은 키가있는 JSON이됩니다. 매개 변수 소스 객체 배열을 값으로 사용합니다.
원본 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| id | 번호 | 목록에서 소스 고유 식별자. |
| 끈[] | 목록이 검사하는 IP 주소 또는 네트 세그먼트. |
블랙리스트에 소스 추가하기
블랙리스트에 소스 추가하기
요청 예 :
curl -k -X POST -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"source":"192.168.3.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources
POST /ipds/blacklists/<name>/sources
새로운 출처를 블랙리스트에 올리십시오. 로컬 목록 및 미리로드되지 않은 목록에서만 사용할 수 있습니다. name 블랙리스트 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 끈 | 목록이 확인하는 IP 주소 또는 순 세그먼트입니다. | 참된 |
응답 예 :
{
"description" : "Post source to localList.",
"message" : "Added 192.168.3.1 successful.",
"params" : [
{
"id" : 0,
"source" : "78.12.0.4"
},
{
"id" : 1,
"source" : "68.100.15.5"
},
{
"id" : 2,
"source" : "65.12.12.95"
},
{
"id" : 3,
"source" : "192.168.3.1"
}
]
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
블랙리스트의 소스 수정
블랙리스트의 소스 수정
요청 예 :
curl -k -X PUT -H "ZAPI_KEY: <ZAPI_KEY_STRING>" -H 'Content-Type: application/json'
-d '{"source":"192.168.3.1"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources/2
PUT /ipds/blacklists/<name>/sources/<id>
블랙리스트의 소스를 수정하십시오.
name 블랙리스트 고유 식별자입니다. id 소스 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 끈 | 목록이 확인하는 IP 주소 또는 순 세그먼트입니다. | 참된 |
응답 예 :
{
"description" : "Put source into localList",
"message" : "Source 2 has been modified successful.",
"params" : {
"id" : 2,
"source" : "192.168.3.1"
}
}
응답 매개 변수
응답은 소스가 업데이트된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
블랙리스트의 소스 삭제
블랙리스트의 소스 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/blacklists/localList/sources/2
DELETE /ipds/blacklists/<name>/sources/<id>
블랙리스트에서 소스를 제거하십시오.
name 블랙리스트 고유 식별자입니다. id 소스 고유 식별자입니다.
응답 예 :
{
"description" : "Delete source from the list localList",
"message" : "Source 2 has been deleted successful.",
"success" : "true"
}
IPDS - DoS
DoS 보호는 보호 규칙에 따라 다른 유형의 규칙이 있으며 밸런서의 다른 부분에 적용됩니다. 그래서 있다 체계 모든 밸런서를 적용하는 규칙. 특정 연결 지향 규칙 농장 TCP 프로토콜로 작업. 규칙을 적용하기 전에 농장, 원하는 구성으로 개체를 만듭니다. 다음으로 필요한 모든 농장에 적용했습니다. 그만큼 체계 규칙에는 이미 생성된 개체가 있고 가능한 구성이 하나만 있습니다. 구성했으면 활성화합니다.
팜 DoS 규칙
팜에 규칙을 적용하기 전에 개체를 생성해야 합니다.
limitsec
초당 새 연결 및 소스 제한. 팜에서만 사용 가능하며 TCP 프로토콜과 함께 작동합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 새 연결 수입니다. |
| limit_burst | 번호 | 허용되는 새 연결의 최대치입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
제한선
소스당 총 현재 연결 수를 제한합니다. 팜에서만 사용 가능하며 TCP 프로토콜과 함께 작동합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
| limit_conns | 번호 | 소스에서 현재 연결의 최대 수입니다. |
bogustcpflags
TCP 프로토콜이 준수되는지 확인하십시오. 이 규칙에는 구성 매개변수가 없으므로 모든 팜에서 사용할 수 있는 개체만 생성합니다. 팜에서만 사용 가능하며 TCP 프로토콜과 함께 작동합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
limitrst
초당 재설정 연결 요청 수를 제한합니다. 팜에서만 사용 가능하며 TCP 프로토콜과 함께 작동합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 재설정 요청 수입니다. |
| limit_burst | 번호 | 허용되는 최대 재설정 요청입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
시스템 DoS 규칙
시스템 DoS 규칙에서 개체가 생성되지 않았습니다.
sshbruteforce
새 ssh 연결 제한.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 개체 규칙 고유 식별자입니다. 식별자는 다음과 같이 정의되었습니다. ssh_brute_force. |
| 안타 | 번호 | 연결이 차단되기 전에 소스에 대한 히트 수입니다. |
| 시간 | 번호 | 재설정하는 데 걸리는 시간(초) 안타 카운터. |
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
dropicmp
시스템이 icmp 요청을 삭제합니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 개체 규칙 고유 식별자입니다. 식별자는 다음과 같이 정의되었습니다. drop_icmp. |
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
모든 유형의 DoS 규칙 나열
모든 유형의 DoS 규칙 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/rules
GET /ipds/dos/rules
DoS 규칙 목록을 표시합니다. 개체가 아니라 개체를 정의하는 유형입니다.
각 규칙에는 다른 구성 매개 변수가 있습니다.
응답 예 :
{
"description" : "Get DoS settings.",
"params" : {
"farm" : [
{
"description" : "Connection limit per seconds.",
"rule" : "limitsec"
},
{
"description" : "Total connections limit per source IP.",
"rule" : "limitconns"
},
{
"description" : "Check bogus TCP flags.",
"rule" : "bogustcpflags"
},
{
"description" : "Limit RST request per second.",
"rule" : "limitrst"
}
],
"system" : [
{
"description" : "SSH brute force.",
"rule" : "sshbruteforce"
},
{
"description" : "Drop icmp packets",
"rule" : "dropicmp"
}
]
}
}
응답 매개 변수
JSON 응답에는 두 개의 배열이 있습니다. 농장 및 체계. 각 배열 항목은 시스템 팜에 적용되는 규칙 유형입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 설명 | 끈 | 규칙에 대한 간략한 설명. |
| 지배 | 끈 | 타입 룰 고유 식별자. |
모든 DoS 규칙 나열
모든 DoS 개체 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos
GET /ipds/dos
기존의 모든 DoS 개체에 대한 구성을 표시합니다.
응답 예 :
{
"description" : "Get DoS settings.",
"params" : [
{
"farms" : [],
"limit_conns" : 10,
"name" : "limitConnHttp",
"rule" : "limitconns",
"type" : "farm"
},
{
"farms" : [],
"limit" : 2,
"limit_burst" : 2,
"name" : "limitUsers",
"rule" : "limitsec",
"type" : "farm"
},
{
"hits" : 5,
"name" : "ssh_brute_force",
"port" : 22,
"rule" : "sshbruteforce",
"status" : "down",
"time" : 180,
"type" : "system"
},
{
"name" : "drop_icmp",
"rule" : "dropicmp",
"status" : "down",
"type" : "system"
},
{
"farms" : [],
"name" : "tcpAuth",
"rule" : "bogustcpflags",
"type" : "farm"
},
{
"farms" : [],
"limit" : 2,
"limit_burst" : 2,
"name" : "dos4",
"rule" : "limitrst",
"type" : "farm"
},
]
}
응답 매개 변수
응답은 사용 가능한 모든 DoS 개체가 포함된 배열입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
| 지배 | 끈 | 형식 규칙 식별자입니다. |
| 유형 | 끈 | 가능한 값은 다음과 같습니다. 농장, 규칙은 농장에 적용됩니다. 또는 체계, 규칙은 시스템에 적용됩니다. |
추가로 규칙에 따라 개체에 다음 매개 변수가 포함됩니다.
limitsec
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 새 연결 수입니다. |
| limit_burst | 번호 | 허용되는 새 연결의 최대치입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
제한선
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| limit_conns | 번호 | 소스에서 현재 연결의 최대 수입니다. |
bogustcpflags
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
limitrst
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 재설정 요청 수입니다. |
| limit_burst | 번호 | 허용되는 최대 재설정 요청입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
sshbruteforce
| 분야 | 타입 | 설명: |
|---|---|---|
| 안타 | 번호 | 연결이 차단되기 전에 소스에 대한 히트 수입니다. |
| 시간 | 번호 | 재설정하는 데 걸리는 시간(초) 안타 카운터. |
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
dropicmp
| 분야 | 타입 | 설명: |
|---|---|---|
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
DoS 규칙 검색
DoS 규칙 검색
팜 규칙 요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/limitConnHttp
시스템 규칙에 대한 요청 예:
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/ssh_brute_force
GET /ipds/dos/<name>
각 DoS 개체는 다른 구성을 가질 수 있습니다. name DoS 규칙 고유 식별자입니다.
팜 규칙에 대한 응답 예 :
{
"description" : "Get DoS limitConnHttp settings",
"params" : {
"farms" : [],
"limit_conns" : 10,
"name" : "limitConnHttp",
"rule" : "limitconns",
"type" : "farm"
}
}
시스템 규칙에 대한 응답 예:
{
"description" : "Get DoS ssh_brute_force settings",
"params" : {
"hits" : 5,
"name" : "ssh_brute_force",
"port" : 22,
"rule" : "sshbruteforce",
"status" : "down",
"time" : 180,
"type" : "system"
}
}
응답 매개 변수
응답은 사용 가능한 모든 DoS 개체가 포함된 배열입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. |
| 지배 | 끈 | 형식 규칙 식별자입니다. |
| 유형 | 끈 | 가능한 값은 다음과 같습니다. 농장, 규칙은 농장에 적용됩니다. 또는 체계, 규칙은 시스템에 적용됩니다. |
추가로 규칙에 따라 개체에 다음 매개 변수가 포함됩니다.
limitsec
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 새 연결 수입니다. |
| limit_burst | 번호 | 허용되는 새 연결의 최대치입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
제한선
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| limit_conns | 번호 | 소스에서 현재 연결의 최대 수입니다. |
bogustcpflags
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
limitrst
| 분야 | 타입 | 설명: |
|---|---|---|
| 전원 | 끈[] | 규칙이 적용되는 팜입니다. |
| 제한 | 번호 | 소스에 대한 초당 최대 재설정 요청 수입니다. |
| limit_burst | 번호 | 허용되는 최대 재설정 요청입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
sshbruteforce
| 분야 | 타입 | 설명: |
|---|---|---|
| 안타 | 번호 | 연결이 차단되기 전에 소스에 대한 히트 수입니다. |
| 시간 | 번호 | 재설정하는 데 걸리는 시간(초) 안타 카운터. |
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
dropicmp
| 분야 | 타입 | 설명: |
|---|---|---|
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
DoS 규칙 만들기
DoS 규칙 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"limitUsers", "rule":"limitsec"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos
POST /ipds/dos
DoS 개체를 만들어 필요한대로 팜으로 사용합니다.
각 DoS 개체는 다른 구성을 가질 수 있습니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| name | 끈 | 객체 규칙 고유 식별자입니다. | 참된 |
| 지배 | 끈 | 형식 규칙 식별자입니다. 옵션은 다음과 같습니다. 제한선, limitsec, limitrst or bogustcpflags. | 참된 |
응답 예 :
{
"description" : "Post a DoS rule",
"params" : {
"farms" : [],
"limit" : 2,
"limit_burst" : 2,
"name" : "limitUsers",
"rule" : "limitsec",
"type" : "farm"
}
}
응답 매개 변수
응답은 생성된 규칙에 대한 기본 구성이 포함된 json입니다. 자세한 내용은 응답 예시를 참조하세요.
DoS 규칙 수정
DoS 규칙 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"hits":"10","status":"up","time":"100"}'
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/ssh_brute_force
PUT /ipds/dos/<name>
DoS 규칙을 수정하십시오. name DoS 규칙 고유 식별자입니다.
요청 매개 변수
각 규칙 유형은 서로 다른 매개 변수가 될 수 있습니다. 수정할 수있는 매개 변수는 다음입니다.
limitsec
| 분야 | 타입 | 설명: |
|---|---|---|
| 제한 | 번호 | 소스에 대한 초당 최대 새 연결 수입니다. |
| limit_burst | 번호 | 허용되는 새 연결의 최대치입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
제한선
| 분야 | 타입 | 설명: |
|---|---|---|
| limit_conns | 번호 | 소스에서 현재 연결의 최대 수입니다. |
bogustcpflags
매개 변수가 없습니다.
limitrst
| 분야 | 타입 | 설명: |
|---|---|---|
| 제한 | 번호 | 소스에 대한 초당 최대 재설정 요청 수입니다. |
| limit_burst | 번호 | 허용되는 최대 재설정 요청입니다. 버스트 장치는 "제한"초가 지나면 재생성됩니다. |
sshbruteforce
| 분야 | 타입 | 설명: |
|---|---|---|
| 안타 | 번호 | 연결이 차단되기 전에 소스에 대한 히트 수입니다. |
| 시간 | 번호 | 재설정하는 데 걸리는 시간(초) 안타 카운터. |
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
dropicmp
| 분야 | 타입 | 설명: |
|---|---|---|
| 지위 | 끈 | 규칙 상태를 표시합니다. 가능한 값은 다음과 같습니다. up 시스템이 icmp 요청을 삭제합니다. 또는 아래 (down) 시스템은 icmp 요청을 허용합니다. |
응답 예 :
{
"description" : "Put DoS rule settings",
"params" : {
"hits" : 10,
"name" : "ssh_brute_force",
"port" : 22,
"rule" : "sshbruteforce",
"status" : "up",
"time" : 100,
"type" : "system"
},
"success" : "true"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
DoS 규칙 삭제
DoS 규칙 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zenlb_server>:444/zapi/v3/zapi.cgi/ipds/dos/limitConnHttp
DELETE /ipds/dos/<name>
시스템 규칙으로 삭제할 수 없습니다. 비활성화하려면 상태를 아래 (down). name DoS 규칙 고유 식별자입니다.
응답 예 :
{
"description" : "Delete DoS rule",
"message" : "Deleted limitConnHttp successful.",
"success" : "true"
}
시스템 옵션은 밸런서 및 전역 매개변수에서 실행되는 서비스를 개인화할 수 있는 가능성을 제공합니다.
버전 표시
버전 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/version
GET /system/version
제품 버전에 대한 정보를 표시합니다.
응답 예 :
{
"description" : "Get version",
"params" : {
"appliance_version" : "ZVA 4100, hypervisor: xen",
"hostname" : "DEV5",
"kernel_version" : "3.16.7-ckt20",
"system_date" : "Thu Feb 2 10:34:27 2017",
"zevenet_version" : "5.0"
}
}
응답 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| appliance_version | 끈 | 어플라이언스 버전. 가상 머신인 경우 하이퍼바이저도 표시합니다. |
| 호스트 이름 | 끈 | 호스트 이름. |
| kernel_version | 끈 | 리눅스 커널 버전. |
| system_date | 끈 | 시스템 날짜. |
| zevenet_version | 끈 | Zevenet 버전. |
DNS 표시
DNS 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/dns
GET /system/dns
DNS 서비스 구성을 표시합니다.
응답 예 :
{
"description" : "Get dns",
"params" : {
"primary" : "8.8.8.8",
"secondary" : null
}
}
응답 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 일차 | 끈 | 시스템에 구성된 기본 DNS. |
| 보조 | 끈 | 시스템에 구성된 보조 DNS. |
DNS 수정
DNS 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"primary":"8.8.4.4","secondary":"8.8.8.8"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/dns
POST /system/dns
DNS 서비스 구성을 수정하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 일차 | 끈 | 시스템에 구성된 기본 DNS. |
| 보조 | 끈 | 시스템에 구성된 보조 DNS. |
응답 예 :
{
"description" : "Post dns",
"params" : {
"primary" : "8.8.4.4",
"secondary" : "8.8.8.8"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
SSH 표시
SSH 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ssh
GET /system/ssh
SSH 서비스 구성을 표시합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 들어 | 끈 | SSH 서비스가 수신 대기 중인 시스템의 IP입니다. 그만큼 캐릭터 * 구성된 모든 IP에서 수신 대기하는 데 사용됩니다. |
| 포트 | 끈 | SSH 서비스용으로 구성된 포트입니다. |
응답 예 :
{
"description" : "Get ssh",
"params" : {
"listen" : "*",
"port" : "22"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
SSH 수정
SSH 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"listen":"192.168.100.241","port":"22"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ssh
POST /system/ssh
SSH 서비스 구성을 수정합니다.
요청 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 들어 | 끈 | SSH 서비스가 수신 대기 중인 시스템의 IP입니다. 그만큼 캐릭터 * 구성된 모든 IP에서 수신 대기하는 데 사용됩니다. |
| 포트 | 끈 | SSH 서비스용으로 구성된 포트입니다. |
응답 예 :
{
"description" : "Post ssh",
"params" : {
"listen" : "192.168.100.241",
"port" : "22"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
SNMP 표시
SNMP 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/snmp
GET /system/snmp
SNMP 서비스 구성을 표시하십시오.
응답 예 :
{
"description" : "Get snmp",
"params" : {
"community" : "public",
"ip" : "*",
"port" : "161",
"scope" : "0.0.0.0/0",
"status" : "false"
}
}
응답 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 커뮤니티 | 끈 | 커뮤니티 이름. 읽기 전용 커뮤니티가 사용되었습니다. |
| ip | 끈 | SNMP 서비스가 실행중인 인터페이스 IP. 모든 인터페이스가 활성화 된 상태로 유지하는 것이 안전합니다. 캐릭터 *. |
| 포트 | 끈 | SNMP 서비스가 실행중인 포트. |
| 범위 | 끈 | 액세스 권한이 있는 IP 또는 서브넷(IP/비트). 허용된 클라이언트 IP는 SNMPD 서비스에 액세스할 수 있습니다. 하나의 IP에만 액세스를 허용하려는 경우 "/32" 비트를 사용하십시오. |
| 지위 | 끈 | SNMP 서비스의 상태. 가능한 값은 다음과 같습니다. 참된, 서비스가 실행 중입니다. 또는 그릇된, 서비스가 중지됩니다. |
SNMP 수정
SNMP 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.241","port":"170","scope":"0.0.0.0/0","status":"true","community":"public"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/snmp
POST /system/snmp
SNMP 서비스 구성을 수정하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 커뮤니티 | 끈 | 커뮤니티 이름. 읽기 전용 커뮤니티가 사용되었습니다. |
| ip | 끈 | SNMP 서비스가 실행중인 인터페이스 IP. 모든 인터페이스가 활성화 된 상태로 유지하는 것이 안전합니다. 캐릭터 *. |
| 포트 | 끈 | SNMP 서비스가 실행중인 포트. |
| 범위 | 끈 | 액세스 권한이 있는 IP 또는 서브넷(IP/비트). 허용된 클라이언트 IP는 SNMPD 서비스에 액세스할 수 있습니다. 하나의 IP에만 액세스를 허용하려는 경우 "/32" 비트를 사용하십시오. |
| 지위 | 끈 | SNMP 서비스의 상태. 가능한 값은 다음과 같습니다. 참된, 서비스가 실행 중입니다. 또는 그릇된, 서비스가 중지됩니다. |
응답 예 :
{
"description" : "Post snmp",
"params" : {
"community" : "public",
"ip" : "192.168.100.241",
"port" : "170",
"scope" : "0.0.0.0/0",
"status" : "true"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
라이선스 검색
라이선스 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/license/txt
GET /system/license/<format>
Zevenet 라이센스를 형식으로 표시하십시오. 사용할 수있는 체재 값은 HTML or TXT.
NTP 표시
NTP 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ntp
GET /system/ntp
NTP 서비스 구성을 표시하십시오.
응답 예 :
{
"description" : "Get ntp",
"params" : {
"server" : "pool.ntp.org"
}
}
응답 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 섬기는 사람 | 끈 | NTP 클라이언트가 요청을 처리하는 서버. |
NTP 수정
NTP 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"server":"pool.ntp.org"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/ntp
POST /system/ntp
NTP 서비스 구성을 수정하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 섬기는 사람 | 끈 | NTP 클라이언트가 요청을 처리하는 서버. |
응답 예 :
{
"description" : "Post ntp",
"params" : "pool.ntp.org"
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
HTTP 서버 표시
HTTP 서버 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/http
GET /system/http
HTTP 서비스 구성을 표시합니다. Zevenet API 및 GUI가 실행되는 곳입니다.
응답 예 :
{
"description" : "Get http",
"params" : {
"ip" : "*",
"port" : "444"
}
}
응답 매개 변수
응답은 아래의 매개 변수를 가진 JSON 객체가 될 것입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | HTTP 서버가 수신 대기 중인 IP입니다. 그만큼 캐릭터 * 구성된 모든 IP에서 수신 대기하는 데 사용됩니다. |
| 포트 | 끈 | HTTP 서비스가 수신 대기 중인 포트입니다. |
HTTP 서버 수정
HTTP 서버 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"ip":"192.168.100.241","port":"80"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/http
POST /system/http
HTTP 서비스 구성을 수정하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | HTTP 서버가 수신 대기 중인 IP입니다. 그만큼 캐릭터 * 구성된 모든 IP에서 수신 대기하는 데 사용됩니다. |
| 포트 | 끈 | HTTP 서비스가 수신 대기 중인 포트입니다. |
응답 예 :
{
"description" : "Post http",
"params" : {
"ip" : "192.168.100.241",
"port" : "80"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
모든 사용자 나열
모든 사용자 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users
GET /system/users
시스템에서 사용 가능한 사용자를 나열합니다.
응답 예 :
{
"description" : "Get users",
"params" : [
{
"status" : "true",
"user" : "root"
},
{
"status" : "true",
"user" : "zapi"
}
]
}
응답 매개 변수
응답은 아래 매개 변수의 배열을 가진 JSON 객체입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 지위 | 끈 | 사용자 상태. 가능한 값은 다음과 같습니다. 참된, 사용자가 활성화됩니다. 아니면 그릇된, 사용자가 비활성화됩니다. |
| 사용자 | 끈 | 사용자 이름. |
zapi 사용자 검색
zapi 사용자 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users/zapi
GET /system/users/zapi
zapi 사용자 구성을 표시합니다. 이 매개 변수는 zapi를 통해 Zevenet 서비스에 액세스하는 데 필요합니다.
응답 예 :
{
"description" : "Zapi user configuration.",
"params" : {
"key" : "root",
"status" : "true"
}
}
응답 매개 변수
응답은 아래 매개 변수의 배열을 가진 JSON 객체입니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 키 | 끈 | zapi에서 인증하기 위한 키입니다. 이것은 매개 변수입니다 ZAPI_KEY zapi 호출에 사용됩니다. |
| 지위 | 끈 | Zapi 사용자 상태. 그 값이 참된, zapi를 사용할 수 있습니다. 아니면 그릇된, zapi가 비활성화되어 요청을 보낼 수 없습니다. |
zapi 사용자 구성 수정
zapi 사용자 구성 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"key":"newzapikey","status":"enable","newpassword":"password1234"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users/zapi
POST /system/users/zapi
zapi 사용자 구성을 수정합니다. 이 매개 변수는 zapi를 통해 Zevenet 서비스에 액세스하는 데 필요합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 키 | 끈 | zapi에서 인증하기 위한 키입니다. 이것은 매개 변수입니다 ZAPI_KEY zapi 호출에 사용됩니다. |
| 새 비밀번호 | 끈 | zapi 사용자의 새 비밀번호입니다. |
| 지위 | 끈 | Zapi 사용자 상태. 그 값이 참된, zapi를 사용할 수 있습니다. 아니면 그릇된, zapi가 비활성화되어 요청을 보낼 수 없습니다. |
응답 예 :
{
"description" : "Zapi user settings.",
"message" : "Settings was changed successful.",
"params" : {
"key" : "newzapikey",
"newpassword" : "password1234",
"status" : "enable"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
루트 비밀번호 수정
루트 비밀번호 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
{"password":"admin","newpassword":"alwaysisbetterastrongpass"}
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/users/root
POST /system/users/root
루트 암호를 수정하십시오. 이 사용자는 GUI를 통해 zevenet 서비스에 액세스하는 데 사용됩니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 암호 | 끈 | 현재 루트 사용자 암호입니다. | 참된 |
| 새 비밀번호 | 끈 | 루트 사용자의 새 비밀번호입니다. | 참된 |
응답 예 :
{
"description" : "User settings.",
"message" : "Settings was changed succesful.",
"params" : {
"newpassword" : "alwaysisbetterastrongpass",
"password" : "admin"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
로그 파일 나열
로그 파일 나열
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/logs
GET /system/logs
사용 가능한 로그 파일을 나열하십시오.
응답 예 :
{
"description" : "Get logs",
"params" : [
{
"date" : "Mon Jan 30 06:25:02 2017",
"file" : "syslog.4.gz"
},
{
"date" : "Tue Jan 31 06:25:03 2017",
"file" : "syslog.3.gz"
},
{
"date" : "Wed Feb 1 06:25:04 2017",
"file" : "syslog.2.gz"
},
{
"date" : "Thu Feb 2 06:25:03 2017",
"file" : "syslog.1"
},
{
"date" : "Sun Jan 29 06:25:03 2017",
"file" : "syslog.5.gz"
},
{
"date" : "Fri Feb 3 04:28:56 2017",
"file" : "syslog"
}
]
}
응답 매개 변수
응답은 로그 파일 배열이 포함된 JSON입니다. 각 객체의 매개변수는 다음과 같습니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 데이터 | 끈 | 마지막 파일 수정 날짜. |
| 파일 | 끈 | 로그 파일의 파일 이름입니다. 로그 고유 식별자로 사용됩니다. |
로그 파일 다운로드
로그 파일 다운로드
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/logs/syslog.2.gz > log.gz
GET /system/logs/<file>
GET 요청 시 나열된 사용 가능한 로그 파일 중 로그 파일을 다운로드합니다.
파일 로그 파일 고유 식별자입니다.
시스템 - 백업
백업 옵션을 사용하면 현재 시스템 구성을 저장하고 다운로드할 수 있습니다.
이 섹션에서는 백업 파일을 생성, 복원, 업로드 및 다운로드 할 수 있습니다.
목록 백업
목록 백업
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup
GET /system/backup
응답 예 :
{
"description" : "Get backups",
"params" : [
{
"date" : "Fri Feb 3 06:01:04 2017",
"name" : "newbackup"
},
{
"date" : "Fri Feb 3 05:50:48 2017",
"name" : "firstConf"
}
]
}
응답 매개 변수
응답은 백업 배열이있는 JSON이됩니다. 각 배열 요소의 매개 변수는 다음과 같습니다.
| 분야 | 타입 | 설명: |
|---|---|---|
| 데이터 | 끈 | 최종 수정 날짜. |
| name | 끈 | 고유 식별자로 사용되는 파일 이름입니다. 파일 확장자는 .tar.gz. |
백업 만들기
백업 만들기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"name":"firstConf"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup
POST /system/backup
현재 구성의 시스템 구성 백업을 작성하십시오.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| name | 끈 | 고유 식별자로 사용되는 파일 이름입니다. 파일 확장자는 .tar.gz. |
응답 예 :
{
"description" : "Create a backups",
"message" : "Backup firstConf was created successful.",
"params" : "firstConf"
}
백업 다운로드
백업 다운로드
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf > ~/zevenetConf.tar.gz
백업 파일은 TAR GZ 형식입니다.
GET /system/backup/<name>
시스템 구성 백업을 다운로드하십시오. name 백업 고유 식별자입니다.
백업 업로드
백업 업로드
요청 예 :
curl -k -X PUT -H 'Content-Type: text/plain'
--data-binary @/opt/1mar.tar.gz -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/newbackup
PUT /system/backup/<name>
로컬 저장된 백업을 Zevenet에 업로드하십시오. name Zevenet에 저장 될 백업 고유 식별자입니다.
요청 매개 변수
백업을 업로드하려면 –data-binary를 사용해야합니다.
응답 예 :
{
"description" : "Upload a backup",
"message" : "Backup newbackup was created successful.",
"params" : "newbackup"
}
백업 삭제
백업 삭제
요청 예 :
curl -k -X DELETE -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf
DELETE /system/backup/<name>
Zevenet 시스템에서 백업 파일을 삭제하십시오. name 백업 고유 식별자입니다.
응답 예 :
{
"description" : "Delete backup firstConf'",
"message" : "The list firstConf has been deleted successful.",
"success" : "true"
}
백업 적용
백업 적용
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"apply"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/backup/firstConf/actions
POST /system/backup/<name>/actions
백업 파일에서 구성을 복원하십시오. name 백업 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 백업 구성을 복원하려면 값이 다음과 같아야합니다. 대다. |
응답 예 :
{
"description" : "Apply a backup to the system",
"params" : {
"action" : "apply"
}
}
시스템 - 알림
알림은 다음 두 요소로 구성됩니다. 보내는 사람 방법과 유형 경보.
알림 섹션에서 수신하려는 알림 유형을 선택할 수 있습니다. 실제로 경고는 백엔드 또는 클러스터 상태에 중점을 두므로 일부 스위치가 전환되면 밸런서가 알림을 보냅니다.
방법 섹션에서 Zevenet이 알림을 보내야 할 때 사용할 발신자를 선택할 수 있습니다.
알림 상태 표시
알림 상태 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts
GET /system/notifications/alerts
상태와 함께 모든 유형의 알림을 나열합니다.
응답 예 :
{
"description" : "Get notifications alert status",
"params" : [
{
"alert" : "backends",
"status" : "disabled"
},
{
"alert" : "cluster",
"status" : "disabled"
}
]
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 경보 | 끈 | 경고 유형으로 경고 고유 식별자로 사용됩니다. 사용 가능한 경고는 다음과 같습니다. 백엔드, 백엔드 상태가 변경될 때 알림 또는 클러스터, 클러스터 마스터 노드가 다른 노드로 전환될 때 알림을 보냅니다. |
| 지위 | 끈 | 알림이 있는지 표시 사용, 시스템은 이벤트가 있을 때 알림을 보내지 않습니다. 또는 사용 가능, 상태 변경이 감지되면 시스템에서 경고를 보냅니다. |
알림 알림 검색
알림 알림 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends
GET /system/notifications/alerts/<alert>
경고 유형에 대한 구성을 표시하십시오.
경보 경고 고유 식별자입니다.
응답 예 :
{
"description" : "Get notifications alert backends settings",
"params" : {
"avoidflappingtime" : 5,
"prefix" : "",
"status" : "disabled"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 피하는 시간 | 번호 | 때때로 백엔드를 사용할 수 있거나 짧은 시간 내에 사용할 수 없는 경우, 이 필드를 사용하면 백엔드가 상태를 변경하는 동안 알림 메시지를 피할 수 있는 기간을 구성할 수 있습니다. 이 기간이 끝나면 백엔드 상태가 시작하는 것과 다른 경우 알림이 전송됩니다. |
| 접두사 | 끈 | 이러한 종류의 경고를 위해 시스템에서 보낸 전자 메일 제목 접미사입니다. |
| 지위 | 끈 | 알림이 있는지 표시 사용, 시스템은 이벤트가 있을 때 알림을 보내지 않습니다. 또는 사용 가능, 상태 변경이 감지되면 시스템에서 경고를 보냅니다. |
알림 알림 수정
알림 알림 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
{"avoidflappingtime":10,"prefix":"[backend alert]"}
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends
POST /system/notifications/alerts/<alert>
경보 경고 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 피하는 시간 | 번호 | 때때로 백엔드를 사용할 수 있거나 짧은 시간 내에 사용할 수 없는 경우가 있습니다. 이 필드를 사용하면 백엔드가 상태를 변경하는 동안 알림 메시지를 피할 수 있는 기간을 구성할 수 있습니다. 이 기간이 끝나면 백엔드 상태가 시작하는 것과 다른 경우 알림이 전송됩니다. 이 매개변수는 클러스터 경보에 없으며 클러스터에는 자체 전환 시간이 있습니다. |
| 접두사 | 끈 | 이러한 종류의 경고를 위해 시스템에서 보낸 전자 메일 제목 접미사입니다. |
응답 예 :
{
"description" : "Set notifications alert backends",
"params" : {
"avoidflappingtime" : 10,
"prefix" : "[backend alert]"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
알리미 사용
알리미 사용
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
{"action":"enable"}
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/alerts/backends/actions
POST /system/notifications/alerts/<alert>/actions
경고 유형에 대한 알림을 사용 또는 사용하지 않도록 설정합니다.
경보 경고 고유 식별자입니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 경고에 사용할 수 있는 작업은 다음과 같습니다. 사용, 시스템은 이벤트가 있을 때 알림을 보내지 않습니다. 또는 사용 가능, 상태 변경이 감지되면 시스템에서 경고를 보냅니다. |
응답 예 :
{
"description" : "Set notifications alert backends actions",
"params" : {
"action" : "enable"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
전자 메일 구성 검색
전자 메일 구성 검색
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email
GET /system/notifications/methods/email
이메일 발신자의 모든 구성을 표시합니다.
참고 : TLS를 사용하는 경우에도 전자 메일을 보내는 데 사용되는 SMTP 포트는 TCP 25입니다.
응답 예 :
{
"description" : "Get notifications email methods",
"params" : {
"from" : "user@zevenet.com",
"method" : "email",
"password" : "******",
"server" : "smtp.gmail.com",
"tls" : "true",
"to" : "adminuser@zevenet.net",
"user" : "user@zevenet.com"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 에 | 끈 | 이메일을 보내는 이메일 계정, 이 계정은 SMTP 헤더 From:에 표시되며 수신자가 이메일에 회신하는 경우 사용됩니다. |
| 방법 | 끈 | 메서드 고유 식별자입니다. 실제로 사용 가능한 방법은 이메일. |
| 암호 | 끈 | 암호 사용자 SMTP 계정.이 암호는 서버에 SMTP 인증이 필요한 경우 필요합니다. |
| 섬기는 사람 | 끈 | 전자 메일을 통한 SMTP 서버가 전송됩니다. |
| TLS | 끈 | 이메일 전송에 TLS 유효성 검사를 활성화합니다. 이 속성은 STARTTLS를 사용하며 이 기능은 SMTP 서버에서 지원되어야 합니다. 일부 SMTP 서버에서는 이를 활성화해야 합니다. 가능한 값은 다음과 같습니다. 참된TLS 유효성 검사는 전자 메일을 보낼 수 있습니다. 또는 그릇된, 이메일 전송은 TLS 유효성 검사를 사용하지 않습니다. |
| 에 | 끈 | 전자 메일을받는 전자 메일 계정으로,이 계정은 SMTP 헤더 To에 나타납니다. |
| 사용자 | 끈 | 이메일을 보낼 수 있는 이메일 계정, 이 계정은 서버가 SMTP 인증을 요구하는 경우에 필요합니다. |
전자 메일 구성 수정
전자 메일 구성 수정
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"from":"user@zevenet.com","password":"verystrongpass","server":"smtp.gmail.com","to":"adminuser@zevenet.net","tls":"true","user":"user@zevenet.com"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email
POST /system/notifications/methods/email
이메일 발신자 방법의 구성을 수정합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 에 | 끈 | 이메일을 보내는 이메일 계정, 이 계정은 SMTP 헤더 From:에 표시되며 수신자가 이메일에 회신하는 경우 사용됩니다. |
| 암호 | 끈 | 암호 사용자 SMTP 계정.이 암호는 서버에 SMTP 인증이 필요한 경우 필요합니다. |
| 섬기는 사람 | 끈 | 전자 메일을 통한 SMTP 서버가 전송됩니다. |
| TLS | 끈 | 이메일 전송에 TLS 유효성 검사를 활성화합니다. 이 속성은 STARTTLS를 사용하며 이 기능은 SMTP 서버에서 지원되어야 합니다. 일부 SMTP 서버에서는 이를 활성화해야 합니다. 가능한 값은 다음과 같습니다. 참된TLS 유효성 검사는 전자 메일을 보낼 수 있습니다. 또는 그릇된, 이메일 전송은 TLS 유효성 검사를 사용하지 않습니다. |
| 에 | 끈 | 전자 메일을받는 전자 메일 계정으로,이 계정은 SMTP 헤더 To에 나타납니다. |
| 사용자 | 끈 | 이메일을 보낼 수 있는 이메일 계정, 이 계정은 서버가 SMTP 인증을 요구하는 경우에 필요합니다. |
응답 예 :
{
"description" : "Get notifications email methods",
"params" : {
"from" : "user@zevenet.com",
"method" : "email",
"password" : "verystrongpass",
"server" : "smtp.gmail.com",
"tls" : "true",
"to" : "adminuser@zevenet.net",
"user" : "user@zevenet.com"
}
}
응답 매개 변수
응답은 요청 된 모든 값이 업데이트 된 json이됩니다. 자세한 정보는 응답 예제를 참조하십시오.
테스트 메일 보내기
테스트 메일 보내기
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"test"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/notifications/methods/email/actions
POST /system/notifications/methods/email/actions
전자 메일 구성을 테스트 메일로 보내 테스트합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 동작 | 끈 | 테스트 메일을 보낼 값은 다음과 같습니다. test. |
응답 예 :
{
"description" : "Send test mail",
"message" : "Test mail sent successful.",
"success" : "true"
}
무료 지원을 다운로드하십시오.
무료 지원을 다운로드하십시오.
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/supportsave > supportsave.tar.gz
GET /system/supportsave
시스템에서 실행 중인 모든 구성 및 프로세스와 함께 시스템 상태 이미지를 가져옵니다. 이 지원은 문제를 찾거나 지원을 지원하는 데 필요합니다.
시스템 - 클러스터
클러스터는 백엔드에 대한 연결을 관리하는 마스터 노드가 수행하는 요소이며, 마스터를 확인하는 백업 노드는 다운 상태가 되면 마스터 노드로 전환할 준비가 되어 있습니다.
전환된 상태가 있는 경우 백업 노드는 자체적으로 모든 연결 상태를 복원합니다. 따라서 클라이언트는 서비스 중단을 감지하지 않습니다.
이를 통해 로드 밸런서를 고가용성 상태로 만들 수 있습니다. 따라서 Zevenet에 문제가 있는 경우 서비스는 업로드된 구성으로 계속 작동합니다.
클러스터 구성 표시
클러스터 구성 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster
GET /system/cluster
클러스터에 대한 모든 구성을 표시하십시오.
응답 BODY :
{
"description" : "Show the cluster configuration",
"params" : {
"check_interval" : 5,
"failback" : "disabled",
"interface" : "eth0",
"nodes" : [
{
"ip" : "192.168.100.241",
"name" : "canoDEV4100",
"node" : "local"
},
{
"ip" : "192.168.100.240",
"name" : "maqvir",
"node" : "remote"
}
]
}
}
응답 매개 변수
응답은 클러스터 구성과 노드가있는 배열이있는 JSON 객체입니다.
클러스터 개체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| check_interval | 번호 | 마스터 노드 상태를 두 번 확인하는 사이의 대기 시간입니다. |
| 페일 백 | 끈 | 어떤 노드가 마스터로 우선권이 있는지. 값은 name 노드, 노드에 우선권을주기 위해; 또는 사용, 어떤 노드라도 마스터 일 수 있고 하나의 노드에 우선 순위가 없다면. |
| 인터페이스 | 끈 | 노드의 IP를 설정하는 인터페이스. |
| 노드 | 목적[] | 클러스터의 노드. |
노드 객체 :
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 노드의 상태를 확인하고 정보 복제를 수행하는 것은 노드에서 구성된 IP입니다. |
| name | 끈 | 노드 호스트 이름이며 노드 고유 식별자로 사용됩니다. |
| 노드 | 끈 | 가능한 값은 다음과 같습니다. 지방의, 노드가 zapi 요청을 수신하는 경우; 또는 먼, if는 클러스터에 구성된 다른 노드입니다. |
클러스터 사용
클러스터 사용
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"local_ip":"192.168.100.241","remote_ip":"192.168.100.240","remote_password":"admin"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster
POST /system/cluster
클러스터가 두 밸런서를 통신합니다.
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| remote_ip | 끈 | 클러스터에 사용되는 원격 호스트의 IP입니다. | 참된 |
| local_ip | 끈 | 클러스터에 사용되는 로컬 호스트의 IP입니다. | 참된 |
| remote_password | 끈 | 원격 밸런서의 루트 사용자 비밀번호. | 참된 |
응답 BODY :
{
"description" : "Enabling cluster",
"message" : "Cluster enabled successfully",
"success" : "true"
}
클러스터 구성 수정
클러스터 구성 수정
요청 예 :
curl -k -X PUT -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"check_interval":4,"failback":"disabled"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster
PUT /system/cluster
클러스터의 작업 모드 매개변수를 구성합니다.
요청 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| check_interval | 번호 | 마스터 노드 상태를 두 번 확인하는 사이의 대기 시간입니다. |
| 페일 백 | 끈 | 어떤 노드가 마스터로 우선권이 있는지. 값은 name 노드, 노드에 우선권을주기 위해; 또는 사용, 어떤 노드라도 마스터 일 수 있고 하나의 노드에 우선 순위가 없다면. |
응답 BODY :
{
"description" : "Modifying the cluster configuration",
"params" : {
"check_interval" : "4",
"failback" : "disabled"
}
}
클러스터 비활성화
클러스터 비활성화
요청 예 :
curl -k -X DELETE -H 'Content-Type: application/json'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster
DELETE /system/cluster
클러스터를 제거하십시오.
응답 BODY :
{
"description" : "Disabling cluster",
"message" : "Cluster disabled successfully",
"success" : "true"
}
유지 관리 모드
유지 관리 모드
요청 예 :
curl -k -X POST -H 'Content-Type: application/json' -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
-d '{"action":"maintenance","status":"enable"}'
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/actions
POST /system/cluster/actions
로컬 클러스터 노드를 유지 관리 모드로 변경하십시오.
응답 BODY :
{
"description" : "Setting maintenance mode",
"message" : "Local cluster node changed to maintenance mode successfully",
"success" : "true"
}
요청 매개 변수
| 분야 | 타입 | 설명: | 필수 |
|---|---|---|---|
| 동작 | 끈 | 클러스터에 적용 할 작업. 사용 가능한 조치는 유지. | 참된 |
| 지위 | 끈 | Status 노드를 넣으려면 가능한 값은 다음과 같습니다. 가능그것을 유지 보수 모드로 두십시오. 또는 비활성화노드를 사용 가능하게하십시오. | 참된 |
노드 상태 표시
노드 상태 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/nodes
GET /system/cluster/nodes
모든 노드의 상태를 표시합니다.
응답 BODY :
{
"description" : "Cluster nodes status",
"params" : [
{
"ip" : "192.168.100.241",
"message" : "Node online and active",
"name" : "canoDEV4100",
"node" : "local",
"role" : "master",
"status" : "ok"
},
{
"ip" : "192.168.100.240",
"message" : "Node online and passive",
"name" : "maqvir",
"node" : "remote",
"role" : "backup",
"status" : "ok"
}
]
}
응답 매개 변수
응답은 키가있는 JSON이됩니다. 내 돈 노드 상태 객체의 배열 값을 구한다.
노드 상태 객체
| 분야 | 타입 | 설명: |
|---|---|---|
| ip | 끈 | 노드의 상태를 확인하고 정보 복제를 수행하는 것은 노드에서 구성된 IP입니다. |
| name | 끈 | 노드 호스트 이름이며 노드 고유 식별자로 사용됩니다. |
| 노드 | 끈 | 가능한 값은 다음과 같습니다. 지방의, 노드가 zapi 요청을 수신하는 경우; 또는 먼, if는 클러스터에 구성된 다른 노드입니다. |
| 메시지 | 끈 | 노드의 상태 및 작동 모드를 나타내는 설명 메시지. |
| 역할 | 끈 | 이 노드의 실제 작업 모드. 가능한 값은 다음과 같습니다. 석사이 노드는 백엔드와 클라이언트 간의 연결을 관리합니다. 또는 백업이 노드는 마스터 상태 연결 및 마스터 구성에 응답했으며 마스터 서비스가 작동하는지 확인 중입니다. |
| 지위 | 끈 | 일부 클러스터 프로세스가 실패하고 있음을 나타냅니다. |
로컬 호스트 클러스터 상태 표시
로컬 호스트 클러스터 상태 표시
요청 예 :
curl -k -X GET -H "ZAPI_KEY: <ZAPI_KEY_STRING>"
https://<zevenet_server>:444/zapi/v3/zapi.cgi/system/cluster/nodes/localhost
GET /system/cluster/nodes/localhost
로컬 노드의 상태를 표시합니다.
응답 BODY :
{
"description" : "Cluster status for localhost",
"params" : {
"message" : "Node online and active",
"name" : "canoDEV4100",
"role" : "master",
"status" : "ok"
}
}
응답 매개 변수
| 분야 | 타입 | 설명: |
|---|---|---|
| 메시지 | 끈 | 노드의 상태 및 작동 모드를 나타내는 설명 메시지. |
| name | 끈 | 노드 호스트 이름이며 노드 고유 식별자로 사용됩니다. |
| 역할 | 끈 | 이 노드의 실제 작업 모드. 가능한 값은 다음과 같습니다. 석사이 노드는 백엔드와 클라이언트 간의 연결을 관리합니다. 또는 백업이 노드는 마스터 상태 연결 및 마스터 구성에 응답했으며 마스터 서비스가 작동하는지 확인 중입니다. |
| 지위 | 끈 | 일부 클러스터 프로세스가 실패하고 있음을 나타냅니다. |