Skip to main content

orderable_licenses

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

Overview​

Nameorderable_licenses
TypeResource
Idovh.saas_csp2.orderable_licenses

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerLicense unique identifier
namestringLicense name
licence_typestringLicense's type, indicates if the licence is standalone or an addon (ADDON, NON-SPECIFIC) (wire: licenceType)
limitintegerMaximum purchasable license
new_seats_allowedbooleanWhether or not it is possible to add new seats on subscriptions of this licence type (wire: newSeatsAllowed)
new_subscriptions_allowedbooleanWhether or not this licence type is allowed for new subscriptions (wire: newSubscriptionsAllowed)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectid, service_nameReturns the name and type of the license, standalone or add-on, the maximum quantity that can be purchased, and whether it allows new subscriptions and new seats. (Alpha version)
listselectservice_namex_pagination_modeReturns the IDs of the licenses that can be ordered for the tenant. (Alpha version)

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"}})
idintegerId
service_namestringService name (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​

Returns the name and type of the license, standalone or add-on, the maximum quantity that can be purchased, and whether it allows new subscriptions and new seats. (Alpha version)

SELECT
id,
name,
licence_type,
limit,
new_seats_allowed,
new_subscriptions_allowed
FROM ovh.saas_csp2.orderable_licenses
WHERE id = '{{ id }}' -- required
AND service_name = '{{ service_name }}' -- required
;