Модуль community.general.memset_zone_record — создание и удаление записей в зонах DNS Memset

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать коллекцию в плейбуке, укажите: community.general.memset_zone_record.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управление записями DNS в учетной записи Memset.

Параметры

Параметр	Комментарии
address псевдонимы: ip, data строка / обязательный	Адрес этой записи (может быть IP-адресом или текстовой строкой, в зависимости от типа записи).
api_key строка / обязательный	Ключ API, полученный в панели управления Memset.
priority целое число	Приоритет записи `SRV` и `TXT` в диапазоне от 0 до 999 (включительно). По умолчанию: `0`
record строка	Создаваемый поддомен. По умолчанию: `""`
relative логический	Если параметр установлен, текущий домен добавляется к полю address для записей типов `CNAME`, `MX`, `NS` и `SRV`. Варианты: `false` ← (по умолчанию) `true`
state строка	Указывает требуемое состояние ресурса. Варианты: `"absent"` `"present"` ← (по умолчанию)
ttl целое число	TTL записи в секундах (если не задан явно, используется TTL зоны). Значение должно быть допустимым целым числом согласно https://www.memset.com/apidocs/methods_dns.html#dns.zone_record_create. Варианты: `0` ← (по умолчанию) `300` `600` `900` `1800` `3600` `7200` `10800` `21600` `43200` `86400`
type строка / обязательный	Тип создаваемой записи DNS. Варианты: `"A"` `"AAAA"` `"CNAME"` `"MX"` `"NS"` `"SRV"` `"TXT"`
zone строка / обязательный	Имя зоны, в которую нужно добавить запись.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения статуса, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

Зоны можно рассматривать как логическую группу доменов, у которых общие записи DNS (то есть они указывают на один и тот же IP-адрес). Требуется ключ API, созданный в панели управления клиента Memset, с минимальными следующими разрешениями: dns.zone_create, dns.zone_delete, dns.zone_list.
В настоящее время этот модуль может создавать только одну запись DNS за раз. Для создания нескольких записей используйте loop.

Примеры

# Create DNS record for www.domain.com
- name: Create DNS record
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    state: present
    zone: domain.com
    type: A
    record: www
    address: 1.2.3.4
    ttl: 300
    relative: false
  delegate_to: localhost

# create an SPF record for domain.com
- name: Create SPF record for domain.com
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    state: present
    zone: domain.com
    type: TXT
    address: "v=spf1 +a +mx +ip4:a1.2.3.4 ?all"
  delegate_to: localhost

# create multiple DNS records
- name: Create multiple DNS records
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    zone: "{{ item.zone }}"
    type: "{{ item.type }}"
    record: "{{ item.record }}"
    address: "{{ item.address }}"
  delegate_to: localhost
  with_items:
    - {'zone': 'domain1.com', 'type': 'A', 'record': 'www', 'address': '1.2.3.4'}
    - {'zone': 'domain2.com', 'type': 'A', 'record': 'mail', 'address': '4.3.2.1'}

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
memset_api сложный тип	Информация о записи из API Memset. Возвращается: когда state == present
address строка	Содержимое записи (может быть IP-адресом, строкой или пустым значением в зависимости от типа записи). Возвращается: всегда Пример: `"1.1.1.1"`
id строка	Идентификатор записи. Возвращается: всегда Пример: `"b0bb1ce851aeea6feeb2dc32fe83bf9c"`
priority целое число	Приоритет записей `MX` и `SRV`. Возвращается: всегда Пример: `10`
record строка	Имя записи. Возвращается: всегда Пример: `"www"`
relative логический	Добавляет текущий домен к полю address для записей типов `CNAME`, `MX`, `NS` и `SRV`. Возвращается: всегда Пример: `false`
ttl целое число	TTL записи. Возвращается: всегда Пример: `10`
type строка	Тип записи. Возвращается: всегда Пример: `"AAAA"`
zone_id строка	Идентификатор зоны. Возвращается: всегда Пример: `"b0bb1ce851aeea6feeb2dc32fe83bf9c"`

Авторы

Simon Weald (@glitchcrab)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/memset_zone_record_module.html