Modifies the name, description, and security group of an elastic network interface (ENI).
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyNetworkInterfaceAttribute |
The operation that you want to perform. Set the value to ModifyNetworkInterfaceAttribute. |
NetworkInterfaceId | String | Yes | eni-bp67acfmxazb4p**** |
The ID of the ENI. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the ENI. You can call the DescribeRegions operation to query the most recent region list. |
SecurityGroupId.N | RepeatList | No | sg-bp67acfmxazb4p**** |
The ID of security group N to which the ENI finally belongs. If a security group to which the ENI has belonged is in the ID list, that security group is removed from the list. Valid values of N: 1, 2, 3, 4, and 5. Note After you modify the security group, the modification takes effect after a short delay.
|
NetworkInterfaceName | String | No | eniTestName |
The name of the ENI. The name must be 2 to 128 characters in length. It must start
with a letter and cannot start with This parameter is empty by default. |
QueueNumber | Integer | No | 8 |
The number of queues per ENI. Valid values: 1 to 2048.
|
Description | String | No | testDescription |
The description of the ENI. The description must be 2 to 256 characters in length
and cannot start with This parameter is empty by default. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&SecurityGroupId.1=sg-bp67acfmxazb4p****
&NetworkInterfaceName=eniTestName
&Description=testDescription
&<Common request parameters>
Sample success responses
XML
format
<DetachNetworkInterfaceResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
</DetachNetworkInterfaceResponse>
JSON
format
{
"RequestId":"04F0F334-1335-436C-A1D7-6C044FExxxxx"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
403 | InvalidUserType.NotSupported | %s | The error message returned because your account does not support this operation. |
403 | Abs.InvalidAccount.NotFound | %s | The error message returned because your Alibaba Cloud account does not exist or because your AccessKey pair has expired. |
400 | MissingParameter | %s | The error message returned because a required parameter is not specified. |
403 | Forbidden.NotSupportRAM | %s | The error message returned because Resource Access Management (RAM) users are not authorized to perform this operation. |
400 | UnsupportedParameter | %s | The error message returned because a specific parameter is not supported. |
403 | Forbidden.SubUser | %s | The error message returned because you are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization. |
400 | InvalidParameter | %s | The error message returned because a specified parameter is invalid. |
400 | InvalidInstanceID.Malformed | %s | The error message returned because the specified InstanceId parameter is invalid. |
400 | InvalidOperation.InvalidEcsState | %s | The error message returned because the operation is not supported while the instance is in the current state. |
400 | InvalidOperation.InvalidEniState | %s | The error message returned because the operation is not supported while the ENI is in the current state. |
400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | The error message returned because the primary ENI cannot be unbound from the instance. |
400 | InvalidParams.EniId | %s | The error message returned because the specified NetworkInterfaceId parameter is invalid. |
404 | InvalidEcsId.NotFound | %s | The error message returned because the specified InstanceId parameter does not exist. |
404 | InvalidEniId.NotFound | %s | The error message returned because the specified ENI ID does not exist. |
404 | InvalidVSwitchId.NotFound | %s | The error message returned because the specified VSwitchId parameter does not exist. |
404 | InvalidSecurityGroupId.NotFound | %s | The error message returned because the specified security group ID does not exist. |
403 | MaxEniCountExceeded | %s | The error message returned because the maximum number of ENIs that can be managed has been reached. |
403 | EniPerInstanceLimitExceeded | %s | The error message returned because the maximum number of ENIs that can be bound to the specified instance has been reached. |
403 | InvalidOperation.AvailabilityZoneMismatch | %s | The error message returned because the operation is invalid. |
403 | InvalidOperation.VpcMismatch | %s | The error message returned because this operation is invalid. Check whether the virtual private cloud (VPC) in the operation corresponds to other parameters. |
403 | SecurityGroupInstanceLimitExceed | %s | The error message returned because the maximum number of instances in the specified security group has been reached. |
403 | InvalidSecurityGroupId.NotVpc | %s | The error message returned because the specified SecurityGroupId parameter is invalid and the network type of the security group is not VPC. |
403 | InvalidOperation.InvalidEniType | %s | The error message returned because the operation is not supported while the ENI is of the current type. |
400 | Forbidden.RegionId | %s | The error message returned because the service is unavailable in the current region. |
403 | InvalidOperation.EniServiceManaged | %s | The error message returned because the operation is invalid. |
403 | InvalidOperation.ResourceManagedByCloudProduct | %s | The error message returned because the security groups managed by cloud services cannot be modified. |
403 | InvalidParameter.InvalidEniQueueNumber | %s | The error message returned because the specified NetworkInterface.N.QueueNumber parameter is invalid. For more information, see the return value of the %s placeholder in the error message. |
403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | The error message returned because the maximum number of queues per ENI has been reached. For more information, see the return value of the %s placeholder in the error message. |
403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | The error message returned because the maximum number of queues for all ENIs on an instance has been reached. For more information, see the return value of the %s placeholder in the error message. |
For a list of error codes, visit the API Error Center.