-
接口约束 关机状态的弹性云服务器才允许更新指定网卡属性。 当前只允许更新弹性云服务器主网卡属性。 只开通了IPv4协议的网卡，不支持修改网卡的IPv6地址。 只开通了IPv4协议的网卡，不支持跨VPC修改网卡的IPv4地址。 已开通IPv6协议的网卡，不支持跨子网修改网卡的IPv4地址和IPv6地址。 已开通IPv6协议的网卡，网卡上已绑定共享带宽或虚拟IP，不允许修改网卡的IPv4地址和IPv6地址。
-
请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数 是否必选 参数类型 描述 subnet_id 否 String 子网ID ，UUID格式。更新IPv4地址时，必须指定该参数；更新IPv6地址时，该参数可以不填。 ip_address 否 String IPv4地址，为空字符串时表示随机更新网卡IPv4地址。 约束： 该参数和ipv6_address必须指定一个。 该参数和ipv6_address不能同时指定。 ipv6_address 否 String IPv6地址，为空字符串时表示随机更新网卡IPv6地址。 约束： 该参数和ip_address必须指定一个。 该参数和ip_address不能同时指定。
-
URI POST /v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface 参数说明请参见表 参数说明。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 server_id 是 云服务器ID。 port_id 是 网卡ID。
-
响应示例 {
"id": "6bcb3ac6-c5f7-45a8-b6df-aadc6839c2d9",
"subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab",
"ip_address": "192.168.1.159",
"ipv6_address": "2001:db8:a583:578:192:168:1:159"
}
-
请求示例 更新云服务器网卡，并指定IPv4地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface
{
"subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab",
"ip_address":"192.168.1.159"
} 更新云服务器网卡，随机分配IPv4地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface
{
"subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab",
"ip_address":""
} 更新云服务器网卡，并指定IPv6地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface
{
"subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab",
"ipv6_address":"2001:db8:a583:578:2840:2d9f:27d4:2713"
} 更新云服务器网卡，随机分配IPv6地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface
{
"subnet_id": "7bf939cc-167f-49d5-a933-9cca504210ab",
"ipv6_address":""
}
-
响应示例 {
"interfaceAttachment": {
"port_state": "DOWN",
"fixed_ips": [
{
"subnet_id": "d9cfef77-0151-4c2a-9ed5-d951ada8adf3",
"ip_address": "10.0.1.11"
}
],
"port_id": " ce531f90-199f-48c0-816c-13e38010b442",
"net_id": "0dc714fa-9022-4a03-bb22-9821a396bb9d",
"mac_addr": "fa:16:3e:63:75:b2"
}
}
-
请求示例 为指定云服务器添加一张网卡，Network ID为“3cb9bc59-5699-4588-a4b1-b87f96708bc6”。 POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface
{
"interfaceAttachment" : {
"fixed_ips" : [
{
"ip_address" : "192.168.1.3"
}
],
"net_id" : "3cb9bc59-5699-4588-a4b1-b87f96708bc6"
}
} 为指定云服务器添加一张网卡，Port ID为“ce531f90-199f-48c0-816c-13e38010b442”。 POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface
{
"interfaceAttachment" : {
"fixed_ips" : [
{
"ip_address" : "192.168.1.3"
}
],
"port_id" : "ce531f90-199f-48c0-816c-13e38010b442"
}
}
-
响应消息 响应参数如表5所示。 表5 响应参数 参数 参数类型 描述 interfaceAttachment Object 云服务器网卡信息列表，详情请参见表6。 表6 interfaceAttachment字段数据结构说明 参数 参数类型 描述 port_state String 端口状态。 fixed_ips Array of objects 网卡IP信息列表，请参见表7。 port_id String Port ID。 net_id String Network ID。 mac_addr String Mac地址。 表7 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡所属子网ID。 ip_address String 网卡IP地址。
-
请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 interfaceAttachment 是 Object 需要添加的网卡参数列表，详情请参见表3。 表3 interfaceAttachment字段数据结构说明 参数 是否必选 参数类型 描述 port_id 否 String Port ID。 port_id和net_id不能同时传入。 net_id 否 String Network ID。 port_id和net_id不能同时传入。 fixed_ips 否 Array of objects 私有IP。 使用port_id时，不能指定该参数。 该参数必须与net_id配合使用。 只有列表中第一个元素有效。传入两个及以上元素会报错。详情请参见表4。 表4 fixed_ips字段数据结构说明 参数 是否必选 参数类型 描述 ip_address 否 String IP地址。
-
请求示例 为云服务器切换VPC，添加网卡、安全组并指定IP地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changevpc
{
"vpc_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"nic": {
"subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"security_groups": [
{
"id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
}
],
"ip_address": "192.168.255.1"
}
}
-
功能介绍 云服务器切换虚拟私有云。 本接口为异步接口，当前云服务器切换虚拟私有云请求下发成功后会返回job_id，此时云服务器切换虚拟私有云并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUC
CES S 时代表云服务器虚拟私有云切换成功。 切换虚拟私有云会卸载当前主网卡，用新指定的虚拟私有云创建主网卡。 若原主网卡绑定有弹性IP，则会将弹性IP绑定到新创建的主网卡上。 切换虚拟私有云会导致云服务器网络中断，同时更改云服务器子网、IP地址、MAC地址。 虚拟私有云切换完成后，与网络配置相关的应用软件需要重新配置。与网络相关的服务也需要重新配置，例如ELB、VPN、NAT、DNS等。 切换虚拟私有云过程中，请勿操作云服务器的弹性IP，或对云服务器做其他操作。
-
请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 vpc_id 是 String 虚拟机私有云ID ，UUID格式。 nic 是 Object 需要添加的网卡参数列表，详情请参见表3。 表3 nic字段数据结构说明 参数 是否必选 参数类型 描述 port_id 否 String 网卡ID，UUID格式。 当该字段不为空时，表示挂载指定的网卡。 说明： port_id和subnet_id不能同时为空。 网卡ID可以通过虚拟私有云的“查询端口列表”接口查询。 约束： 网卡必须带有安全组。 网卡状态必须为DOWN。 网卡的vpcid必须和传入的vpcid一致。 当port_id和subnet_id同时存在的时候，优先使用port_id。 当选择port_id不为空时，代表此时使用的是弹性网卡，此时security_groups和ip_address等参数不生效。 subnet_id 否 String 云服务器添加网卡的信息。 需要指定云服务器所属虚拟私有云下已创建的网络（network）的ID，UUID格式。 security_groups 否 Array of objects 添加网卡的安全组信息，详情请参见表4。 ip_address 否 String IP地址，无该参数表示自动分配IP地址。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。
-
请求示例 添加网络ID为“d32019d3-bc6e-4319-9c1d-6722fc136a23”，安全组ID为“f0ac4394-7e4a-4409-9701-ba8be283dbc3”的网卡至云服务器。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics
{
"nics": [
{
"subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"security_groups": [
{
"id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
}
]
}
]
}
-
请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 nics 是 Array of objects 需要添加的网卡参数列表，详情请参见表3。 表3 nics字段数据结构说明 参数 是否必选 参数类型 描述 subnet_id 否 String 云服务器添加网卡的信息。 需要指定已创建的网络（network）的ID，UUID格式。 security_groups 否 Array of objects 添加网卡的安全组信息，详情请参见表4。 ip_address 否 String IP地址，无该参数表示自动分配IP地址。 port_id 否 String 网卡ID，UUID格式。 当该字段不为空时，表示挂载指定的网卡。port_id和subnet_id不能同时为空。 网卡ID可以从虚拟私有云的“查询端口列表”章节查询到。 约束： 网卡状态必须为DOWN 当port_id和subnet_id同时存在的时候，优先使用port_id。 当选择port_id不为空时，代表此时使用的是弹性网卡，此时security_groups和ip_address等参数不生效。 ipv6_enable 否 Boolean 是否支持ipv6。 取值为true时，标识此网卡支持ipv6。 ipv6_bandwidth 否 Object 绑定的共享带宽信息，详情请参见ipv6_bandwidth字段数据结构说明。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。
-
响应参数 参数 参数类型 描述 interfaceAttachments Array of objects 裸金属服务器网卡信息列表，详情请参见表2。 表2 interfaceAttachments字段数据结构说明 参数 参数类型 描述 port_state String 网卡端口状态。取值为：ACTIVE、BUILD、DOWN fixed_ips Array of objects 网卡私网IP信息列表，详情请参见表3。 net_id String 网卡端口所属子网的网络ID（network_id）。 port_id String 网卡端口ID。 mac_addr String 网卡MAC地址信息。 driver_mode String 从guest os中，网卡的驱动类型。可选值为virtio和hinic，默认为virtio。 pci_address String 弹性网卡在Linux GuestOS里的BDF号。 表3 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网的子网ID（subnet_id）。 ip_address String 网卡私网IP信息。
