Skip to main content

parent_tenants

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

Overview​

Nameparent_tenants
TypeResource
Idovh.license_office_prepaid.parent_tenants

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
display_namestringTenant's display name (wire: displayName)
first_namestringContact's first name (wire: firstName)
last_namestringContact's last name (wire: lastName)
service_namestringTenant's service name (wire: serviceName)
addressstringContact's address line
citystringContact's city
creation_datestring (date-time)Creation date (wire: creationDate)
mca_agreedbooleanMCA acceptance status (wire: mcaAgreed)
phonestring (phone-number)Primary phone number
service_typestringTenant's service type (payAsYouGo, prepaid) (wire: serviceType)
statusstringTenant's status (creating, inMaintenance, ok, reopening, suspended, suspending)
zip_codestringContact's zip code (wire: zipCode)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectservice_nameReturns the tenant of the prepaid user: display name, contact details, service type, status, and whether the Microsoft Customer Agreement (MCA) is accepted. (Alpha version)
updateupdateservice_nameUpdates the display name of the tenant of the prepaid user. (Alpha version)
accept_agreementexecserviceNameAccepts the Microsoft Customer Agreement (MCA) for the parent tenant. (Alpha version)
create_attestationexecserviceNameCreates a Microsoft Customer Agreement attestation for the parent tenant from the signatory company, names, email address, phone number, country and language. Returns the attestation ID and a link to the attestation that can be embedded in an iframe. (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"}})
serviceNamestringService name
service_namestringService name (wire: serviceName)

SELECT examples​

Returns the tenant of the prepaid user: display name, contact details, service type, status, and whether the Microsoft Customer Agreement (MCA) is accepted. (Alpha version)

SELECT
display_name,
first_name,
last_name,
service_name,
address,
city,
creation_date,
mca_agreed,
phone,
service_type,
status,
zip_code
FROM ovh.license_office_prepaid.parent_tenants
WHERE service_name = '{{ service_name }}' -- required
;

UPDATE examples​

Updates the display name of the tenant of the prepaid user. (Alpha version)

UPDATE ovh.license_office_prepaid.parent_tenants
SET
display_name = '{{ display_name }}'
WHERE
service_name = '{{ service_name }}' --required;

Lifecycle Methods​

EXEC variables use wire (API) names.

Accepts the Microsoft Customer Agreement (MCA) for the parent tenant. (Alpha version)

EXEC ovh.license_office_prepaid.parent_tenants.accept_agreement
@serviceName='{{ serviceName }}' --required
;