590
阿里云
修改实例 VPC 属性__实例相关接口_API 参考_云服务器 ECS-阿里云
描述
修改云服务器实例的 VPC 属性。
- 指定 VSwitchId 修改 VPC 属性时,指定的 VSwitchId,必须属于当前的专有网络。
- 指定实例的当前交换机和新的交换机必须要属于同一个可用区。
- 指定 VSwitchId 不指定 PrivateIpAddress 时,系统自动为云服务器实例分配一个空闲的私网 IP。
- 同时指定 VSwitchId 和 PrivateIpAddress 时,私网 IP 要属于指定交换机的网段。
- PrivateIpAddress 依赖于 VSwitchId,不能单独指定 PrivateIpAddress。
- 进行修改操作的云服务器实例必须是 Stopped 状态,新创建的云服务器实例必须要经过一次启动 / 停止才能更改所属的交换机。
请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
Action | String | 是 | 系统规定参数,取值:ModifyInstanceVpcAttribute |
InstanceId | String | 是 | 指定的实例 ID |
VSwitchId | String | 是 | 新的交换机 ID,不能跨可用区修改实例的交换机 |
PrivateIpAddress | String | 否 | 新的私网 IP 地址,不能单独指定 |
返回参数
全是公共返回参数,详见公共返回参数
错误码
错误代码 | 描述 | Http 状态码 | 语义 |
---|---|---|---|
InvalidVSwitchId.NotFound | Specified virtual switch does not exist. | 404 | 指定的交换机 ID 不存在 |
InvalidVSwitchId.Mismatch | Specified instance and virtual switch are not in the same zone. | 400 | 指定的实例和指定的交换机不属于同一个可用区 |
InvalidInstanceId.NotFound | Specified instance does not exist. | 404 | 指定的 ECS 实例不存在 |
InvalidPrivateIpAddress.Mismatch | Specified private IP address is not in the CIDR block of virtual switch. | 400 | 指定的私网 IP 不在指定交换机的网段中 |
InvalidPrivateIpAddress.Malformed | Specified private IP address is malformed. | 400 | 指定的私有 IP 不合法 |
InvalidPrivateIpAddress.Duplicated | Specified private IP address is duplicated. | 400 | 指定的私网 IP 已经被使用 |
InvalidPrivateIp.Changing | Previous action is not finished yet. | 400 | 实例修改私网 IP 为完成,不能再进行在修改 |
InvalidVSwitchId.NotFound | Specified virtual switch is not found in current VPC. | 404 | 不能跨 VPC 修改实例的交换机。 |
IncorrectInstanceStatus | The current status of instance does not support this operation. | 400 | 不在已停止状态的实例不能进行此操作。 |
OperationDenied | Specified operation is denied as your instance is not in VPC. | 400 | 实例不是 VPC 类型 |
InvalidPrivateIp.Changing | Specified private IP address is not in the CIDR block of virtual switch. | 400 | 实例正在修改私网 IP 过程中(实例一次 stop 只能修改一次私网 IP) |
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
&VSwitchId=[vswitchid]
&<公共请求参数>
返回示例
XML
格式
<ModifyInstanceAttributeResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
最后更新:2016-11-23 17:08:34
上一篇:
修改实例属性__实例相关接口_API 参考_云服务器 ECS-阿里云
下一篇:
查询实例状态__实例相关接口_API 参考_云服务器 ECS-阿里云
自适应方向__图片旋转_图片处理指南_对象存储 OSS-阿里云
HTTPS证书报错__错误说明_API 网关-阿里云
RAM初始设置__快速入门_访问控制-阿里云
更换操作系统__实例_用户指南_云服务器 ECS-阿里云
开通表格存储服务__快速入门_表格存储-阿里云
云虚拟主机安装 ECShop__程序安装_使用指南_云虚机主机-阿里云
事件通知__开发人员指南_消息服务-阿里云
SetAccountAlias__安全设置接口_RAM API文档_访问控制-阿里云
云服务器 ECS复制镜像
云邮箱Outlook 2007 POP3/IMAP协议设置方法__客户端使用_邮箱常见问题_企业邮箱-阿里云
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云