Skip to main content

eligible_services

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

Overview​

Nameeligible_services
TypeResource
Idovh.vrack.eligible_services

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
created_atstringCreation date of the call (wire: createdAt)
errorsarrayList of services where an error has been encountered
resultobjectEligible services for this vRack
statusstringStatus of the call

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectservice_nameservice_familyReturns, by service family, the services that can be attached to the vRack. The eligibility check runs asynchronously: the route can be called several times until all the eligible services are returned.<br /><br />While the status is set to pending the results are partial.<br /><br />Once the status is set to done, all the eligible services have been found.<br /><br />In the eventuality of errors getting specific service types, the errors will be listed in the errors field.

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"}})
service_namestringThe internal name of your vrack (wire: serviceName)
service_familystringserviceFamily allows to filter on a specific service family (wire: serviceFamily)

SELECT examples​

Returns, by service family, the services that can be attached to the vRack. The eligibility check runs asynchronously: the route can be called several times until all the eligible services are returned.<br /><br />While the status is set to pending the results are partial.<br /><br />Once the status is set to done, all the eligible services have been found.<br /><br />In the eventuality of errors getting specific service types, the errors will be listed in the errors field.

SELECT
created_at,
errors,
result,
status
FROM ovh.vrack.eligible_services
WHERE service_name = '{{ service_name }}' -- required
AND service_family = '{{ service_family }}'
;