service_domain_disclaimers

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

Overview

Name	service_domain_disclaimers
Type	Resource
Id	ovh.email_exchange.service_domain_disclaimers

Fields

The following fields are returned by SELECT queries:

get

successful operation

Name	Datatype	Description
name	string	Disclaimer name
task_pending_id	integer	task pending id (wire: taskPendingId)
content	string	Signature, added at the bottom of your organization emails
creation_date	string (date-time)	Creation date (wire: creationDate)
outside_only	boolean	Activate the disclaimer only for external emails (wire: outsideOnly)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	domain_name, exchange_service, organization_name		Get the disclaimer. Returns the content of the disclaimer added to the emails of the domain, and whether it applies to external emails only.
create	insert	domain_name, exchange_service, organization_name, content		Create a disclaimer. Adds a disclaimer at the bottom of the emails of the domain, and returns the task. Set outsideOnly to add it to external emails only. Insert Active Directory attributes in content as %%AttributeName%%.
update	update	domain_name, exchange_service, organization_name		Update the disclaimer. Updates the content of the disclaimer and outsideOnly, which limits it to external emails. Insert Active Directory attributes in content as %%AttributeName%%.
delete	delete	domain_name, exchange_service, organization_name		Delete the disclaimer. Removes the disclaimer of the domain, so that it is no longer added to the emails sent from it, and returns the task.

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.

Name	Datatype	Description
api_host	string	The 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"}})
domain_name	string	Domain name (wire: domainName)
exchange_service	string	The internal name of your exchange service (wire: exchangeService)
organization_name	string	The internal name of your exchange organization (wire: organizationName)

SELECT examples

get

Get the disclaimer. Returns the content of the disclaimer added to the emails of the domain, and whether it applies to external emails only.

SELECT
name,
task_pending_id,
content,
creation_date,
outside_only
FROM ovh.email_exchange.service_domain_disclaimers
WHERE domain_name = '{{ domain_name }}' -- required
AND exchange_service = '{{ exchange_service }}' -- required
AND organization_name = '{{ organization_name }}' -- required
;

INSERT examples

create

Create a disclaimer. Adds a disclaimer at the bottom of the emails of the domain, and returns the task. Set outsideOnly to add it to external emails only. Insert Active Directory attributes in content as %%AttributeName%%.

INSERT INTO ovh.email_exchange.service_domain_disclaimers (
content,
outside_only,
domain_name,
exchange_service,
organization_name
)
SELECT 
'{{ content }}' /* required */,
{{ outside_only }},
'{{ domain_name }}',
'{{ exchange_service }}',
'{{ organization_name }}'
RETURNING
id,
finish_date,
function,
status,
todo_date
;

Manifest

# Description fields are for documentation purposes
- name: service_domain_disclaimers
props:
  - name: domain_name
    value: "{{ domain_name }}"
    description: Required parameter for the service_domain_disclaimers resource.
  - name: exchange_service
    value: "{{ exchange_service }}"
    description: Required parameter for the service_domain_disclaimers resource.
  - name: organization_name
    value: "{{ organization_name }}"
    description: Required parameter for the service_domain_disclaimers resource.
  - name: content
    value: "{{ content }}"
    description: |
      Signature, added at the bottom of your organization emails
  - name: outside_only
    value: {{ outside_only }}
    description: |
      Activate the disclaimer only for external emails

UPDATE examples

update

Update the disclaimer. Updates the content of the disclaimer and outsideOnly, which limits it to external emails. Insert Active Directory attributes in content as %%AttributeName%%.

UPDATE ovh.email_exchange.service_domain_disclaimers
SET 
content = '{{ content }}',
outside_only = {{ outside_only }}
WHERE 
domain_name = '{{ domain_name }}' --required
AND exchange_service = '{{ exchange_service }}' --required
AND organization_name = '{{ organization_name }}' --required;

DELETE examples

delete

Delete the disclaimer. Removes the disclaimer of the domain, so that it is no longer added to the emails sent from it, and returns the task.

DELETE FROM ovh.email_exchange.service_domain_disclaimers
WHERE domain_name = '{{ domain_name }}' --required
AND exchange_service = '{{ exchange_service }}' --required
AND organization_name = '{{ organization_name }}' --required
;