ModifyInstanceVncPasswd

Last Updated: Dec 11, 2017

Description

When modifying the Web management terminal password of ECS instance, consider the following:

  • The password must be at least 6 characters in length and:
    • Can contain uppercase or lowercase English letters.
    • Can contain digits.
    • Cannot contain special characters.
  • After you change the password, for I/O Optimized instances, the password takes effect immediately; for non-I/O Optimized instances, you must restart the instance on the console or API to make the change take effect.

Request parameters

Name Type Required Description
Action String Yes Value: ModifyInstanceVncPasswd.
RegionId String Yes The region of the ECS instance.
InstanceId String Yes The ECS instance.
VncPassword String Yes The VNC password of the ECS instance.

Response parameters

All parameters are common response parameters. For more information, see Common parameters.

Error codes

Error code Error message HTTP status code Meaning
InvalidRegionId.NotFound The specified RegionId does not exist. 404 The specified RegionId does not exist.
MissingParameter The input parameter InstanceId that is mandatory for processing this request is not supplied. 400 You must specify the parameter InstanceId.
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 The current status of the resource does not support this operation.
InternalError The request processing has failed due to some unknown error. 500 The request processing has failed due to some unknown error.
IncorrectVncPassword.Malformed The specified parameter VncPassword is not valid. 400 The specified parameter VncPassword is invalid.

Examples

Request example

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceVncPasswd
  2. &DescribeInstanceVncUrl
  3. &InstanceId=AY121018033933eae8689
  4. &VncPassword=123456
  5. &<public request parameters>

Response example

XML format

  1. <ModifyInstanceVncPasswdResponse>
  2. <RequestId>FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC</RequestId>
  3. </ModifyInstanceVncPasswdResponse>

JSON format

  1. {
  2. "RequestId": "FDB6C963-9CE8-4B7F-BCA3-845F6BD29AFC",
  3. }
Thank you! We've received your feedback.