更新时间:2024-06-19 GMT+08:00
更新云服务器指定网卡属性
功能介绍
更新云服务器指定网卡属性,当前仅支持更新网卡IP。
接口约束
- 关机状态的弹性云服务器才允许更新指定网卡属性。
- 当前只允许更新弹性云服务器主网卡属性。
- 只开通了IPv4协议的网卡,不支持修改网卡的IPv6地址。
- 只开通了IPv4协议的网卡,不支持跨VPC修改网卡的IPv4地址。
- 已开通IPv6协议的网卡,不支持跨子网修改网卡的IPv4地址和IPv6地址。
- 已开通IPv6协议的网卡,网卡上已绑定共享带宽或虚拟IP,不允许修改网卡的IPv4地址和IPv6地址。
URI
POST /v1/{project_id}/cloudservers/{server_id}/os-interface/{port_id}/change-network-interface
参数说明请参见表 参数说明。
请求消息
请求参数如表 请求参数所示。
响应消息
响应参数如表 响应参数所示。
请求示例
- 更新云服务器网卡,并指定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":"" }
响应示例
{ "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" }
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题: 网卡管理