Attaches elastic network interfaces (ENIs) to an ENS instance.
Operation description
Note the following when you call this operation:
The elastic network interfaces (ENIs) must be in the Available state.
Each ENI can be attached to only one instance in the same zone and VPC at a time.
The instance must be in the Stopped state.
You can attach up to 10 elastic network interfaces (ENIs) to an instance.
This operation is asynchronous. After the call succeeds, you can query the ENI status to check the operation result.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ens:AttachNetworkInterface |
update |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
The instance ID. |
i-5p67acfmxazb4p**** |
| NetworkInterfaceId |
string |
Yes |
The ID of the elastic network interfaces (ENIs). |
eni-58z57orgmt6d1**** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
Examples
Success response
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ens.interface.error | An error occurred while call the API. | |
| 400 | InvalidEniId.NotFound | The specified NetworkInterfaceId does not exist. | |
| 400 | InvalidParameter.EniServiceManaged | The eni is managed by service. | |
| 400 | InvalidOperation.InvalidEniStatus | Current eni status does not support this operation. | |
| 400 | InstanceNotFound | The input parameter instancdId that is not found. | |
| 400 | InvalidOperation.InvalidEnsStatus | Current instance status does not support this operation. | |
| 400 | InvalidOperation.InstanceNotSupport | The specified instance does not support this operation. | |
| 400 | InvalidOperation.NetworkMismatch | Specified eni and instance are not in the same network. | |
| 400 | EniPerInstanceLimitExceeded | EniPerInstanceLimitExceeded. | |
| 400 | InvalidOperation.InvalidEniType | The type of eni does not support this operation. | |
| 400 | NoPermission | Permission denied. | |
| 400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.