ovahub서버의 프라이빗 네트워크 조회
/api/v1/servers/:id/networks
현재 조직 서버와 물리 인스턴스의 로컬 포트 기록을 최대 100개 조회합니다. 없거나 삭제 또는 이전된 서버는 404를 반환합니다. 물리 식별 정보가 유효하지 않으면 409를 반환합니다. 기록이 없다고 격리나 과금 중지가 확인된 것은 아닙니다.
호출 전 확인
로컬 데이터 읽기 전용이며 공급자 요청, 청구 또는 쓰기를 수행하지 않습니다. 모든 capabilities는 false이며 지역 또는 공급자 일치는 호환성이나 안전한 연결을 보장하지 않습니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/servers/undefined/networks" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
{
"serverId": "507f1f77bcf86cd799439013",
"ports": [],
"nextCursor": null,
"testOnly": false,
"source": "local",
"verification": "unknown",
"capabilities": {
"purchase": false,
"attach": false,
"disconnect": false,
"remove": false,
"reconnect": false,
"cancelAddon": false,
"renew": false,
"resize": false,
"delete": false,
"blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
}
}매개변수
id경로 · 필수string
현재 조직 서버 ID로 24자리 16진수입니다. 삭제되거나 이전된 서버에는 접근할 수 없습니다.
after쿼리 · 선택string
nextCursor에서 받은 24자리 16진수 포트 커서입니다(선택 사항). 이 커서보다 큰 포트 ID를 최대 100개 반환하며 null은 다음 페이지가 없음을 뜻합니다.
응답
HTTP 상태 200
현재 조직 서버와 물리 인스턴스의 로컬 포트 기록을 최대 100개 조회합니다. 없거나 삭제 또는 이전된 서버는 404를 반환합니다. 물리 식별 정보가 유효하지 않으면 409를 반환합니다. 기록이 없다고 격리나 과금 중지가 확인된 것은 아닙니다.
serverIdstring현재 조직 서버 ID로 24자리 16진수입니다. 삭제되거나 이전된 서버에는 접근할 수 없습니다.
testOnlybooleantrue는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.
portsobject[]현재 조직 서버와 물리 인스턴스의 로컬 포트 기록을 최대 100개 조회합니다. 없거나 삭제 또는 이전된 서버는 404를 반환합니다. 물리 식별 정보가 유효하지 않으면 409를 반환합니다. 기록이 없다고 격리나 과금 중지가 확인된 것은 아닙니다.
ports[].idstring공급자 식별자가 아닌 플랫폼 식별자입니다.
ports[].slotinteger저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].serverIdstring현재 조직 서버 ID로 24자리 16진수입니다. 삭제되거나 이전된 서버에는 접근할 수 없습니다.
ports[].activeboolean저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].reservationStatestring저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].connectionStatestring연결 및 IP 데이터에는 일치하는 조직 소유 네트워크와 미래가 아닌 유효한 확인 시각이 필요합니다. 그렇지 않으면 connectionState는 unknown이고 checkedAt/privateIps는 null입니다. 로컬 스냅샷일 뿐입니다.
ports[].privateIpsstring[] | null연결 및 IP 데이터에는 일치하는 조직 소유 네트워크와 미래가 아닌 유효한 확인 시각이 필요합니다. 그렇지 않으면 connectionState는 unknown이고 checkedAt/privateIps는 null입니다. 로컬 스냅샷일 뿐입니다.
ports[].checkedAtstring | null연결 및 IP 데이터에는 일치하는 조직 소유 네트워크와 미래가 아닌 유효한 확인 시각이 필요합니다. 그렇지 않으면 connectionState는 unknown이고 checkedAt/privateIps는 null입니다. 로컬 스냅샷일 뿐입니다.
ports[].versioninteger저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].testOnlybooleantrue는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.
ports[].networkobject | nulllist_networks와 동일한 필드의 조직 소유 네트워크 스냅샷입니다. 네트워크를 사용할 수 없거나 테스트 컨텍스트가 서버 또는 포트와 다르면 null입니다.
ports[].network.cidrstring | null저장된 사설 네트워크 CIDR이며 관측하지 않았으면 null입니다.
ports[].network.boundServersinteger | null현재 조직 소유 물리 서버의 활성 연결 수이며 불일치하면 null입니다.
ports[].network.occupiedPortsinteger | null예약 및 제거 중인 슬롯을 포함한 로컬 활성 점유 수이며 불일치하면 null입니다.
ports[].network.idstring공급자 식별자가 아닌 플랫폼 식별자입니다.
ports[].network.providerstring저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.namestring저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.regionstring저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.dataCenterstring | null저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.capacityinteger저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.statestring저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.versioninteger저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.
ports[].network.monthlyPricestring달러가 아닌 USD 센트 정수 문자열이며 표시 가격이 결제를 활성화하지 않습니다.
ports[].network.serviceFromstring (ISO 8601) | null구매 완료를 확인한 후에만 서비스를 시작하며 알 수 없으면 null입니다.
ports[].network.serviceUntilstring (ISO 8601) | null공급업체의 결제된 기간과 별개인 플랫폼 유료 서비스 종료 시각이며 알 수 없으면 null입니다.
ports[].network.autoRenewboolean자동 갱신 의향일 뿐 결제나 서비스 연장 완료를 증명하지 않습니다.
ports[].network.accessStatestring저장된 로컬 네트워크 접근 상태는 active, stopping, stopped, restoring 또는 unknown입니다. 공급자의 현재 연결을 검증한 결과는 아닙니다.
ports[].network.currency"USD"고정 통화는 USD, 가격 단위는 cent이며 청구 기간이 있으면 month입니다.
ports[].network.priceUnit"cent"고정 통화는 USD, 가격 단위는 cent이며 청구 기간이 있으면 month입니다.
ports[].network.checkedAtstring | null스냅샷 확인 시간(ISO 8601)이며 알 수 없으면 null입니다. 타임스탬프는 실시간 검증을 뜻하지 않습니다.
ports[].network.testOnlybooleantrue는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.
ports[].network.source"local"항상 local이며 공급자에 실시간 요청을 하지 않습니다.
ports[].network.verification"unknown" | "snapshot"checkedAt이 있으면 snapshot, 없으면 unknown입니다. 어느 값도 현재 공급자 상태를 검증하지 않습니다.
ports[].network.capabilitiesobjectpurchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize, delete의 아홉 플래그는 모두 false입니다. 공급업체 기능이 검증되지 않아 검증 전에는 요금을 청구하지 않습니다. 스냅샷은 호환성이나 안전한 연결을 증명하지 않습니다.
nextCursorstring | nullnextCursor에서 받은 24자리 16진수 포트 커서입니다(선택 사항). 이 커서보다 큰 포트 ID를 최대 100개 반환하며 null은 다음 페이지가 없음을 뜻합니다.
source"local"항상 local이며 공급자에 실시간 요청을 하지 않습니다.
verification"unknown"항상 unknown이며 빈 로컬 결과는 공급자 측 부재를 입증하지 않습니다.
capabilitiesobjectpurchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize, delete의 아홉 플래그는 모두 false입니다. 공급업체 기능이 검증되지 않아 검증 전에는 요금을 청구하지 않습니다. 스냅샷은 호환성이나 안전한 연결을 증명하지 않습니다.