Contents:
1. API Description
Domain name for API request: vpc.tencentcloudapi.com.
This API (AttachNetworkInterface) is used to bind an ENI to a CVM.
- A CVM can be bound with multiple ENIs, but can only be bound with one primary ENI.
- An ENI can only be bound to one CVM at a time.
- An ENI can only be bound to a CVM that is running or has been shut down.
- An ENI can only be bound to a CVM in VPC, and the CVM must resides in the same availability zone as the subnet of the ENI.
A maximum of 100 requests can be initiated per second for this API.
Note: This API supports Finance regions. Since Finance regions and non-Finance regions are isolated and not interconnected. If the common parameter Region is a Finance region (such as ap-shanghai-fsi), you need to specify a domain name containing the Finance region that should be identical to the value of Region field, for example: vpc.ap-shanghai-fsi.tencentcloudapi.com.
2. Input Parameters
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common parameter. The value used for this API: AttachNetworkInterface |
Version | Yes | String | Common parameter. The value used for this API: 2017-03-12 |
Region | Yes | String | Common parameter. For more information, please see the list of regions supported by the product. |
NetworkInterfaceId | Yes | String | ENI instance ID, such as eni-m6dyj72l. |
InstanceId | Yes | String | CVM instance ID. such as ins-r8hr2upy. |
3. Output Parameters
Parameter Name | Type | Description |
---|---|---|
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
4. Error Codes
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
InvalidParameterValue.Malformed | Invalid input parameter format. |
ResourceNotFound | Resource does not exist. |
UnsupportedOperation.VpcMismatch | The resources are not in the same VPC. |
5. Example
Example 1 Bind an ENI to a CVM
Input example
https://vpc.tencentcloudapi.com/?Action=AttachNetworkInterface
&Version=2017-03-12
&NetworkInterfaceId=eni-afo43z61
&InstanceId=ins-ins-r8hr2upy
&<Common request parameters>
Output example
{
"Response": {
"RequestId": "f23d1450-ed00-4442-98d4-be409e625e6c"
}
}
6. Other Resources
Cloud API 3.0 comes with the following development tools to make it easier to call the API.