文档中心

ModifyNetworkInterfaceAttribute(修改网络接口属性信息)

修改指定网络接口的属性,当前支持修改安全组、子网或者DNS信息。 接口调用可修改一个或多个属性(安全组、子网、DNS、IP)。

特殊场景:如果跨VPC修改子网,SubnetID和SecurityGroupId必须在同一个VPC下

约束条件1:在更换主网卡SubnetId、PrivateIpAddress时,如果网络接口已经绑定EIP、属于SLB的真实服务器或绑定Portforword时,则不允许更改,需要先解绑相应配置。

约束条件2:修改副网卡网络信息时,DNS1和DNS2必须缺省,DNS与主网卡保持一致。

约束条件3:当SubnetId与接口调用前一致,PrivateIpAddress缺省代表与接口调用前相同,当SubnetId与接口调用前不一致,PrivateIpAddress缺省代表在新的子网Ip范围内自动分配。

Request Parameters(请求参数)

InstanceId

  • 待修改属性的实例ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

NetworkInterfaceId

  • 待修改属性的网络接口ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

SecurityGroupId(SecurityGroupId.N只识别第一个数组成员)

  • 实例绑定的安全组
  • 类型: String列表
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

SubnetId

  • 新的子网ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

PrivateIpAddress

  • 私有IP地址,子网IP地址范围内的任意有效值
  • 类型: String
  • 有效值:标准IP地址格式
  • 是否可缺省: 是

DNS1

  • DNS 1的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。
  • 类型: String
  • 有效值: 标准IP地址
  • 是否可缺省: 是

DNS2

  • DNS 2的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。
  • 类型: String
  • 有效值: 标准IP地址
  • 是否可缺省: 是

Response Elements(返回值)

RequestId

  • 请求ID
  • 类型: String
  • 是否可缺省: 否

Return

  • 修改网络接口属性信息成功与否
  • 类型: String
  • 有效值:true(成功)| false(失败)
  • 是否可缺省: 否

Examples(例子)

在默认region,为一个网络接口修改子网信息

Sample Request(请求)
http://kec.api.ksyun.com/?Action=ModifyNetworkInterfaceAttribute&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&NetworkInterfaceId=2f93aaba-6368-4cec-b50f-9f199138023f
&SubnetId=c6839580-6ce4-453a-8533-b4fd659eff36
&AUTHPARAMS
Sample Response(返回)
<?xml version="1.0" encoding="UTF-8"?>
<ModifyNetworkInterfaceAttributeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>f2d20e49-63d9-4e6c-b598-050d2fc2631a</RequestId>
    <Return>true</Return>
</ModifyNetworkInterfaceAttributeResponse>