Skip to main content

service_account_tasks

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

Overview​

Nameservice_account_tasks
TypeResource
Idovh.email_exchange.service_account_tasks

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idintegerTask id
finish_datestring (date-time)Completion date (wire: finishDate)
functionstringFunction name (activateSharepoint, addAccount, addAccountArchive, addAccountImpersonation, addActiveSyncMailNotification, addAlias, addDistributionGroup, addDistributionGroupManager, addDistributionGroupMember, addDistributionGroupSendAs, addDistributionGroupSendOnBehalfTo, addDomain, addDomainDisclaimer, addExchangeCustomIsolation, addExchangeDomainDKIM, addExchangeRemoteMailbox, addExchangeServiceAuthorizedIp, addExportPstRequest, addExternalContact, addFullAccess, addOutlookLicense, addPublicFolder, addPublicFolderPermission, addResourceAccount, addResourceDelegate, addSendAs, addSendConnector, addSendOnBehalfTo, addSharedAccount, addSharedAccountFullAccess, addSharedAccountSendAs, addSharedAccountSendOnBehalfTo, changeHostname, changePassword, clearDataOnDevice, cloneTemplateExchangePrivate, configureExchangeCustomer, configureExchangeOwaMfa, copyMailbox, createExternalAntiSpamReceiveConnector, deleteAccount, deleteAccountArchive, deleteAccountImpersonation, deleteActiveSyncMailNotification, deleteAlias, deleteDistributionGroup, deleteDistributionGroupManager, deleteDistributionGroupMember, deleteDistributionGroupSendAs, deleteDistributionGroupSendOnBehalfTo, deleteDomain, deleteDomainDisclaimer, deleteExchangeCustomIsolation, deleteExchangeDomainDKIM, deleteExchangeRemoteMailbox, deleteExchangeService, deleteExchangeServiceAuthorizedIp, deleteExportPstRequest, deleteExternalAntiSpamReceiveConnector, deleteExternalContact, deleteFullAccess, deleteOutlookLicense, deletePublicFolder, deletePublicFolderPermission, deleteResourceAccount, deleteResourceDelegate, deleteSendAs, deleteSendConnector, deleteSendOnBehalfTo, deleteSharedAccount, deleteSharedAccountFullAccess, deleteSharedAccountSendAs, deleteSharedAccountSendOnBehalfTo, destroyPrivateVm, diagnoseAccount, disableExchangeDKIM, enableExchangeDKIM, expandDrive, generateOutlookUrl, generatePstUrl, installExchange, installSSL, maintenance, migrationAccount, migrationDisclaimer, migrationExternalContact, migrationHistory, migrationMailingList, migrationResourceAccount, migrationService, reOpenHostedAccount, reOpenOutlookLicense, reOpenPrivateAccount, reOpenPrivateVm, setAccount, setAccountArchive, setAlias, setDistributionGroup, setDns, setDomain, setDomainDisclaimer, setExchangeAccountProtocol, setExchangeRemoteMailbox, setExchangeServiceDevice, setExternalAntiSpamReceiveConnector, setExternalContact, setPublicFolder, setPublicFolderPermission, setResourceAccount, setSendConnector, setService, setSharedAccount, suspendAccount, suspendExchangeService, suspendHostedAccount, suspendOutlookLicense, suspendPrivateAccount, suspendPrivateVm, unsuspendAccount, unsuspendExchangeService, unsuspendHostedAccount, updateExchangeServiceDevice, upgrade2016)
statusstringTask status (canceled, doing, done, error, standby, todo)
todo_datestring (date-time)Creation date (wire: todoDate)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectexchange_service, id, organization_name, primary_email_addressGet a task. Returns the function, the status, the creation date (todoDate) and the completion date (finishDate) of the task.
listselectexchange_service, organization_name, primary_email_addressx_pagination_modeList email account tasks. Returns the IDs of the tasks of the email account. Get one to follow its function, status and dates.

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"}})
exchange_servicestringThe internal name of your exchange service (wire: exchangeService)
idintegerTask id
organization_namestringThe internal name of your exchange organization (wire: organizationName)
primary_email_addressstringDefault email for this mailbox (wire: primaryEmailAddress)
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 a task. Returns the function, the status, the creation date (todoDate) and the completion date (finishDate) of the task.

SELECT
id,
finish_date,
function,
status,
todo_date
FROM ovh.email_exchange.service_account_tasks
WHERE exchange_service = '{{ exchange_service }}' -- required
AND id = '{{ id }}' -- required
AND organization_name = '{{ organization_name }}' -- required
AND primary_email_address = '{{ primary_email_address }}' -- required
;