ovahub방화벽 관리
/api/v1/firewalls
조직 방화벽의 이름, 규칙, 기본 선택과 서버 적용 대상을 관리합니다.
호출 전 확인
규칙이나 적용 대상을 변경하면 SSH 접근이 끊길 수 있습니다. 시스템 리소스는 수정할 수 없습니다. 재시도할 때 같은 requestKey를 유지하세요. 공급업체 결과가 불확실하면 409가 반환될 수 있습니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/firewalls" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"action": "create",
"requestKey": "docs_example_001",
"name": "my-firewall"
}'예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
매개변수
actionJSON 본문 · 필수"create" | "rules" | "rename" | "default" | "servers" | "attach" | "delete"
각 작업은 해당 필드만 허용합니다: create (name, rules), rules (id, rules), rename (id, name), default/delete (id), servers (id, serverIds), attach (id, serverId). 모든 작업에 requestKey도 필요합니다.
idJSON 본문 · 선택string
system 또는 24자리 방화벽 ID입니다. create를 제외한 작업에 필수입니다. 시스템 리소스는 수정할 수 없습니다.
nameJSON 본문 · 선택string
앞뒤 공백을 제거한 이름으로, 1–80자입니다. create와 rename에 필수이며 다른 작업에서는 허용하지 않습니다.
rulesJSON 본문 · 선택object[]
최대 64개의 규칙입니다. rules 작업에 필수이며 create의 기본값은 []입니다. 각 규칙에는 displayName (1–255자), protocol (tcp, udp, icmp 또는 빈 문자열), destPorts (최대 15개의 포트/범위, 0–65535), ipv4 (최대 100개의 IP/CIDR 또는 AnyIPv4), ipv6 (최대 100개의 IP/CIDR 또는 AnyIPv6), action: accept, status: active가 필요합니다. IP 목록 중 하나 이상은 비어 있으면 안 됩니다. TCP/UDP에는 포트가 필요하고 ICMP에는 필요하지 않습니다.
requestKeyJSON 본문 · 필수string
8–100자이며 A–Z, a–z, 0–9, 밑줄 또는 하이픈만 허용합니다. 같은 작업을 재시도할 때는 동일한 키와 동일한 입력값을 유지하세요.
serverIdsJSON 본문 · 선택string[]
servers 작업에 필수입니다. 플랫폼 서버 ID를 최대 100개 지정하며, 각 ID는 24자리 16진수 문자열입니다.
serverIdJSON 본문 · 선택string
attach 작업에 필수입니다. 24자리 16진수 플랫폼 서버 ID입니다.
응답
HTTP 상태 200
확인된 방화벽 변경 결과를 반환합니다. 공급업체 결과가 불확실하면 작업 접수 결과를 임의로 만들지 않고 오류를 발생시킵니다.
okboolean (true)요청한 방화벽 작업이 완료되었거나 원래 결과가 성공적으로 다시 반환되었습니다.
pendingboolean (false)현재 구현의 성공 분기는 항상 false를 반환합니다.
idstring영향을 받는 플랫폼 방화벽 식별자이며, 작업에서 허용하면 system일 수 있습니다.