全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

修改网络接口属性信息

最近更新时间:2023-09-07 19:35:52

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(请求参数)

::: hljs-center

名称 类型 是否可缺省 示例值 有效值 描述
Action String ModifyNetworkInterfaceAttribute - 系统规定参数。取值:ModifyNetworkInterfaceAttribute
InstanceId String 98284100-f6d1-4bbf-886a-1b0765024738 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 待修改属性的实例ID
NetworkInterfaceId String 2f93aaba-6368-4cec-b50f-9f199138023f 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 待修改属性的网络接口ID
SubnetId String 4d68d87b-5cbb-4b1a-b761-562ecaf143d6 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 新的子网ID
SecurityGroupId String列表 - 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 实例绑定的安全组,SecurityGroupId.N可以绑定多个安全组。已绑定的安全组,未重新指定时会被删除。
PrivateIpAddress String - 标准IP地址格式 私有IP地址,子网IP地址范围内的任意有效值。
DNS1 String - 标准IP地址格式 DNS 1的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。
DNS2 String - 标准IP地址格式 DNS 2的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。

:::

Response Elements(返回值)

::: hljs-center

名称 类型 是否可缺省 示例值 有效值 描述
RequestId String 98284100-f6d1-4bbf-886a-1b0765024738 - 请求ID
Return Boolean true true(成功)/false(失败) 修改网络接口属性信息成功与否

:::

Examples(例子)

在cn-beijing-6这个region,为一个网络接口修改子网信息

Sample Request(请求)
http://kec.cn-beijing-6.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(返回)
{
  "RequestId": "7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
  "Return": true
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈