Skip to content

Operations

All operations require authentication.

2 operationsv1/ssl/{serviceName}
Agent setup

List tasksProduction

GET
/1.0/ssl/{serviceName}/tasks

Returns the identifiers of the tasks of an SSL certificate.

Path parameters

serviceName
required
string

Service name

Response

200integer[]successful operation

Example uses serviceName = string

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

Get a taskProduction

GET
/1.0/ssl/{serviceName}/tasks/{taskId}

Returns a task of an SSL certificate: function, status (todo, doing, done, error or cancelled), and creation, update and completion dates.

Path parameters

serviceName
required
string

Service name

taskId
required
integer

Task ID

Response

200Operationsuccessful operation
doneDate
read-only
stringdate-time

Completion date

function
read-only
OperationFunctionEnum

Task function name

ValuescreateCertificate
lastUpdate
read-only
stringdate-time

Task last update

startDate
read-only
stringdate-time

Task Creation date

status
read-only
OperationStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
taskId
read-only
integer
—

Example uses serviceName = string, taskId = 0

$ curl https://api.eu.ovhcloud.com/1.0/ssl/{serviceName}/tasks/{taskId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "doneDate": "2024-01-01T12:00:00Z", "function": "createCertificate", "lastUpdate": "2024-01-01T12:00:00Z", "startDate": "2024-01-01T12:00:00Z", "status": "cancelled", "taskId": 0}