The name of the vNIC.
The length is 2 to 63 characters. Only letters, numbers, - and periods (.) are supported. The name must start and end with a number or a letter.
| | subnetId | Yes | String | ID of the subnet. | | nicStackType | No | [SubnetStackType](https://docs.console.zenlayer.com/api-reference/compute/datastructure#subnetstacktype) |The IP stack type of the vNIC.
If not specified, it will be determined by the subnet’s stack type: IPv4 for an IPv4 subnet, and IPv6 for an IPv6 subnet.
Specify this parameter if you need IPv4\_IPv6 vNIC IP stack type.
| | resourceGroupId | No | String |The resource group ID of the vNIC.
If you do not specify a resource group, it is placed in the default resource group.
| | securityGroupId | No | String |ID of the security group deployed on the primary vNIC.
Currently only one security group can be deployed.
If not specified, the security group associated with global VPC will be used by default.
| | internetChargeType | No | [InternetChargeType](https://docs.console.zenlayer.com/api-reference/compute/datastructure#internetchargetype) |Network billing model.
See InternetChargeType for available values.
If the subnet stack type is IPv6 and the type is Public , this value is required.
| | bandwidth | No | Integer |Outbound public network bandwidth cap (Mbps). Unit: Mbps.
The value differs with different instance types.
Value range: \[1, +)
| | packageSize | No | Float |Data transfer package size(TB).
The unit is TB.
This value takes effect only when internetChargeType is set to ByTrafficPackage .
The default value is 0.
Maximum of one decimal place.
Value range: \[0.0, +)
| | clusterId | No | String |Bandwidth cluster ID.
If the value of internetChargeType is BandwidthCluster , the parameter is required.
| | marketingOptions | No | [MarketingInfo](https://docs.console.zenlayer.com/api-reference/compute/datastructure#marketinginfo) | Information on marketing campaigns. | | tags | No | [TagAssociation](https://docs.console.zenlayer.com/api-reference/compute/datastructure#tagassociation) |Bound tags when creating the vNIC.
Tag keys must be unique.
| ## 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.
| | nicId | String | vNIC ID. | ## 4. Code Example {% tabs %} {% tab title="Example" %} **Create an elastic vNIC.**POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateNetworkInterface
Request:
{
"name": "XXX",
"subnetId": "xxx",
"packageSize": 10,
"internetChargeType": "ByTrafficPackage",
"resourceGroupId": "xxxx"
}
Response:
{
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"response": {
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"nicId": "xxx"
}
}