GETBearer 權杖
查詢伺服器詳情
/api/v1/servers/:id
查詢伺服器詳細資料,不包含登入憑證。回傳的 instanceId 是供應商 ID,不是 API 路徑使用的平台 ID。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例,此頁不會發送 API 請求。
參數
id路徑 · 必填string
資源 ID:24 個十六進位字元。請使用對應列表端點回傳的平台 ID,而非供應商的執行個體 ID。
回應
HTTP 狀態 200
讀取平台儲存的伺服器詳細資料,不回傳登入憑證。
testOnlyboolean此伺服器是否為隔離測試資源。
testUntilstring (ISO 8601) | null測試資源到期時間(若有)。
supplierPaidThroughstring (ISO 8601) | null伺服器儲存的 expiresAt 值,沿用此歷史欄位名稱回傳。
instanceIdstring供應商執行個體識別碼,不是平台伺服器的 ObjectId。
namestring儲存的主機名稱,或空字串。
statusstring儲存的伺服器狀態。
previewboolean此伺服器是否為唯讀預覽。
regionstring地區顯示名稱;無名稱時使用代碼。
dataCenterstring目前為長破折號佔位字元。
productstring儲存的產品名稱;無名稱時顯示長破折號。
cpunumber儲存的 CPU 數量,或零。
memoryMbnumber儲存的記憶體容量(MB),或零。
diskMbnumber儲存的磁碟容量(MB),或零。
operatingSystemstring儲存的作業系統名稱或識別碼;無資料時顯示長破折號。
imageIdnull目前的平台詳細資料讀取流程不會填入此欄位。
ipv4string | null儲存的 IPv4 地址(若有)。
ipv6string | null儲存的 IPv6 地址(若有)。
macAddressstring儲存的 MAC 地址,或空字串。
createdAtstring (ISO 8601) | null儲存的購買建立時間(若有)。
additionalIpsnull目前的平台詳細資料讀取流程不會填入此欄位。
privateNetworksnull目前的平台詳細資料讀取流程不會填入此欄位。
firewallsnull請透過 get_server_resources 讀取防火牆關聯。