새 서버의 프라이빗 네트워크 확인
/api/v1/networks/:id/order-check
조직의 네트워크와 로컬 Contabo 요금제를 비교하고 활성 로컬 슬롯을 계산합니다. 네트워크나 요금제가 없으면 404를 반환합니다. 견적, 예약 또는 호환성 보장이 아닙니다.
호출 전 확인
로컬 데이터 읽기 전용이며 공급자 요청, 청구 또는 쓰기를 수행하지 않습니다. 모든 capabilities는 false이며 지역 또는 공급자 일치는 호환성이나 안전한 연결을 보장하지 않습니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/order-check?planId=V153®ion=EU" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
{
"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이며 지역 또는 공급자 일치는 호환성이나 안전한 연결을 보장하지 않습니다.
testOnlybooleantrue는 테스트 상황만 나타내며 실제 구매한 서버도 포함할 수 있습니다. 시뮬레이션을 입증하거나 청구 또는 안전 검사를 우회하지 않습니다.
capabilitiesobjectpurchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize, delete의 아홉 플래그는 모두 false입니다. 공급업체 기능이 검증되지 않아 검증 전에는 요금을 청구하지 않습니다. 스냅샷은 호환성이나 안전한 연결을 증명하지 않습니다.
blockedReasonstring로컬 데이터 읽기 전용이며 공급자 요청, 청구 또는 쓰기를 수행하지 않습니다. 모든 capabilities는 false이며 지역 또는 공급자 일치는 호환성이나 안전한 연결을 보장하지 않습니다.