調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/{project_id}/cloudservers/server-name
請(qǐng)求消息
|
參數(shù) |
參數(shù)類型 |
是否必選 |
描述 |
|---|---|---|---|
|
name |
String |
是 |
彈性云服務(wù)器修改后的名稱。 規(guī)則如下： 只能允許包含中文漢字、大小寫字母、數(shù)字及 "-" 、 "_" 字符，長(zhǎng)度限制在64個(gè)字符以內(nèi)。 批量修改彈性云服務(wù)器名稱時(shí)，名不會(huì)自動(dòng)按序增加數(shù)字尾綴。例如： 三個(gè)ECS的名稱為test_0001，test_0002，test_0003，批量修改彈性云服務(wù)器名稱為develop，則修改后3個(gè)彈性云服務(wù)器名稱為develop，develop，develop。 |
|
dry_run |
Boolean |
否 |
是否只預(yù)檢此次請(qǐng)求。 true：發(fā)送檢查請(qǐng)求，不會(huì)修改云服務(wù)器名稱。檢查項(xiàng)包括是否填寫了必需參數(shù)、請(qǐng)求格式、業(yè)務(wù)限制。如果檢查不通過，則返回對(duì)應(yīng)錯(cuò)誤。如果檢查通過，則返回正常響應(yīng)信息。 響應(yīng)結(jié)構(gòu)請(qǐng)參見 7.5.1 響應(yīng) 所示。 false：發(fā)送正常請(qǐng)求，通過檢查后并且執(zhí)行修改云服務(wù)器名稱的請(qǐng)求。 默認(rèn)值：false |
|
servers |
Array of objects |
是 |
響應(yīng)消息
響應(yīng)參數(shù)請(qǐng)參見 響應(yīng)（批量操作類） 所示。
請(qǐng)求示例
批量修改ID為“260a0917-f7df-4b25-93ac-950da6c6b5d6”和“f6d8df1a-e257-48e2-b617-1dd92ced8c20”的云服務(wù)器的名稱為“new-server-name”。
PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name
{
"name": "new-server-name",
"dry_run": false,
"servers": [
{
"id":"260a0917-f7df-4b25-93ac-950da6c6b5d6"
},
{
"id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20"
}
]
}
響應(yīng)示例
響應(yīng)示例請(qǐng)參見 響應(yīng)（批量操作類）所示。
{
"response": [
{
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
},
{
"id": "516fb98f-46ca-475e-917e-2563e5a8cd12"
}
]
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
