Skip to content

Lines

All operations require authentication.

10 operationsv1/xdsl/{serviceName}
Agent setup

List the lines of an xDSL accessProduction

GET
/1.0/xdsl/{serviceName}/lines

Returns the numbers of the copper lines of the access.

Path parameters

serviceName
required
string

Service name

Response

200string[]successful operation

Example uses serviceName = string

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

Get a line of an xDSL accessProduction

GET
/1.0/xdsl/{serviceName}/lines/{number}

Returns the line number, distance and sections to the DSLAM, synchronization rates, mitigation, deconsolidation, portability and fault repair time.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Response

200Linesuccessful operation
concentrationPoint
read-only
LandlineConcentrationPoint

Data to identify the line at the concentration point

deconsolidation
read-only
DeconsolidationEnum

Deconsolidation of the line.

ValuescreateNeighbourcreationcreationNeighbourpartialtotal
directDistribution
read-only
boolean

True if the line is directly wired on the DSLAM

distance
read-only
integer

Distance in meters from the DSLAM

faultRepairTime
read-only
FaultRepairTimeEnum

Maximum time needed to repair a landline

Values10HO4HNO4HODPLUS1NORMAL
lineSectionsLength
read-only
LineSectionLength[]

Detailed information about the sections between the DSLAM and the telephone jack

mitigation
read-only
number

Mitigation of the line in dB

number
read-only
string

The number of the line

originalNumber
read-only
string

The number used to place the order. Null if the same as the current number.

portability
read-only
boolean

Whether the line number has been ported to OVH, to be used with VoIP service

syncDown
read-only
number

The download synchronisation on the DSLAM in Kbps

syncUp
read-only
number

The upload synchronisation on the DSLAM in Kbps

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "concentrationPoint": { "lineHead": "string", "lineInitialSection": 0, "lineInitialSectionPair": 0 }, "deconsolidation": "createNeighbour", "directDistribution": true, "distance": 0, "faultRepairTime": "10HO", "lineSectionsLength": [ { "diameter": 0, "length": 0 } ], "mitigation": 0, "number": "string", "originalNumber": "string", "portability": true, "syncDown": 0, "syncUp": 0}

Cancel the diagnostic of a lineProduction

POST
/1.0/xdsl/{serviceName}/lines/{number}/diagnostic/cancel

Cancels the ongoing advanced diagnostic of the line, when it can still be canceled.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Response

200—successful operation

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/diagnostic/cancel \
  -H "authorization: Bearer $OVH_TOKEN"

Run the advanced diagnostic of a lineProduction

POST
/1.0/xdsl/{serviceName}/lines/{number}/diagnostic/run

Starts or continues the advanced diagnostic of the line with the customer answers and actions done. Returns the diagnostic with its status, fault type and data.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Request body (required)

actionsDone
CustomerActionsEnum[]

Customer possible actions

ValuesbePreparedToCheckModemSynchronizationchangeDslFilterAndPlugInDtichangeExtensionCablechangeProfilecheckConnectionCablecheckConnectionLoginAndParameterscheckFilterconnectModemToOtherPlugsneutralTestrebootModemresetModemunplugEveryModemsunplugModem
answers
Answers

Customer answers for line diagnostic

faultType
required
FaultTypeEnum

Line diagnostic fault type

ValuesalignmentnoSyncsyncLossOrLowBandwidthunknown

Response

200Diagnosticsuccessful operation
data
read-only
DiagnosticData

Diagnostic data and information

faultType
read-only
FaultTypeEnum

Line diagnostic fault type

ValuesalignmentnoSyncsyncLossOrLowBandwidthunknown
id
read-only
integer

Diagnostic id

status
read-only
DiagnosticStatusEnum

Diagnostic status possible values

ValuescancelledconnectionProblemgenericIncidentPendinghaveToConnectModemOnTheRightPluginitinterventionRequestednoBandwidthFaultnoProblemAnymorenoSyncFaultDiagnosticRequiredproblemresolvedAfterTestssleepingvalidationRefusedwaitingHumanwaitingRobotwaitingValidation

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/diagnostic/run \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "data": { "actionsDone": [ "bePreparedToCheckModemSynchronization" ], "actionsToDo": [ { "description": "string", "name": "bePreparedToCheckModemSynchronization" } ], "answers": { "bandwidthTestUnit": "Kbps", "comment": "string", "conditionsAccepted": true, "contactPhone": "string", "datetimeOfAppearance": "2024-01-01T12:00:00Z", "downloadBandwidthTest": 0, "endAfternoonHours": "string", "endMorningHours": "string", "followBySms": true, "hasModemKeptSynchronization": true, "idAppointment": 0, "individualSite": true, "modemIsSynchronized": true, "modemMac": "string", "modemStillSynchronized": true, "modemType": "string", "ovhTicket": "string", "problemType": "lowBandwidth", "resolvedAfterTests": true, "secureSite": true, "severalInternetConnections": true, "siteClosedDays": "string", "siteDigicode": "string", "siteOpening": "string", "startAfternoonHours": "string", "startMorningHours": "string", "uploadBandwidthTest": 0 }, "comment": "string", "creationDate": "2024-01-01T12:00:00Z", "diagnosticDoneDate": "2024-01-01T12:00:00Z", "error": "string", "lastUpdate": "2024-01-01T12:00:00Z", "lineDetails": { "accessName": "string", "accessPing": true, "address": "string", "connectionInfo": { "crcError": 0, "downstreamAttenuation": 0, "downstreamMargin": 0, "downstreamSync": 0, "ifName": "string", "profile": "string", "upstreamAttenuation": 0, "upstreamMargin": 0, "upstreamSync": 0 }, "contactPhone": "string", "description": "string", "dslamIsSynchronized": true, "gtr": true, "length": 0, "lineCapabilities": { "down": 0, "mitigation": "string", "ping": 0, "up": 0 }, "lineType": "adsl", "nra": "string", "number": "string", "operator": "axione", "sections": [ { "length": 0, "section": 0 } ] }, "robotAction": "alignmentLockTest", "seltTest": { "date": "2024-01-01T12:00:00Z", "distance": 0, "preloc": "CUST", "state": "open", "status": "failed" }, "timeout": 0, "toAnswer": [ { "defaultValue": "string", "description": "string", "enumValues": [ "string" ], "name": "bandwidthTestUnit", "possibleValues": [ { "id": 0, "label": "string", "value": "string" } ], "required": true, "type": "string" } ] }, "faultType": "alignment", "id": 0, "status": "cancelled"}

Get the DSLAM port of a lineProduction

GET
/1.0/xdsl/{serviceName}/lines/{number}/dslamPort

Returns the status and profile of the DSLAM port of the line, with its last synchronization and desynchronization dates.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Response

200DslamPortsuccessful operation
lastDesyncDate
read-only
stringdate-time

Last time the port lost the synchronization

lastSyncDate
read-only
stringdate-time

Last time the port synchronized

profile
read-only
DslamLineProfile

Profile on the DSLAM

status
read-only
DslamPortStatusEnum

Different states of a DSLAM port

Valuesactivateddeactivatedoutofsync

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/dslamPort \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "lastDesyncDate": "2024-01-01T12:00:00Z", "lastSyncDate": "2024-01-01T12:00:00Z", "profile": { "id": 0, "isCurrent": true, "name": "string" }, "status": "activated"}

List the profiles of a DSLAM portProduction

GET
/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/availableProfiles

Returns the profiles that can be applied to the DSLAM port of the line, and which one is current.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Response

200DslamLineProfile[]successful operation
id
read-only
integer
—
isCurrent
read-only
boolean
—
name
read-only
string
—

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/availableProfiles \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ { "id": 0, "isCurrent": true, "name": "string" }]

Change the profile of a DSLAM portProduction

POST
/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/changeProfile

Applies one of the available profiles to the DSLAM port of the line. Returns the task that performs the change.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Request body (required)

dslamProfileId
required
integer

The id of the xdsl.DslamLineProfile

Response

200Tasksuccessful operation
doneDate
read-only
stringdate-time

Date when the action was completed

function
read-only
string
—
id
read-only
integer
—
isArchived
read-only
boolean
—
status
read-only
TaskStatusEnum

Status of a task.

Valuescancelleddoingdoneerrorproblemtodo
todoDate
read-only
stringdate-time

Date when the action will start

updateDate
read-only
stringdate-time
—

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/changeProfile \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "string", "id": 0, "isArchived": true, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z", "updateDate": "2024-01-01T12:00:00Z"}

List the logs of a DSLAM portProduction

GET
/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/logs

Returns the messages the DSLAM emitted for the port of the line, with their date, last occurrence and number of occurrences.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Query parameters

limit
required
integer
—

Response

200DslamPortLog[]successful operation
date
read-only
stringdate-time
—
lastOccurrenceDate
read-only
stringdate-time

The last time this message occured

message
read-only
string
—
numberOfOccurrences
read-only
integer

The number of times this message occured between date and lastOccurrenceDate

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/logs \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ { "date": "2024-01-01T12:00:00Z", "lastOccurrenceDate": "2024-01-01T12:00:00Z", "message": "string", "numberOfOccurrences": 0 }]

Reset a DSLAM portProduction

POST
/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/reset

Resets the port of the line on the DSLAM. Returns the task that performs the change.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Response

200Tasksuccessful operation
doneDate
read-only
stringdate-time

Date when the action was completed

function
read-only
string
—
id
read-only
integer
—
isArchived
read-only
boolean
—
status
read-only
TaskStatusEnum

Status of a task.

Valuescancelleddoingdoneerrorproblemtodo
todoDate
read-only
stringdate-time

Date when the action will start

updateDate
read-only
stringdate-time
—

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/dslamPort/reset \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "string", "id": 0, "isArchived": true, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z", "updateDate": "2024-01-01T12:00:00Z"}

Get the statistics of a lineProduction

GET
/1.0/xdsl/{serviceName}/lines/{number}/statistics

Returns the values of one line metric (attenuation, SNR, synchronization or CRC, FEC and HEC errors) over a daily, weekly, monthly or yearly period, with their unit.

Path parameters

number
required
string

Number

serviceName
required
string

Service name

Query parameters

period
required
StatisticsPeriodEnum

Periods for statistics.

Valuesdailymonthlypreviewweeklyyearly
type
required
LineStatisticsTypeEnum

Various types of statisctics available for the line.

Valuesattenuation:downloadattenuation:uploaderror:crcerror:fecerror:hecsnr:downloadsnr:uploadsynchronization:downloadsynchronization:upload

Response

200TimestampAndValuesuccessful operation
unit
read-only
string
—
values
read-only
TimestampAndValue[]
—

Example uses number = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/xdsl/{serviceName}/lines/{number}/statistics \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "unit": "string", "values": [ { "timestamp": 0, "value": 0 } ]}