九游平台/ 弹性云服务器 ecs/ api参考/ api/ 网卡管理/ 更新云服务器指定网卡属性
更新时间：2024-06-19 gmt 08:00
查看pdf

更新云服务器指定网卡属性-九游平台

功能介绍

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

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 网卡管理

相关文档

网站地图