GETBearer 토큰

프라이빗 네트워크 상세 조회

/api/v1/networks/:id

소유한 로컬 네트워크와 ID순으로 최대 100개 포트 스냅샷을 조회합니다. 없거나 다른 조직 소유인 네트워크는 404를 반환합니다. 빈 로컬 포트는 공급자 측 부재를 확인하지 않습니다.

호출 전 확인

로컬 데이터 읽기 전용이며 공급자 요청, 청구 또는 쓰기를 수행하지 않습니다. 모든 capabilities는 false이며 지역 또는 공급자 일치는 호환성이나 안전한 연결을 보장하지 않습니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL

curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시

JSON

{
  "id": "507f1f77bcf86cd799439011",
  "provider": "contabo",
  "name": "example-network",
  "serviceFrom": null,
  "serviceUntil": null,
  "autoRenew": false,
  "accessState": "unknown",
  "region": "EU",
  "dataCenter": null,
  "capacity": 5,
  "monthlyPrice": "990",
  "currency": "USD",
  "priceUnit": "cent",
  "state": "pending",
  "version": 1,
  "checkedAt": null,
  "testOnly": true,
  "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."
  },
  "portsVerification": "unknown",
  "portsNextCursor": null,
  "ports": [
    {
      "id": "507f1f77bcf86cd799439014",
      "slot": 1,
      "serverId": null,
      "active": true,
      "reservationState": "reserved",
      "connectionState": "unknown",
      "privateIps": null,
      "checkedAt": null,
      "version": 1,
      "testOnly": true
    }
  ],
  "cidr": null,
  "boundServers": 0,
  "occupiedPorts": 0
}

매개변수

id경로 · 필수

string

리소스 ID로, 24자리 16진수 문자열입니다. 공급업체 인스턴스 ID가 아니라 해당 목록 엔드포인트에서 반환한 플랫폼 ID를 사용하세요.

after쿼리 · 선택

string

목록의 nextCursor 또는 상세의 portsNextCursor에서 가져온 선택적 24자리 16진수 커서입니다. 커서보다 큰 ID를 최대 100개 반환하며 null은 다음 페이지가 없음을 뜻합니다.

응답

HTTP 상태 200

idstring

공급자 식별자가 아닌 플랫폼 식별자입니다.

providerstring

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

namestring

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

regionstring

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

dataCenterstring | null

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

cidrstring | null

저장된 사설 네트워크 CIDR이며 관측하지 않았으면 null입니다.

boundServersinteger | null

현재 조직 소유 물리 서버의 활성 연결 수이며 불일치하면 null입니다.

occupiedPortsinteger | null

예약 및 제거 중인 슬롯을 포함한 로컬 활성 점유 수이며 불일치하면 null입니다.

capacityinteger

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

statestring

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

versioninteger

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

monthlyPricestring

달러가 아닌 USD 센트 정수 문자열이며 표시 가격이 결제를 활성화하지 않습니다.

serviceFromstring (ISO 8601) | null

구매 완료를 확인한 후에만 서비스를 시작하며 알 수 없으면 null입니다.

serviceUntilstring (ISO 8601) | null

공급업체의 결제된 기간과 별개인 플랫폼 유료 서비스 종료 시각이며 알 수 없으면 null입니다.

autoRenewboolean

자동 갱신 의향일 뿐 결제나 서비스 연장 완료를 증명하지 않습니다.

accessStatestring

저장된 로컬 네트워크 접근 상태는 active, stopping, stopped, restoring 또는 unknown입니다. 공급자의 현재 연결을 검증한 결과는 아닙니다.

currency"USD"

고정 통화는 USD, 가격 단위는 cent이며 청구 기간이 있으면 month입니다.

priceUnit"cent"

고정 통화는 USD, 가격 단위는 cent이며 청구 기간이 있으면 month입니다.

checkedAtstring | null

스냅샷 확인 시간(ISO 8601)이며 알 수 없으면 null입니다. 타임스탬프는 실시간 검증을 뜻하지 않습니다.

testOnlyboolean

true는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.

source"local"

항상 local이며 공급자에 실시간 요청을 하지 않습니다.

verification"unknown" | "snapshot"

checkedAt이 있으면 snapshot, 없으면 unknown입니다. 어느 값도 현재 공급자 상태를 검증하지 않습니다.

capabilitiesobject

purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize, delete의 아홉 플래그는 모두 false입니다. 공급업체 기능이 검증되지 않아 검증 전에는 요금을 청구하지 않습니다. 스냅샷은 호환성이나 안전한 연결을 증명하지 않습니다.

portsobject[]

portsVerification"unknown"

항상 unknown이며 빈 로컬 결과는 공급자 측 부재를 입증하지 않습니다.

portsNextCursorstring | null

ports[].idstring

공급자 식별자가 아닌 플랫폼 식별자입니다.

ports[].slotinteger

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

ports[].serverIdstring | null

현재 조직 소유의 삭제되지 않은 서버에만 반환합니다. 그 외에는 serverId와 checkedAt이 null, connectionState가 unknown, privateIps가 null입니다.

ports[].activeboolean

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

ports[].reservationStatestring

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

ports[].connectionStatestring

현재 조직 소유의 삭제되지 않은 서버에만 반환합니다. 그 외에는 serverId와 checkedAt이 null, connectionState가 unknown, privateIps가 null입니다.

ports[].privateIpsstring[] | null

소유권이나 확인 시간이 없으면 null입니다. 소유한 미삭제 서버에 checkedAt이 있는 경우에만 []를 포함한 배열을 반환하며 여전히 로컬 스냅샷입니다.

ports[].checkedAtstring | null

현재 조직 소유의 삭제되지 않은 서버에만 반환합니다. 그 외에는 serverId와 checkedAt이 null, connectionState가 unknown, privateIps가 null입니다.

ports[].versioninteger

저장된 로컬 스냅샷 값이며 검증된 공급자 실시간 상태가 아닙니다.

ports[].testOnlyboolean

true는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.

요청과 오류 인증 MCP · get_network

프라이빗 네트워크 상세 조회

요청 예시

매개변수#

응답#

관련 항목#

매개변수

응답

관련 항목