更新云服务器指定网卡属性

功能介绍

更新云服务器指定网卡属性，当前仅支持更新网卡IP。

调试

您可以在API Explorer中调试该接口。

接口约束

• 关机状态的弹性云服务器才允许更新指定网卡属性。
• 当前只允许更新弹性云服务器主网卡属性。
• 只开通了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"
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。