Skip to content

Backends

All operations require authentication.

4 operationsv1/cdn/dedicated
Agent setup

List backendsProduction

GET
/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends

Path parameters

domain
required
string

Domain of this object

serviceName
required
string

The internal name of your CDN offer

Response

200ipv4[]successful operation

Example uses domain = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "192.0.2.0"]

Create a backendProduction

POST
/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends

Path parameters

domain
required
string

Domain of this object

serviceName
required
string

The internal name of your CDN offer

Request body (required)

ip
required
string

IP to add to backends list

Response

200Backendsuccessful operation
ip
read-only
ipv4

IPv4 address (e.g., 192.0.2.0)

Example uses domain = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "ip": "192.0.2.0"}

Get a backendProduction

GET
/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends/{ip}

Path parameters

domain
required
string

Domain of this object

ip
required
ipv4

IPv4 address (e.g., 192.0.2.0)

serviceName
required
string

The internal name of your CDN offer

Response

200Backendsuccessful operation
ip
read-only
ipv4

IPv4 address (e.g., 192.0.2.0)

Example uses domain = string, ip = 192.0.2.0, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends/{ip} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "ip": "192.0.2.0"}

Delete a backendProduction

DELETE
/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends/{ip}

Path parameters

domain
required
string

Domain of this object

ip
required
ipv4

IPv4 address (e.g., 192.0.2.0)

serviceName
required
string

The internal name of your CDN offer

Response

200ipv4successful operation

Example uses domain = string, ip = 192.0.2.0, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/cdn/dedicated/{serviceName}/domains/{domain}/backends/{ip} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
"192.0.2.0"