GETBearer 토큰

프라이빗 네트워크 연결 검사

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

소유 네트워크와 현재 조직의 삭제되지 않은 서버의 로컬 지역 및 공급자 데이터를 비교합니다. 없거나 소유하지 않은 리소스는 404를 반환합니다. 이 검사는 연결을 허가하지 않습니다.

호출 전 확인

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

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

요청 예시

cURL

curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/attach-check?serverId=507f1f77bcf86cd799439013" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

응답 예시

JSON

{
  "networkId": "507f1f77bcf86cd799439011",
  "serverId": "507f1f77bcf86cd799439013",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "requiresRestart": "unknown",
  "requiresReinstall": "unknown",
  "ipChange": "unknown",
  "addon": {
    "state": "unknown",
    "checkedAt": null,
    "cancelEffectiveAt": null,
    "verification": "unknown"
  },
  "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."
}

매개변수

id경로 · 필수

string

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

serverId쿼리 · 필수

string

현재 조직 서버 ID로 24자리 16진수입니다. 삭제되거나 이전된 서버에는 접근할 수 없습니다.

응답

HTTP 상태 200

networkIdstring

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

serverIdstring

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

source"local"

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

regionMatchboolean

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

providerMatchboolean

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

eligiblefalse

requiresRestart"unknown"

항상 unknown이며 재시작, 재설치 및 IP 변경 영향은 검증되지 않았습니다.

requiresReinstall"unknown"

항상 unknown이며 재시작, 재설치 및 IP 변경 영향은 검증되지 않았습니다.

ipChange"unknown"

항상 unknown이며 재시작, 재설치 및 IP 변경 영향은 검증되지 않았습니다.

addonobject

서버 소유권 확인 후의 로컬 추가 서비스 스냅샷입니다. 유효한 checkedAt이 없으면 state는 unknown, 두 시간은 null, verification은 unknown입니다. 확인된 스냅샷의 verification은 snapshot이며 cancel_pending은 취소 완료나 다음 청구 면제를 입증하지 않습니다.

addon.statestring

addon.checkedAtstring | null

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

addon.cancelEffectiveAtstring | null

addon.verification"unknown" | "snapshot"

testOnlyboolean

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

capabilitiesobject

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

blockedReasonstring

요청과 오류 인증 MCP · check_network_attach

프라이빗 네트워크 연결 검사

요청 예시

매개변수#

응답#

관련 항목#

매개변수

응답

관련 항목