1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API (CreateNetworkInterface) is used to create ENIs.
- When creating an ENI, you can specify a private IP and can designate a primary IP. The specified private IP must be within the subnet of the ENI and not already in use.
- When creating an ENI, you can specify the number of private IPs to apply for, and the system will generate private IP addresses randomly.
- There is a limit to the number of IP addresses to which an ENI can be bound. For more information on resource restrictions, see ENI Usage Limits.
- When an ENI is created, it can be bound to existing security groups.
- When an ENI is created, it can be bound to tags. The list of tags in the response represents the successfully added tags.
Default interface request rate limit: 100 times per second.
Interface update time: 2022-10-26 02:54:06.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: CreateNetworkInterface |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| VpcId | Yes | No | String | VPC instance ID, which can be obtained through the VpcId returned by the DescribeVpcs API. Example: vpc-0akbol5v |
| NetworkInterfaceName | Yes | No | String | ENI name, up to 60 bytes in length. Example: demoNIC |
| NetworkInterfaceDescription | No | No | String | ENI description. The name can be given freely but must not exceed 60 characters. Example: demoDesc |
| SubnetId | Yes | No | String | Subnet instance ID of the ENI, e.g., subnet-0ap8nwca. Example: subnet-76r802pg |
| SecondaryPrivateIpAddressCount | No | No | Uint64 | Number of newly applied private IP addresses. The total number of private IP addresses must not exceed the quota. Example: 1 |
| SecurityGroupIds | No | No | Array of String | Specifies the bound security group, e.g., ['sg-1dd51d']. Example: ['sg-75ww503r'] |
| PrivateIpAddresses | No | No | Array of PrivateIpAddressSpecification | Specified VPC IP information, up to 10 can be specified at once. Example:View |
| Tags | No | No | Array of Tag | Specifies the list of tags for binding. For example, [{"Key": "city", "Value": "region"}]. Example:View |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| NetworkInterface | NetworkInterface | ENI instances. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidParameterValue | The parameter value is invalid. |
| LimitExceeded | Exceeded the limit |
| InvalidParameterValue.Malformed | Invalid input format. |
| ResourceNotFound | The resource does not exist |
| InvalidParameterValue.LimitExceeded | The parameter value exceeds the limit. |
| InvalidParameterValue.Reserved | The parameter value is a reserved object of the system. |
| InvalidParameterValue.Range | The parameter value is not within the specified range. |
| MissingParameter | Missing parameters. The request did not carry the required parameter. |