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

Subscription

All operations require authentication.

2 operationsv1/ssl/{serviceName}
OpenAPI
Agent setup

Get subscriptionProduction

GET
/1.0/ssl/{serviceName}/serviceInfos

Returns the subscription of an SSL certificate: creation and expiration dates, and contacts.

Path parameters

serviceName
required
string

Service name

Response

200Servicesuccessful operation
canDeleteAtExpiration
read-only
boolean

Indicates that the service can be set up to be deleted at expiration

contactAdmin
read-only
string
—
contactBilling
read-only
string
—
contactTech
read-only
string
—
creation
read-only
stringdate
—
domain
read-only
string
—
engagedUpTo
read-only
stringdate
—
expiration
read-only
stringdate
—
possibleRenewPeriod
read-only
integer[]

All the possible renew period of your service in month

renew
RenewType

Way of handling the renew

renewalType
read-only
RenewalTypeEnum

Detailed renewal type of a service

ValuesautomaticForcedProductautomaticV2012automaticV2014automaticV2016automaticV2024manualoneShotoption
serviceId
read-only
integer
—
status
read-only
StateEnum
—
ValuesautorenewInProgressexpiredinCreationokpendingDebtunPaid

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/ssl/{serviceName}/serviceInfos \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{  "canDeleteAtExpiration": true,  "contactAdmin": "string",  "contactBilling": "string",  "contactTech": "string",  "creation": "2024-01-01",  "domain": "string",  "engagedUpTo": "2024-01-01",  "expiration": "2024-01-01",  "possibleRenewPeriod": [    0  ],  "renew": {    "automatic": true,    "deleteAtExpiration": true,    "forced": true,    "manualPayment": true,    "period": 0  },  "renewalType": "automaticForcedProduct",  "serviceId": 0,  "status": "autorenewInProgress"}

Update subscriptionProduction

PUT
/1.0/ssl/{serviceName}/serviceInfos

Updates the subscription of an SSL certificate. Certificates are not renewed automatically.

Path parameters

serviceName
required
string

Service name

Request body (required)

canDeleteAtExpiration
read-only
boolean

Indicates that the service can be set up to be deleted at expiration

contactAdmin
read-only
string
—
contactBilling
read-only
string
—
contactTech
read-only
string
—
creation
read-only
stringdate
—
domain
read-only
string
—
engagedUpTo
read-only
stringdate
—
expiration
read-only
stringdate
—
possibleRenewPeriod
read-only
integer[]

All the possible renew period of your service in month

renew
RenewType

Way of handling the renew

renewalType
read-only
RenewalTypeEnum

Detailed renewal type of a service

ValuesautomaticForcedProductautomaticV2012automaticV2014automaticV2016automaticV2024manualoneShotoption
serviceId
read-only
integer
—
status
read-only
StateEnum
—
ValuesautorenewInProgressexpiredinCreationokpendingDebtunPaid

Response

200—successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/ssl/{serviceName}/serviceInfos \
  -H "authorization: Bearer $OVH_TOKEN"