ovahub檢查私有網路連接
/api/v1/networks/:id/attach-check
比較組織擁有的網路與目前未刪除伺服器的本機地區及供應商資料。資源不存在或不屬於組織時回傳 404。此檢查絕不授權連接。
呼叫前請注意
僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
curl "https://tovahub.com/api/v1/networks/507f1f77bcf86cd799439012/attach-check?serverId=507f1f77bcf86cd799439013" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
{
"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 個十六進位字元。請使用對應列表端點回傳的平台 ID，而非供應商的執行個體 ID。
serverId查詢字串 · 必填string
目前組織的伺服器 ID：24 位十六進位字元。無法存取已刪除或已移轉的伺服器。
回應
HTTP 狀態 200
比較組織擁有的網路與目前未刪除伺服器的本機地區及供應商資料。資源不存在或不屬於組織時回傳 404。此檢查絕不授權連接。
networkIdstring平台識別碼，並非供應商識別碼。
serverIdstring平台識別碼，並非供應商識別碼。
source"local"固定為 local；不向供應商發送即時請求。
regionMatchboolean僅比較本機資料；true 不代表相容或可安全連接。
providerMatchboolean僅比較本機資料；true 不代表相容或可安全連接。
eligiblefalse僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
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確認伺服器所有權後讀取的本機附加服務快照。沒有有效 checkedAt 時：state 為 unknown、兩個時間欄位為 null、verification 為 unknown。已檢查的快照之 verification 為 snapshot；cancel_pending 不代表已取消或免除下期費用。
addon.checkedAtstring | null快照檢查時間（ISO 8601），未知時為 null。有時間戳記不代表即時驗證。
addon.cancelEffectiveAtstring | null確認伺服器所有權後讀取的本機附加服務快照。沒有有效 checkedAt 時：state 為 unknown、兩個時間欄位為 null、verification 為 unknown。已檢查的快照之 verification 為 snapshot；cancel_pending 不代表已取消或免除下期費用。
addon.verification"unknown" | "snapshot"確認伺服器所有權後讀取的本機附加服務快照。沒有有效 checkedAt 時：state 為 unknown、兩個時間欄位為 null、verification 為 unknown。已檢查的快照之 verification 為 snapshot；cancel_pending 不代表已取消或免除下期費用。
testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。
blockedReasonstring僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。