全部文档
当前文档

暂无内容

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

文档中心

修改网络接口

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:ModifyNetworkInterfaceAttribute。
Version String
公共参数,本接口取值:2016-03-04。
InstanceId String

待修改属性的实例ID 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

示例值:98284100-f6d1-4bbf-886a-1b0765024738
NetworkInterfaceId String

待修改属性的网络接口ID 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

示例值:2f93aaba-6368-4cec-b50f-9f199138023f
SubnetId String

新的子网ID 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

示例值:4d68d87b-5cbb-4b1a-b761-562ecaf143d6
SecurityGroupId.N String

实例绑定的安全组,SecurityGroupId.N可以绑定多个安全组。已绑定的安全组,未重新指定时会被删除。
标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

示例值:-
PrivateIpAddress String

私有IP地址,子网IP地址范围内的任意有效值。 标准IP地址格式

示例值:-
DNS1 String

DNS 1的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。 标准IP地址格式

示例值:-
DNS2 String

DNS 2的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。 标准IP地址格式

示例值:-

返回参数

参数名称
类型
描述
RequestId String

请求ID

示例值:-
Return Boolean

修改网络接口属性信息成功与否

示例值:true(成功)/false(失败)

请求示例

curl -X GET|POST
'http://kec.api.ksyun.com/?Action=ModifyNetworkInterfaceAttribute&Version=2016-03-04'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kec.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'InstanceId=xxx&NetworkInterfaceId=xxx&SubnetId=xxx&SecurityGroupId.N=xxx&PrivateIpAddress=xxx&DNS1=xxx&DNS2=xxx'

返回示例

JSON格式

{
"RequestId":"7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
"Return":true
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
SubnetInvalidParameterValueAn invalid or out-of-range value was supplied for the "Subnet"([{0}]) parameter.400“子网”([{0}])参数的取值无效或者超出有效范围
InstanceIdInvalidInstance Resource id is invalid400实例资源ID无效
VifIdInvalidNetwork interface ID is invalid400网卡ID无效
SecurityGroupIdRequiredSecurityGroupId is required400SecurityGroupId必传
BoundHaVipCanNotChangeNetworkConfigurationThe network configuration cannot be changed because havip is already bound.400无法更改网络配置,因为已绑定havip。
DnsInvalid暂无400暂无
NetworkCardDnatsInvalidWhen changing the host network configuration, if the network card has a Dnat rule, it is not allowed to change.400在更改主机网络配置的时候 如果网卡有Dnat 规则 则不允许更改
SecurityGroupIdInvalidSecurity group id is invalid400安全组ID无效
SecurityGroupIdLimitExceededThe number of security groups has reached the limit {0}400安全组数量已达到上限{0}
PrivateIpAddressInvalidParameterValueAn invalid or out-of-range value was supplied for the "PrivateIpAddress" parameter.400“私有IP地址”参数的取值无效或者超出有效范围
Ipv6 is not valid暂无400暂无
Ipv6AlreadyEnablePublicNetworkIPV6 Address enable public network, please refund first.400IPV6地址已经开启公网,请先到网络控制台关闭Ipv6公网访问
InternalError400 BAD_REQUEST : : {"badRequest": {"message": "(u'The vpc neutron service can not get right return', {'error_type': 'VpcNeutronException', 'code': 500, 'error_code': u'kec.F001'})", "code": 400}}400
InstanceHasHostRouteExistThe instance have Host Route in VPC and cannot replace the network. Please check.400云主机所在的VPC内,存在指向这台云主机的主机路由,导致无法更换网络,请检查或者清理对应主机路由后重试
SubnetAndPrivateIpAddressNotMatchPrivate ip address is not in the sub network IP range or has been used400私网IP不在子网的IP范围内或者已经被占用
NeedDetachSLbMust be detach SLB400必须先解绑SLB
NeedDetachEipMust be detach EIP400必须先解绑EIP
ExtensionNetworkInterfaceCanNotModifyDnsExtension network interface can not modify dns400辅网卡不能修改DNS
OperationNotAllowedForOtherLineThe operation is not allowed for otherLine.400非主机业务线实例,不允许在主机控制台做此操作
SubnetAndSecurityGroupNotMatchSub network[{0}] and security groups[{1}] must belong to the same VPC400子网[{0}]和安全组[{1}]必须属于同一个VPC.
纯净模式常规模式

纯净模式

点击可全屏预览文档内容