修改指定网络接口的属性,当前支持修改安全组、子网或者DNS信息。
接口调用可修改一个或多个属性(安全组、子网、DNS、IP)。
特殊场景:如果跨VPC修改子网,SubnetID和SecurityGroupId必须在同一个VPC下
约束条件1:在更换主网卡SubnetId、PrivateIpAddress时,如果网络接口已经绑定EIP、属于SLB的真实服务器或绑定Portforword时,则不允许更改,需要先解绑相应配置。
约束条件2:修改副网卡网络信息时,DNS1和DNS2必须缺省,DNS与主网卡保持一致。
约束条件3:当SubnetId与接口调用前一致,PrivateIpAddress缺省代表与接口调用前相同,当SubnetId与接口调用前不一致,PrivateIpAddress缺省代表在新的子网Ip范围内自动分配。
名称 | 类型 | 是否可缺省 | 示例值 | 有效值 | 描述 |
---|---|---|---|---|---|
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的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。 |
名称 | 类型 | 是否可缺省 | 示例值 | 有效值 | 描述 |
---|---|---|---|---|---|
RequestId | String | 否 | 98284100-f6d1-4bbf-886a-1b0765024738 | - | 请求ID |
Return | Boolean | 否 | true | true(成功)/false(失败) | 修改网络接口属性信息成功与否 |
在cn-beijing-6这个region,为一个网络接口修改子网信息
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
{
"RequestId": "7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
"Return": true
}
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!