全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

ModifyInstanceAttribute

更新时间:2018-05-16 10:16:04

描述

修改实例部分信息,包括实例密码、名称、描述、主机名和自定义数据等。调用该接口时,您需要注意:

  • 实例状态为 已释放Deleted)或 启动中Starting)时,无法重置实例密码。

  • 安全控制 的实例的 OperationLocks 中标记了 "LockReason" : "security" 时,无法重置实例密码。

  • 重置密码后,您需要在控制台 重启实例 或者调用 RebootInstance 使更改生效,在实例内部重启将不会生效。

  • 实例状态为 已停止Stopped)且满足 实例自定义数据 使用限制时,支持修改自定义数据。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:ModifyInstanceAttribute
InstanceId String 实例 ID。
InstanceName String 实例名称。长度为 [2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,点号(.)、半角冒号(:)、下划线(_)和连字符(-)。不能以 http:// 和 https:// 开头。
Description String 实例描述。长度为 [2, 256] 个字符。不能以 http:// 和 https:// 开头。
默认值:空。
Password String 实例密码。
长度为 [8, 30] 个字符,必须同时包含大小写字母、数字和特殊字符。
特殊字符:( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < < , . ? /
如果传入 Password 参数,您需要使用 HTTPS 调用方式,避免密码泄露。
HostName String 操作系统内部的计算机名。点号(.)和连字符(-)不能作为主机名的首尾字符,也不能连续使用。
Windows 实例:长度为 [2, 15] 个字符,支持字母、数字和连字符(-),不支持点号(.),不能全是数字。
Unix 类实例:长度为 [2, 30] 个字符,允许支持多个点号,点与点之间为一段,每段允许字母、数字和连字符(-)。
UserData String 实例自定义数据,需要以 Base64 编码。编码前,原始数据不能超过 16 KB。
建议不要明文传入敏感信息,例如密码和私钥等。如果必须传入敏感信息,建议您加密后再以 Base64 编码传入,在实例内部以同样的方式反解密。

返回参数

全是公共返回参数。参阅 公共参数

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
  2. &InstanceId=i-instance1
  3. &Password=pwd
  4. &<公共请求参数>

返回示例

XML 格式

  1. <ModifyInstanceAttributeResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ModifyInstanceAttributeResponse>

JSON 格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidDescription.Malformed The specified parameter “Description” is not valid. 400 指定的 Description 格式不正确。
InvalidDescription.Malformed The specified destination image description is wrongly formed. 400 指定的 Description 不合法。
InvalidHostPassword.Malformed The specified parameter “Password” is not valid. 400 指定的 Password 不合法。
InvalidInstanceName.Malformed The specified parameter “InstanceName” is not valid. 400 指定的 InstanceName 不合法。
InvalidHostName.Malformed The specified parameter “HostName” is not valid. 400 指定的 HostName 不合法。
InvalidPassword.Malformed The specified parameter “Password” is not valid. 400 指定的 Password 不合法。
InvalidUserData.SizeExceeded The specified parameter “UserData” exceeds the size. 400 Base64 编码 UserData 前,原始数据不能超过 16 KB。
InvalidUserData.NotSupported The specified parameter “UserData” only support the vpc and IoOptimized Instance. 400 UserData 只适用于 VPC 类型实例和 I/O 优化实例。
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 实例目前被安全锁定,拒绝操作。
OperationDenied The Specified operation is denied as your instance is locked for security reasons. 403 实例已经被锁定。
OperationDenied The current status of the resource does not support this operation. 403 实例状态不支持该操作。
HOSTNAME_ILLEGAL hostname is not valid. 404 指定的 hostname 不合法。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定的 SecurityGroupId 不存在。
本文导读目录