修改一台 ECS 執行個體的 Web 管理終端 密碼。
描述
- 密碼長度必須是 6 位字元,只支援大小寫英文字母和阿拉伯數字。
- 修改密碼後:
- I/O 優化的執行個體,立刻生效,無需重啟執行個體。
- 非I/O優化的執行個體,需要在控制台 重啟執行個體 或者調用 API RebootInstance 才能生效。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:ModifyInstanceVncPasswd |
RegionId | String | 是 | ECS 執行個體所在的地域。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
InstanceId | String | 是 | ECS 執行個體。 |
VncPassword | String | 是 | 新的 ECS 執行個體管理終端串連密碼。 |
返回參數
全是公共返回參數。參閱 公共參數
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=ModifyInstanceVncPasswd
&DescribeInstanceVncUrl
&InstanceId=AY121018033933eae8689
&VncPassword=123456
&<公共請求參數>
返回樣本
XML 格式
<ModifyInstanceVncPasswdResponse>
<RequestId>FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC</RequestId>
</ModifyInstanceVncPasswdResponse>
JSON 格式
{
"RequestId": "FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC",
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
IncorrectVncPassword.Malformed | The specified parameter VncPassword is not valid. | 400 | 指定的參數 VncPassword 不合法,密碼長度必須是 6 位字元,只支援大小寫英文字母和阿拉伯數字。 |
IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 | 指定執行個體的狀態需要處於 運行中(Running )。 |
InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 404 | 指定的 ECS 執行個體不存在。 |
InvalidRegionId.NotFound | The specified RegionId does not exist. | 404 | 指定的 RegionId 不存在。 |