ModifyNetworkInterfaceAttribute - 云服务器 ECS

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyNetworkInterfaceAttribute	系统规定参数。取值：ModifyNetworkInterfaceAttribute。
RegionId	String	是	cn-hangzhou	弹性网卡所在地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
NetworkInterfaceName	String	否	eniTestName	弹性网卡的名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。默认值：空。
NetworkInterfaceId	String	是	eni-bp67acfmxazb4p****	弹性网卡ID。
QueueNumber	Integer	否	8	网卡队列数。取值范围：1~2048。只允许修改辅助网卡队列数。允许修改处于可用状态（`Available`）的辅助网卡队列数，或者已附加（`InUse`）至实例但实例为已停止（`Stopped`）状态的辅助网卡队列数。辅助网卡队列数不能超过实例规格允许的单块网卡最大队列数，同时实例的所有网卡累加队列数不能超过实例规格允许的队列数总配额。实例规格的单块网卡最大队列数和总配额可以通过DescribeInstanceTypes接口查询`MaximumQueueNumberPerEni`、`TotalEniQueueQuantity`字段。
Description	String	否	testDescription	弹性网卡的描述信息。长度为2~255个英文或中文字符，不能以http://和https://开头。默认值：空。
SecurityGroupId.N	String	否	sg-bp67acfmxazb4p****	SecurityGroupId列表。 N的取值范围与每张弹性网卡能够加入的安全组数量配额有关，更多信息，请参见使用限制。只允许修改辅助网卡的安全组。设置安全组后，辅助弹性网卡会加入该安全组，并且移出已有安全组。修改安全组后很快会生效，但可能有较小的延迟。
DeleteOnRelease	Boolean	否	true	释放实例时是否保留网卡。取值范围： true：不保留。 false：保留。

返回数据

名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyNetworkInterfaceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNetworkInterfaceAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

HttpCode	错误码	错误信息	描述
400	MissingParameter	%s	缺失参数，请检查参数是否完整。
400	UnsupportedParameter	%s	不支持参数。
400	InvalidParameter	%s	无效的参数。
400	InvalidInstanceID.Malformed	%s	参数 InstanceId 格式错误。
400	InvalidOperation.InvalidEcsState	%s	实例当前的状态不支持此操作。
400	InvalidOperation.InvalidEniState	%s	弹性网卡当前的状态不支持此操作。
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	由于不允许分离网卡，不允许此操作。
400	InvalidParams.EniId	%s	指定的参数 EniId 无效。
400	Forbidden.RegionId	%s	当前地域暂时没有提供该服务。
400	JoinedGroupLimitExceed	%s	指定资源所能加入的安全组数量达到上限。具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidUserType.NotSupported	%s	您当前的账号不支持此操作。
403	Abs.InvalidAccount.NotFound	%s	您的阿里云账号不存在，或者您的 AccessKey 已经过期。
403	Forbidden.NotSupportRAM	%s	暂不支持RAM用户执行该操作。
403	Forbidden.SubUser	%s	您的账号没有操作此资源的权限，请向主账号申请相关的权限。
403	MaxEniCountExceeded	%s	已超过可以操作的最大弹性网卡数。
403	EniPerInstanceLimitExceeded	%s	实例附加的弹性网卡数量已经达到了最大限度，不能再为实例附加弹性网卡。
403	InvalidOperation.AvailabilityZoneMismatch	%s	该操作无效。
403	InvalidOperation.VpcMismatch	%s	您的操作无效，请确认该操作中的 VPC 与其它参数是否匹配。
403	SecurityGroupInstanceLimitExceed	%s	该安全组内已有的实例数量已达到最大限制。
403	InvalidSecurityGroupId.NotVpc	%s	参数 SecurityGroupId 无效，该安全组的网络类型不是专有网络。
403	InvalidOperation.InvalidEniType	%s	当前弹性网卡的类型不支持此操作。
403	InvalidOperation.EniServiceManaged	%s	操作无效。
403	InvalidOperation.ResourceManagedByCloudProduct	%s	云产品托管的安全组不支持修改操作。
403	InvalidParameter.InvalidEniQueueNumber	%s	弹性网卡队列数有误，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	弹性网卡队列数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	弹性网卡队列总数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。
403	AclLimitExceed	%s	网卡或实例的安全组规则数量超过限额值。
404	InvalidEcsId.NotFound	%s	指定的实例 ID 不存在。
404	InvalidEniId.NotFound	%s	指定的弹性网卡 ID 不存在。
404	InvalidVSwitchId.NotFound	%s	指定的交换机不存在。
404	InvalidSecurityGroupId.NotFound	%s	指定的安全组 ID 不存在。
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	主网卡仅支持修改网卡名称和描述。

访问错误中心查看更多错误码。