Create an NIC Multi-Queue enabled Virtual Machine (VM)
To create a VM with the NIC Multi-Queue feature enabled using Cloud API, you will need to set the nicMultiQueue boolean property to true in your /server API request.
Endpoint
Use the following endpoint to create an NIC Multi-Queue enabled Virtual Machine (VM): https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers.
Request
curl --location \
--request POST 'https://api.ionos.com/cloudapi/v6/datacenters/fd16-e4-44-b9-daaaaah75/servers' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json' \
--data-raw '{
"properties": {
"name": "My resource",
"hostname": "myHostname",
"cores": 4,
"ram": 4096,
"availabilityZone": "AUTO",
"cpuFamily": "INTEL_ICELAKE",
"type": "ENTERPRISE",
"nicMultiQueue": true
}
}'Remember to update the datacenterId value with your data center's ID:
Path Parameter
Type
Description
Example
datacenterId
string
The ID (UUID) of the data center.
fd16-e4-44-b9-daaaaah75
Below is the list of mandatory body parameters for creating an NIC Multi-Queue enabled VM:
Body Parameters
Required
Type
Description
Example
metadata
no
object
Metadata
{}
properties.name
yes
string
The name of the resource.
My resource
properties.hostname
yes
string
The hostname of the resource. Allowed characters are a-z, 0-9 and - (minus). Hostname should not begin with a minus and should not be longer than 63 characters.
Tunnel connecting site A to site B.
properties.cores
yes
integer
The total number of cores for the server.
203.0.113.1
properties.ram
yes
integer
The memory size for the server in MB, such as 2048. Size must be specified in multiples of 256 MB with a minimum of 256 MB; however, if you set ramHotPlug to TRUE then you must use a minimum of 1024 MB. If you set the RAM size more than 240GB, then ramHotPlug will be set to FALSE and cannot be set to TRUE unless RAM size is not less than 240GB.
4096
properties.availabilityZone
yes
string. Enum: AUTO ZONE_1 ZONE_2
The availability zone in which the server should be provisioned.
AUTO
properties.cpuFamily
yes
string
CPU architecture on which server gets provisioned; not all CPU architectures are available in all datacenter regions; available CPU architectures can be retrieved from the datacenter resource; must not be provided for VCPU servers. If the field is omitted from the request or the value is empty or null, an available CPU architecture will be automatically selected.
INTEL_ICELAKE
properties.type
yes
string. Server type: ENTERPRISE or VCPU.
ENTERPRISE
properties.nicMultiQueue
yes
boolean
Activate or deactivate the NIC Multi-Queue feature on all NICs of this server. This feature is beneficial when the NICs are experiencing performance issues, such as low throughput. Enabling this feature will also initiate a server restart. If the specified value is true, the feature will be activated; if it is not specified or set to false, the feature will be deactivated.
true
To make authenticated requests to the API, the following fields are mandatory in the request header:
Header Parameters
Required
Type
Description
Authorization
yes
string
The bearer token to enable requests to authenticate using a JSON Web Token (JWT).
Content-Type
yes
string
Set this to application/json.
Response
201 Successful operation
{
"id": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
"type": "server",
"href": "<RESOURCE-URI>",
"metadata": {
"etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
"createdDate": "2015-12-04T14:34:09.809Z",
"createdBy": "[email protected]",
"createdByUserId": "[email protected]",
"lastModifiedDate": "2015-12-04T14:34:09.809Z",
"lastModifiedBy": "[email protected]",
"lastModifiedByUserId": "63cef532-26fe-4a64-a4e0-de7c8a506c90",
"state": "AVAILABLE"
},
"properties": {
"name": "My resource",
"hostname": "myHostname",
"cores": 4,
"ram": 4096,
"availabilityZone": "AUTO",
"vmState": "RUNNING",
"cpuFamily": "INTEL_ICELAKE",
"type": "ENTERPRISE",
"nicMultiQueue": true
}
}Last updated
Was this helpful?