Skip to main content

account_sharepoints

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

Overview​

Nameaccount_sharepoints
TypeResource
Idovh.ms_services.account_sharepoints

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerSharepoint account id
active_directory_account_idintegerActive Directory Account id (wire: activeDirectoryAccountId)
task_pending_idintegerPending task for this sharepoint account (wire: taskPendingId)
access_rightsstringThe rights assigned to the sharepoint account (administrator, user) (wire: accessRights)
configuredbooleanIndicates if the account is configured
current_usageintegerOneDrive usage in byte (wire: currentUsage)
delete_at_expirationbooleandelete at expiration (wire: deleteAtExpiration)
licensestringSharepoint account license (foundation, standard)
office_licensebooleanoffice license is available (wire: officeLicense)
quotaintegerOneDrive maximum size in byte
statestringSharepoint account state (creating, deleting, disabled, modifying, ok, reopening, suspended, suspending)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectservice_name, user_principal_nameGet the account SharePoint information (Deprecated, will be removed)
updateupdateservice_name, user_principal_nameAlter this object properties (Deprecated, will be removed)
clear_spaceexecserviceName, userPrincipalNameOn-demand MySite clearance (Deprecated, will be removed)
configureexecserviceName, userPrincipalNameConfigure sharepoint account to be operational (Deprecated, will be removed)

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"}})
serviceNamestringThe internal name of your Active Directory organization
service_namestringThe internal name of your Active Directory organization (wire: serviceName)
userPrincipalNamestringUser Principal Name
user_principal_namestringUser Principal Name (wire: userPrincipalName)

SELECT examples​

Get the account SharePoint information (Deprecated, will be removed)

SELECT
id,
active_directory_account_id,
task_pending_id,
access_rights,
configured,
current_usage,
delete_at_expiration,
license,
office_license,
quota,
state
FROM ovh.ms_services.account_sharepoints
WHERE service_name = '{{ service_name }}' -- required
AND user_principal_name = '{{ user_principal_name }}' -- required
;

UPDATE examples​

Alter this object properties (Deprecated, will be removed)

UPDATE ovh.ms_services.account_sharepoints
SET
access_rights = '{{ access_rights }}',
delete_at_expiration = {{ delete_at_expiration }},
office_license = {{ office_license }}
WHERE
service_name = '{{ service_name }}' --required
AND user_principal_name = '{{ user_principal_name }}' --required;

Lifecycle Methods​

EXEC variables use wire (API) names.

On-demand MySite clearance (Deprecated, will be removed)

EXEC ovh.ms_services.account_sharepoints.clear_space
@serviceName='{{ serviceName }}' --required,
@userPrincipalName='{{ userPrincipalName }}' --required
;