Skip to main content

extra_sql_persos

Creates, updates, deletes, gets or lists an extra_sql_persos resource.

Overview​

Nameextra_sql_persos
TypeResource
Idovh.hosting_web.extra_sql_persos

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerIdentifier of the (additional) SQL slot
namestringThe extraSqlPerso option name
task_idintegerThe task ID working on this extraSqlPerso (wire: taskId)
service_namestringBilling name of the matching subscription (or internal naming otherwise) (wire: serviceName)
databaseintegerNumber of database allowed by this option
sizeobjectQuota size allowed per each database by this option
statusstringThe extraSqlPerso option status
usagearrayLinked databases

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectid, service_nameGet an extra SQL option. Returns the number of databases allowed, the quota per database, the linked databases and the status of the option.
listselectservice_namex_pagination_modeList extra SQL options. Returns the IDs of the additional SQL options of the hosting. Each option adds databases, each with its own quota.
service_infos_updateexecid, serviceName, renewUpdate extra SQL option renewal. Updates the renewal settings of the additional SQL option: automatic renewal, renewal period and deletion at expiration.
terminateexecid, serviceNameTerminate an extra SQL option. Requests the termination of the additional SQL option. A link to confirm it is sent by email to the administrator contact.

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"}})
idintegerIdentifier of the (additional) SQL slot
serviceNamestringThe internal name of your hosting
service_namestringThe internal name of your hosting (wire: serviceName)
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get an extra SQL option. Returns the number of databases allowed, the quota per database, the linked databases and the status of the option.

SELECT
id,
name,
task_id,
service_name,
database,
size,
status,
usage
FROM ovh.hosting_web.extra_sql_persos
WHERE id = '{{ id }}' -- required
AND service_name = '{{ service_name }}' -- required
;

Lifecycle Methods​

EXEC variables use wire (API) names.

Update extra SQL option renewal. Updates the renewal settings of the additional SQL option: automatic renewal, renewal period and deletion at expiration.

EXEC ovh.hosting_web.extra_sql_persos.service_infos_update
@id='{{ id }}' --required,
@serviceName='{{ serviceName }}' --required
@@json=
'{
"renew": "{{ renew }}"
}'
;