Skip to main content

service_tasks

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

Overview​

Nameservice_tasks
TypeResource
Idovh.email_exchange.service_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_nameGet a task. Returns the function, the status, the creation date (todoDate) and the completion date (finishDate) of the task.
listselectexchange_service, organization_namex_pagination_modeList service tasks. Returns the IDs of the tasks of the Exchange service. 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)
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_tasks
WHERE exchange_service = '{{ exchange_service }}' -- required
AND id = '{{ id }}' -- required
AND organization_name = '{{ organization_name }}' -- required
;