Dedicated servers
All operations require authentication.
List attached dedicated server interfacesProduction
Path parameters
The internal name of your vrack
Response
Example uses serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServerInterface \
-H "authorization: Bearer $OVH_TOKEN"[ "string"]
Get an attached dedicated server interfaceProduction
Path parameters
Dedicated Server Interface
The internal name of your vrack
Response
Dedicated Server Interface
vrack name
Example uses dedicatedServerInterface = string, serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServerInterface/ {dedicatedServerInterface} \
-H "authorization: Bearer $OVH_TOKEN"{ "dedicatedServerInterface": "string", "vrack": "string"}
Attach a dedicated server interfaceProduction
Attach a dedicated server interface. Attaches a dedicated server network interface to the vRack. Returns the task that performs it.
Path parameters
The internal name of your vrack
Request body (required)
Dedicated server interface to add
Response
Task status
cancelleddoingdoneinittodoExample uses serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServerInterface \
-H "authorization: Bearer $OVH_TOKEN"{ "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "orderId": 0, "serviceName": "string", "status": "cancelled", "targetDomain": "string", "todoDate": "2024-01-01T12:00:00Z"}
Detach a dedicated server interfaceProduction
Path parameters
Dedicated Server Interface
The internal name of your vrack
Response
Task status
cancelleddoingdoneinittodoExample uses dedicatedServerInterface = string, serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServerInterface/ {dedicatedServerInterface} \
-H "authorization: Bearer $OVH_TOKEN"{ "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "orderId": 0, "serviceName": "string", "status": "cancelled", "targetDomain": "string", "todoDate": "2024-01-01T12:00:00Z"}
List attached dedicated server interface detailsProduction
Path parameters
The internal name of your vrack
Response
the name of dedicatedServer
the unique identifier of dedicatedServerInterface
the name of dedicatedServerInterface
Example uses serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServerInterfaceDetails \
-H "authorization: Bearer $OVH_TOKEN"[ { "dedicatedServer": "string", "dedicatedServerInterface": "string", "name": "string" }]
List attached dedicated servers (legacy)Production
List attached dedicated servers (legacy). Returns the dedicated servers attached as a whole to the vRack, in the legacy mode. Attaching by interface replaces it.
Path parameters
The internal name of your vrack
Response
Example uses serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServer \
-H "authorization: Bearer $OVH_TOKEN"[ "string"]
Get an attached dedicated server (legacy)Production
Get an attached dedicated server (legacy). Returns the attached server and its vRack. This is the legacy whole-server link, not an interface link.
Path parameters
Dedicated Server
The internal name of your vrack
Response
Dedicated Server
vrack name
Example uses dedicatedServer = string, serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServer/ {dedicatedServer} \
-H "authorization: Bearer $OVH_TOKEN"{ "dedicatedServer": "string", "vrack": "string"}
Attach a dedicated server (legacy)Production
Attach a dedicated server (legacy). Attaches a whole dedicated server to the vRack, in the legacy mode. Prefer attaching one of its interfaces. Returns the task that performs it.
Path parameters
The internal name of your vrack
Request body (required)
Dedicated server to add
Response
Task status
cancelleddoingdoneinittodoExample uses serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServer \
-H "authorization: Bearer $OVH_TOKEN"{ "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "orderId": 0, "serviceName": "string", "status": "cancelled", "targetDomain": "string", "todoDate": "2024-01-01T12:00:00Z"}
Detach a dedicated server (legacy)Production
Detach a dedicated server (legacy). Detaches a whole dedicated server from the vRack, in the legacy mode. Returns the task that performs it.
Path parameters
Dedicated Server
The internal name of your vrack
Response
Task status
cancelleddoingdoneinittodoExample uses dedicatedServer = string, serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServer/ {dedicatedServer} \
-H "authorization: Bearer $OVH_TOKEN"{ "function": "string", "id": 0, "lastUpdate": "2024-01-01T12:00:00Z", "orderId": 0, "serviceName": "string", "status": "cancelled", "targetDomain": "string", "todoDate": "2024-01-01T12:00:00Z"}
Get dedicated server traffic values (deprecated)Deprecated
Deprecated since Oct 22, 2017, will be removed on Apr 22, 2018 — use /dedicated/server/{serviceName}/networkInterfaceController instead.
Get dedicated server traffic values (deprecated). Returns the traffic, packets or errors measured on the vRack port of the server, for a period from hourly to yearly. Deprecated: use the dedicated server statistics instead.
Path parameters
Dedicated Server
The internal name of your vrack
Query parameters
mrtg period
dailyhourlymonthlyweeklyyearlymrtg type
errors:downloaderrors:uploadpackets:downloadpackets:uploadtraffic:downloadtraffic:uploadResponse
A numeric value tagged with its unit
Example uses dedicatedServer = string, serviceName = string
$ curl https:/ / api.eu.ovhcloud.com/ v1/ vrack/ {serviceName}/ dedicatedServer/ {dedicatedServer}/ mrtg \
-H "authorization: Bearer $OVH_TOKEN"[ { "timestamp": 0, "value": { "unit": "string", "value": 0 } }]