修改實例屬性__實例相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

修改實例密碼、實例名稱、安全組等屬性信息。

此操作隻修改參數中顯式指定了的屬性，沒有指定的屬性將不會發生改變。
重置實例的密碼，狀態為 Deleted 或 Starting 的實例不可以進行此操作。重置密碼需要在控製台或使用OPENAPI重啟實例後才能生效，在實例內部的重啟將不會生效。
被安全控製在實例的 OperationLocks 中標記了 "LockReason" : "security"的鎖定狀態時，不能修改密碼。

名稱	類型	是否必須	描述
Action	String	是	係統規定參數，取值：ModifyInstanceAttribute
InstanceId	String	是	指定的實例 ID
InstanceName	String	否	實例的顯示名稱，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，”.”，”_“或”-“。不能以 https:// 和 https:// 開頭。
Description	String	否	實例的描述，[2, 256] 個字符。實例描述會顯示在控製台。默認為空。不能以 https:// 和 https:// 開頭。
Password	String	否	重置為用戶指定的密。8-30個字符，必須同時包含三項（大、小寫字母，數字和特殊符號）。支持以下特殊字符：( ) ` ~ ! @ # $ % ^ & * - + = \| { } [ ] : ; ‘ < > , . ? / 如果傳入 Password 參數，請務必使用 HTTPS 協議調用 API 以避免可能發生的密碼泄露。
HostName	String	否	表示操作係統內部的計算機名，最少 2 字符，”.”和”-“是不能作為 hostname 的首尾字符，不能連續使用。 Windows 平台最長為 15 字符，允許字母（不限製大小寫）、數字和”-“組成，不支持點號（”.”），不能全是數字。其他（Linux 等）平台最長為 30 字符，允許支持多個點號，點之間為一段，每段允許字母（不限製大小寫）、數字和”-“組成。

全是公共返回參數，詳見公共返回參數

錯誤代碼	描述	Http 狀態碼	語義
InvalidInstanceId.NotFound	The InstanceId provided does not exist in our records.	404	指定的 InstanceId 不存在
MissingParameter	The input parameter “InstanceId” that is mandatory for processing this request is not supplied.	400	缺少 InstanceId 值
InvalidInstanceName.Malformed	The specified parameter “InstanceName” is not valid.	400	指定的 InstanceName 格式不合法
InvalidDescription.Malformed	The specified parameter “Description” is not valid.	400	指定的 Description 格式不合法
InvalidHostPassword.Malformed	The specified parameter “Password” is not valid.	400	指定的 Password 格式不合法
InvalidHostName.Malformed	The specified parameter “HostName” is not valid.	400	指定的 HostName 格式不合法
IncorrectInstanceStatus	The current status of the resource does not support this operation.	403	該資源目前的狀態不支持此操作
InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	403	該資源目前被安全鎖定被拒絕操作

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
&InstanceId=i-instance1
&Password=pwd
&<公共請求參數>

XML格式

<ModifyInstanceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

最後更新：2016-11-23 16:03:50