ModifyInstanceVncPasswd

Last Updated: Sep 18, 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 need to 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.

Return parameters

All parameters are public return parameters. For details, see Public Return Parameters.

Error codes

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

Examples

Request example

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

Return 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.