문서 본문으로 이동
문서API 참조새 서버의 프라이빗 네트워크 확인
GETBearer 토큰

새 서버의 프라이빗 네트워크 확인

/api/v1/networks/:id/order-check

조직의 네트워크와 로컬 Contabo 요금제를 비교하고 활성 로컬 슬롯을 계산합니다. 네트워크나 요금제가 없으면 404를 반환합니다. 견적, 예약 또는 호환성 보장이 아닙니다.

호출 전 확인

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

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

요청 예시

cURL
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/order-check?planId=V153&region=EU" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

응답 예시
JSON
{
  "networkId": "507f1f77bcf86cd799439011",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "testOnly": true,
  "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."
  },
  "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment.",
  "planId": "V153",
  "region": "EU",
  "networkState": "ready",
  "verification": "unknown",
  "capacity": {
    "total": 5,
    "localOccupied": 2,
    "localRemaining": 3,
    "networkVersion": 1,
    "verification": "snapshot"
  },
  "compatibility": "unknown",
  "supplierCost": "unknown",
  "reserved": false
}

매개변수

id경로 · 필수

string

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

planId쿼리 · 필수

string

로컬 Contabo 요금제 ID: 영문자, 숫자, 밑줄 또는 하이픈 1–100자입니다. 공급자 카탈로그를 요청하지 않습니다.

region쿼리 · 필수

string

로컬 요금제 지역: 영문자, 숫자, 밑줄 또는 하이픈 2–40자입니다. 공급자, 요금제 및 지역 조합이 로컬에 정확히 일치해야 합니다.

응답

HTTP 상태 200

조직의 네트워크와 로컬 Contabo 요금제를 비교하고 활성 로컬 슬롯을 계산합니다. 네트워크나 요금제가 없으면 404를 반환합니다. 견적, 예약 또는 호환성 보장이 아닙니다.

networkIdstring

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

planIdstring

로컬 Contabo 요금제 ID: 영문자, 숫자, 밑줄 또는 하이픈 1–100자입니다. 공급자 카탈로그를 요청하지 않습니다.

regionstring

로컬 요금제 지역: 영문자, 숫자, 밑줄 또는 하이픈 2–40자입니다. 공급자, 요금제 및 지역 조합이 로컬에 정확히 일치해야 합니다.

source"local"

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

regionMatchboolean

로컬 비교일 뿐이며 true가 호환성이나 안전한 연결을 입증하지 않습니다.

providerMatchboolean

로컬 비교일 뿐이며 true가 호환성이나 안전한 연결을 입증하지 않습니다.

networkStatestring

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

verification"unknown"

항상 unknown입니다. 제품 및 데이터 센터 호환성, 공급자 용량, 부가 서비스 필요 여부 및 비용은 확인되지 않았습니다.

capacityobject

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

capacity.totalinteger | null

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

capacity.localOccupiedinteger | null

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

capacity.localRemaininginteger | null

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

capacity.networkVersioninteger | null

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

capacity.verification"snapshot" | "unknown"

로컬 용량만 표시합니다. total은 알려진 카탈로그 크기 또는 null입니다. 연결이 끊긴 슬롯을 포함한 모든 활성 reserved, assigned 및 releasing 슬롯을 계산합니다. 데이터 손상, 용량 초과 또는 네트워크 버전 변경 시 두 수치는 모두 null입니다. 스냅샷은 슬롯을 예약하거나 공급자 용량을 입증하지 않습니다.

compatibility"unknown"

항상 unknown입니다. 제품 및 데이터 센터 호환성, 공급자 용량, 부가 서비스 필요 여부 및 비용은 확인되지 않았습니다.

supplierCost"unknown"

항상 unknown입니다. 제품 및 데이터 센터 호환성, 공급자 용량, 부가 서비스 필요 여부 및 비용은 확인되지 않았습니다.

eligiblefalse

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

reservedfalse

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

testOnlyboolean

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

capabilitiesobject

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

blockedReasonstring

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