ECS 实例的 VPC 属性应该如何修改
描述
修改 ECS 实例的 VPC 属性。
- 专有网络相关的接口，参见 专有网络 VPC 的 API 参考。
- 指定 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 | The specified InstanceId 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"
}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
