跳至文檔內容
開發者文檔API 參考重新命名伺服器
POSTBearer 權杖

重新命名伺服器

/api/v1/servers/:id/name

修改組織伺服器的顯示名稱。

API 欄位名稱、型別與程式碼在所有語言中保持原樣。

請求範例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/name" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "name": "my-server"
}'

僅提供範例,此頁不會發送 API 請求。

回應示例
JSON
{
  "ok": true,
  "name": "Production web"
}

參數

id路徑 · 必填

string

24 個字元的平台 ID;若代表訂單預留項目,可加上 order- 前綴。

nameJSON 請求主體 · 必填

string

去除頭尾空白後的顯示名稱,1–80 個字元;不接受控制字元。

回應

HTTP 狀態 200

儲存平台顯示名稱,不會變更供應商的主機名稱。

okboolean (true)

顯示名稱已儲存。

namestring

儲存的名稱。