Toggle the NIC Multi-Queue Property

You can use the IONOS Cloud API to switch the NIC Multi-Queue feature on a Virtual Machine (VM). Set the nicMultiQueue property to one of the following values:

• true to enable the feature on the VM.

• false to turn off the feature on the VM.

Note:

• Automatic VM Restart: Enabling NIC Multi-Queue nicMultiQueue: true triggers an automatic VM restart to apply the configuration changes.

• Hot-Plug NIC Support: You can add network interfaces to a running VM without system restart or downtime. For optimal performance, new NICs automatically default to number queues that match the number of provisioned CPU threads.

• Scaling Queue Count: When adding CPU threads to leverage increased parallelism, the queue count must be updated through a VM restart:

  • Restart the VM using the Cloud API or the Data Center Designer (DCD).

  • An Operating System (OS)-level restart is insufficient and will not update the queue configuration. Queue count changes require a platform-initiated restart to reload the NIC driver with the updated configuration.

Endpoint

Use the following endpoint to enable NIC Multi-Queue feature on your VM: https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{server-uuid}.

Prerequisite: Remember to update the datacenterId and the server-uuid with their relevant values.

Request

curl --location \
--request PATCH 'https://api.ionos.com/cloudapi/v6/datacenters/fd16-e4-44-b9-daaaaah75/servers/15f67991-0f51-4efc-a8ad-ef1fb31a480c' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json' \
--data-raw '{
"nicMultiQueue": true
}'

Path Parameters

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

Request Body Parameters

Request Header Parameters

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": {
        "templateUuid": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
        "name": "My resource",
        "hostname": "myHostname",
        "cores": 4,
        "ram": 4096,
        "availabilityZone": "AUTO",
        "vmState": "RUNNING",
        "cpuFamily": "INTEL_ICELAKE",
        "type": "ENTERPRISE",
        "nicMultiQueue": true
    }
}