mailing_list_moderators

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

Overview

Name	mailing_list_moderators
Type	Resource
Id	ovh.email_domain.mailing_list_moderators

Fields

The following fields are returned by SELECT queries:

get

successful operation

Name	Datatype	Description
domain	string
email	string
mailinglist	string

list

Moderators List

Name	Datatype	Description
domain	string
email	string
mailinglist	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	domain, email, name		Get a moderator. Returns the email address of the moderator and the mailing list and domain it moderates.
list	select	domain, name	email, x_pagination_mode	List moderators. Returns the email addresses of the moderators of the mailing list. Filter them by email.
create	insert	domain, name, email		Add a moderator. Makes the email address a moderator of the mailing list, who approves the messages, and returns the task.
delete	delete	domain, email, name		Remove a moderator. Withdraws the moderator role from the email address on the mailing list, 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	string	Name of your domain name
email	string
name	string	Name of mailing list
email	string	Moderator email
x_pagination_mode	string	Sent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples

get

Get a moderator. Returns the email address of the moderator and the mailing list and domain it moderates.

SELECT
domain,
email,
mailinglist
FROM ovh.email_domain.mailing_list_moderators
WHERE domain = '{{ domain }}' -- required
AND email = '{{ email }}' -- required
AND name = '{{ name }}' -- required
;

list

List moderators. Returns the email addresses of the moderators of the mailing list. Filter them by email.

SELECT
domain,
email,
mailinglist
FROM ovh.email_domain.mailing_list_moderators
WHERE domain = '{{ domain }}' -- required
AND name = '{{ name }}' -- required
AND email = '{{ email }}'
AND x_pagination_mode = '{{ x_pagination_mode }}'
;

INSERT examples

create

Add a moderator. Makes the email address a moderator of the mailing list, who approves the messages, and returns the task.

INSERT INTO ovh.email_domain.mailing_list_moderators (
email,
domain,
name
)
SELECT 
'{{ email }}' /* required */,
'{{ domain }}',
'{{ name }}'
RETURNING
id,
account,
action,
date,
domain,
language
;

Manifest

# Description fields are for documentation purposes
- name: mailing_list_moderators
props:
  - name: domain
    value: "{{ domain }}"
    description: Required parameter for the mailing_list_moderators resource.
  - name: name
    value: "{{ name }}"
    description: Required parameter for the mailing_list_moderators resource.
  - name: email
    value: "{{ email }}"
    description: |
      Email of moderator

DELETE examples

delete

Remove a moderator. Withdraws the moderator role from the email address on the mailing list, and returns the task.

DELETE FROM ovh.email_domain.mailing_list_moderators
WHERE domain = '{{ domain }}' --required
AND email = '{{ email }}' --required
AND name = '{{ name }}' --required
;