文档首页/ 弹性云服务器 ECS/ API参考/ API/ 网卡管理/ 更新云服务器指定网卡属性
更新时间：2024-06-19 GMT+08:00
查看PDF
分享

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

功能介绍

更新云服务器指定网卡属性，当前仅支持更新网卡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

参数说明请参见表 参数说明。

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

server_id

是

云服务器ID。

port_id

是

网卡ID。

请求消息

请求参数如表 请求参数所示。

表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不能同时指定。

响应消息

响应参数如表 响应参数所示。

表3 响应参数

参数

参数类型

描述

id

String

网卡ID。

subnet_id

String

子网ID。

ip_address

String

网卡IPv4地址。

ipv6_address

String

网卡IPv6地址，未开通IPv6协议的网卡不返回该字段。

请求示例

  • 更新云服务器网卡，并指定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"
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 网卡管理

相关文档