Skip to content
Console(the OVHcloud Console, opens in a new tab)

vRack

All operations require authentication.

4 operationsv1/dedicated/server
OpenAPI
Agent setup

List vRacks (legacy)Production

GET
/1.0/dedicated/server/{serviceName}/vrack

List vRacks (legacy). Returns the names of the vRacks the server is attached to as a whole, in the legacy mode. To attach a server, prefer attaching one of its interfaces in the vRack.

Path parameters

serviceName
required
string

The internal name of your dedicated server

Response

200string[]successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/dedicated/server/{serviceName}/vrack \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[  "string"]

Get a server link (legacy)Production

GET
/1.0/dedicated/server/{serviceName}/vrack/{vrack}

Get a server link (legacy). Returns the attached server and its vRack. This is the legacy whole-server link, not an interface link.

Path parameters

serviceName
required
string

The internal name of your dedicated server

vrack
required
string

vrack name

Response

200dedicatedServersuccessful operation
dedicatedServer
read-only
string

Dedicated Server

vrack
read-only
string

vrack name

Example uses serviceName = string, vrack = string

$ curl https://api.eu.ovhcloud.com/1.0/dedicated/server/{serviceName}/vrack/{vrack} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{  "dedicatedServer": "string",  "vrack": "string"}

Detach a server (legacy)Production

DELETE
/1.0/dedicated/server/{serviceName}/vrack/{vrack}

Detach a server (legacy). Detaches a whole dedicated server from the vRack, in the legacy mode. Returns the task that performs it.

Path parameters

serviceName
required
string

The internal name of your dedicated server

vrack
required
string

vrack name

Response

200Tasksuccessful operation
function
read-only
string
—
id
read-only
integer
—
lastUpdate
read-only
stringdate-time
—
orderId
read-only
integer
—
serviceName
read-only
string
—
status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneinittodo
targetDomain
read-only
string
—
todoDate
read-only
stringdate-time
—

Example uses serviceName = string, vrack = string

$ curl https://api.eu.ovhcloud.com/1.0/dedicated/server/{serviceName}/vrack/{vrack} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{  "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 traffic graph values (deprecated)Deprecated

GET
/1.0/dedicated/server/{serviceName}/vrack/{vrack}/mrtg

Deprecated since Oct 22, 2017, will be removed on Apr 22, 2018 — use /dedicated/server/{serviceName}/networkInterfaceController instead.

Get traffic graph 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

serviceName
required
string

The internal name of your dedicated server

vrack
required
string

vrack name

Query parameters

period
required
MrtgPeriodEnum

mrtg period

Valuesdailyhourlymonthlyweeklyyearly
type
required
MrtgTypeEnum

mrtg type

Valueserrors:downloaderrors:uploadpackets:downloadpackets:uploadtraffic:downloadtraffic:upload

Response

200MrtgTimestampValue[]successful operation
timestamp
integer
—
value
UnitAndValue_double

A numeric value tagged with its unit

Example uses serviceName = string, vrack = string

$ curl https://api.eu.ovhcloud.com/1.0/dedicated/server/{serviceName}/vrack/{vrack}/mrtg \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[  {    "timestamp": 0,    "value": {      "unit": "string",      "value": 0    }  }]