Skip to main content

virtual_numbers_service_infos

Creates, updates, deletes, gets or lists a virtual_numbers_service_infos resource.

Overview​

Namevirtual_numbers_service_infos
TypeResource
Idovh.sms.virtual_numbers_service_infos

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
service_idinteger (wire: serviceId)
can_delete_at_expirationbooleanIndicates that the service can be set up to be deleted at expiration (wire: canDeleteAtExpiration)
contact_adminstring (wire: contactAdmin)
contact_billingstring (wire: contactBilling)
contact_techstring (wire: contactTech)
creationstring (date)
domainstring
engaged_up_tostring (date) (wire: engagedUpTo)
expirationstring (date)
possible_renew_periodarrayAll the possible renew period of your service in month (wire: possibleRenewPeriod)
renewobjectWay of handling the renew
renewal_typestringDetailed renewal type of a service (automaticForcedProduct, automaticV2012, automaticV2014, automaticV2016, automaticV2024, manual, oneShot, option) (wire: renewalType)
statusstring (autorenewInProgress, expired, inCreation, ok, pendingDebt, unPaid)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectnumberGet service information. Returns the status, creation and expiration dates, contacts and renewal settings of the service.
updateupdatenumberUpdate service information. Updates the renewal settings of the service: automatic renewal, period, or deletion at expiration.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
numberstringYour virtual number

SELECT examples​

Get service information. Returns the status, creation and expiration dates, contacts and renewal settings of the service.

SELECT
service_id,
can_delete_at_expiration,
contact_admin,
contact_billing,
contact_tech,
creation,
domain,
engaged_up_to,
expiration,
possible_renew_period,
renew,
renewal_type,
status
FROM ovh.sms.virtual_numbers_service_infos
WHERE number = '{{ number }}' -- required
;

UPDATE examples​

Update service information. Updates the renewal settings of the service: automatic renewal, period, or deletion at expiration.

UPDATE ovh.sms.virtual_numbers_service_infos
SET
renew = '{{ renew }}'
WHERE
number = '{{ number }}' --required;