ovahub查詢伺服器私有網路
/api/v1/servers/:id/networks
讀取目前組織伺服器及其實體執行個體的最多 100 筆本地連接埠記錄。伺服器不存在、已刪除或已轉移時回傳 404。無法確認實體身分時回傳 409。沒有記錄不代表已隔離或已停止計費。
呼叫前請注意
僅讀取本機資料，不呼叫供應商、不計費也不寫入。所有 capabilities 均為 false；地區或供應商相同不代表相容或可安全連接。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
curl "https://tovahub.com/api/v1/servers/undefined/networks" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
{
"serverId": "507f1f77bcf86cd799439013",
"ports": [],
"nextCursor": null,
"testOnly": false,
"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."
}
}參數
id路徑 · 必填string
目前組織的伺服器 ID：24 位十六進位字元。無法存取已刪除或已移轉的伺服器。
after查詢字串 · 選填string
選填，使用 nextCursor 回傳的 24 個十六進位字元連接埠游標。回傳大於此游標的連接埠 ID，每頁最多 100 筆；null 表示沒有下一頁。
回應
HTTP 狀態 200
讀取目前組織伺服器及其實體執行個體的最多 100 筆本地連接埠記錄。伺服器不存在、已刪除或已轉移時回傳 404。無法確認實體身分時回傳 409。沒有記錄不代表已隔離或已停止計費。
serverIdstring目前組織的伺服器 ID：24 位十六進位字元。無法存取已刪除或已移轉的伺服器。
testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
portsobject[]讀取目前組織伺服器及其實體執行個體的最多 100 筆本地連接埠記錄。伺服器不存在、已刪除或已轉移時回傳 404。無法確認實體身分時回傳 409。沒有記錄不代表已隔離或已停止計費。
ports[].idstring平台識別碼，並非供應商識別碼。
ports[].slotinteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].serverIdstring目前組織的伺服器 ID：24 位十六進位字元。無法存取已刪除或已移轉的伺服器。
ports[].activeboolean已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].reservationStatestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].connectionStatestring連線及 IP 資料須有相符的組織網路與有效且不在未來的核查時間。否則 connectionState 為 unknown，checkedAt/privateIps 為 null。這些僅是本地快照。
ports[].privateIpsstring[] | null連線及 IP 資料須有相符的組織網路與有效且不在未來的核查時間。否則 connectionState 為 unknown，checkedAt/privateIps 為 null。這些僅是本地快照。
ports[].checkedAtstring | null連線及 IP 資料須有相符的組織網路與有效且不在未來的核查時間。否則 connectionState 為 unknown，checkedAt/privateIps 為 null。這些僅是本地快照。
ports[].versioninteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
ports[].networkobject | null組織擁有的網路快照，欄位同 list_networks。網路無法取得，或測試情境與伺服器或連接埠不同時為 null。
ports[].network.cidrstring | null已記錄的私有網路CIDR；尚未觀測時為null。
ports[].network.boundServersinteger | null目前組織所擁有實體伺服器的有效綁定數；資料不一致時為null。
ports[].network.occupiedPortsinteger | null本地有效占位數，包含預留及移出中的名額；占用資料不一致時為null。
ports[].network.idstring平台識別碼，並非供應商識別碼。
ports[].network.providerstring已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.namestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.regionstring已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.dataCenterstring | null已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.capacityinteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.statestring已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.versioninteger已儲存的本機快照值，並非已驗證的供應商即時狀態。
ports[].network.monthlyPricestring美元美分整數字串，並非美元金額；顯示價格不代表可付款。
ports[].network.serviceFromstring (ISO 8601) | null服務僅在購買確證完成後開始；未知時為 null。
ports[].network.serviceUntilstring (ISO 8601) | null平台已付服務的截止時間，與供應商已付日期獨立；未知時為 null。
ports[].network.autoRenewboolean僅為續約意向，不證明已付款或已延長服務期。
ports[].network.accessStatestring儲存的本機網路存取狀態：active、stopping、stopped、restoring 或 unknown，不代表目前供應商連線已通過驗證。
ports[].network.currency"USD"固定幣別 USD、價格單位 cent；若有計費週期則為 month。
ports[].network.priceUnit"cent"固定幣別 USD、價格單位 cent；若有計費週期則為 month。
ports[].network.checkedAtstring | null快照檢查時間（ISO 8601），未知時為 null。有時間戳記不代表即時驗證。
ports[].network.testOnlybooleantrue 僅表示測試情境，也可能包含已購買的真實伺服器；不證明為模擬資料，也不會略過計費或安全檢查。
ports[].network.source"local"固定為 local；不向供應商發送即時請求。
ports[].network.verification"unknown" | "snapshot"有 checkedAt 時為 snapshot，否則為 unknown。兩者均不驗證供應商目前狀態。
ports[].network.capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。
nextCursorstring | null選填，使用 nextCursor 回傳的 24 個十六進位字元連接埠游標。回傳大於此游標的連接埠 ID，每頁最多 100 筆；null 表示沒有下一頁。
source"local"固定為 local；不向供應商發送即時請求。
verification"unknown"固定為 unknown；本機結果為空並非供應商端不存在的證明。
capabilitiesobject九個旗標 purchase、attach、disconnect、remove、reconnect、cancelAddon、renew、resize、delete 均為 false。供應商能力尚未核實，核實前不開放計費；快照無法證明相容性或安全連接。