文档首页/ 弹性云服务器 ECS/ API参考/ API(推荐)/ 网卡管理/ 更新云服务器指定网卡属性
更新时间: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

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

表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"
}

返回值

请参考通用请求返回值

错误码

请参考错误码