调用UpdateInstanceAttribute修改一台轻量应用服务器的部分信息,包括服务器名称、密码。
接口说明
修改密码后,您需要重新启动(RebootInstance)服务器才能生效。
QPS限制
本接口的单用户QPS限制为10次/分钟。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| InstanceId | String | 是 | ace0706b2ac4454d984295a94213**** |
指定的轻量应用服务器的实例ID。 |
| RegionId | String | 是 | cn-hangzhou |
指定的轻量应用服务器所属的地域ID。 |
| Password | String | 否 | Test123! |
新的服务器密码。支持8~30个字符,必须同时包含大写字母、小写字母、数字或特殊字符中的三项。仅支持下列特殊字符: ()~!@#$%^&*-+=|{}[]:;<>,.?/
|
| InstanceName | String | 否 | test-InstanceName |
服务器名称。长度为2~128个字符,必须以大小写字母或中文开头,不能以 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
| Action | String | 是 | UpdateInstanceAttribute |
系统规定参数。取值:UpdateInstanceAttribute。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 20758A-585D-4A41-A9B2-28DA8F4F534F |
请求ID。 |
示例
请求示例
https://swas.cn-hangzhou.aliyuncs.com/?Action=UpdateInstanceAttribute
&InstanceId=2ad1ae67295445f598017499dc****
&InstanceName=test-InstanceName
&Password=Test123!
&<公共请求参数>
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateInstanceAttributeResponse>
<RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
</UpdateInstanceAttributeResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidPassword.ValueNotSupported | The specified parameter Password is invalid. | 指定的实例密码不合法。 |
| 400 | InvalidInstanceName.ValueNotSupported | The specified parameter InstanceName is invalid. | 指定的实例名称不合法。 |
| 400 | RegionIdNotMatchHost | The parameter regionId does not match the endpoint host. | 传入的regionId和请求的地址不匹配。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在,请您检查实例ID是否正确。 |
| 500 | InternalError | An error occurred while processing your request. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |
访问错误中心查看更多错误码。