Skip to main content

service_account_protocols

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

Overview​

Nameservice_account_protocols
TypeResource
Idovh.email_exchange.service_account_protocols

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
task_pending_idintegerPending task id (wire: taskPendingId)
active_syncbooleanMobile access enabled on that mailbox (wire: activeSync)
creation_datestring (date-time)Creation date (wire: creationDate)
imapbooleanIMAP protocol enabled on that mailbox (wire: IMAP)
last_updatestring (date-time)Last update date (wire: lastUpdate)
popbooleanPOP protocol enabled on that mailbox (wire: POP)
web_mailbooleanWeb mail enabled on that mailbox (wire: webMail)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectexchange_service, organization_name, primary_email_addressGet the account protocols. Returns whether POP, IMAP, webmail and ActiveSync are enabled on the email account.
updateupdateexchange_service, organization_name, primary_email_addressUpdate the account protocols. Enables or disables POP, IMAP, webmail and ActiveSync on the email account.

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)
organization_namestringThe internal name of your exchange organization (wire: organizationName)
primary_email_addressstringDefault email for this mailbox (wire: primaryEmailAddress)

SELECT examples​

Get the account protocols. Returns whether POP, IMAP, webmail and ActiveSync are enabled on the email account.

SELECT
task_pending_id,
active_sync,
creation_date,
imap,
last_update,
pop,
web_mail
FROM ovh.email_exchange.service_account_protocols
WHERE exchange_service = '{{ exchange_service }}' -- required
AND organization_name = '{{ organization_name }}' -- required
AND primary_email_address = '{{ primary_email_address }}' -- required
;

UPDATE examples​

Update the account protocols. Enables or disables POP, IMAP, webmail and ActiveSync on the email account.

UPDATE ovh.email_exchange.service_account_protocols
SET
imap = {{ imap }},
pop = {{ pop }},
active_sync = {{ active_sync }},
web_mail = {{ web_mail }}
WHERE
exchange_service = '{{ exchange_service }}' --required
AND organization_name = '{{ organization_name }}' --required
AND primary_email_address = '{{ primary_email_address }}' --required;