切换VPC

接口说明

本接口用于切换VPC。
说明:

  1. 目标子网必须与云主机处于同一可用区。
  2. 必须统一协议栈类型。切换不同的VPC下的网卡,只能相同子网类型才可更换,如单栈IPv4只能与单栈IPv4更换,同理双栈也是一样。

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/replaceVpc

请求参数

Body

参数名称
类型
必填
描述
replaceVpcReq
ReplaceVpcReq
是

切换VPC请求体。

newPortId
string
是

需要绑定的主机网卡ID,您可通过查询虚拟网卡列表获取。

oldPortId
string
是

需要解绑的主机网卡ID,您可以通过查询云主机详情获取。

securityGroupIds
<string> array
否
serverId
string
是

需要绑定的主机实例ID,您可通过主机列表详情接口获取。

vpcId
string
是

目标VPC的ID,您可通过分页查询VPC列表获取。

请求示例

POST https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/replaceVpc
{
	"newPortId":"479b1deb-e65f-4841-a3e6-9c274f97b5ac",
	"oldPortId":"9d1dffcd-d891-4073-a838-fc2b9c745a87",
	"vpcId":"8235ff72589a4d78b971a521cceda9a1",
	"serverId":"166ddb4b-bf11-47c7-8dab-562872655e08"
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
boolean

请求成功时返回的数据

errorCode
string

统一错误码

errorMessage
string

页面国际化错误提示

errorParams
<string> array

统一错误码的自定义参数

requestId
string

每个请求的序列号

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN

返回示例

返回码:200
OK
{
	"requestId":"reqId-49b078faacbc1dc85d66c-a156faae-6-g",
	"state":"OK",
	"body":true
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。