Модуль hetzner.hcloud.zone_rrset — создание наборов записей зоны (Zone RRSet) и управление ими в Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Для установки используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.zone_rrset.

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

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

Создание, обновление и удаление наборов записей зоны (Zone RRSet) в Hetzner Cloud.
Дополнительные сведения см. в документации API наборов записей зоны (Zone RRSet).

Псевдонимы: hcloud_zone_rrset

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Также можно задать этот параметр с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Также можно задать этот параметр с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен для API Hetzner Cloud. Также можно задать этот параметр с помощью переменной окружения `HCLOUD_TOKEN`.
change_protection boolean	Защитить набор записей зоны от изменений (удаления и обновления). Варианты: `false` `true`
id integer	ID управляемого набора записей зоны. Требуется, только если не заданы `name` и `type` набора записей зоны.
labels dictionary	Пользовательские пары «ключ-значение».
name string	Имя управляемого набора записей зоны. Требуется, только если не задано `id` набора записей зоны или набор записей зоны не существует.
records list / элементы=dictionary	Записи набора записей зоны.
comment string	Комментарий к записи.
value string	Значение записи.
state string	Состояние набора записей зоны. Варианты: `"absent"` `"present"` ← (по умолчанию)
ttl integer	TTL набора записей зоны.
type string	Тип управляемого набора записей зоны. Требуется, только если не задано `id` набора записей зоны или набор записей зоны не существует.
zone string / обязательный	Имя или ID родительской зоны.

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Create a Zone RRSet
  hetzner.hcloud.zone_rrset:
    zone: example.com
    name: www
    type: A
    ttl: 300
    records:
      - value: 201.118.10.2
        comment: web server 1
      - value: 201.118.10.3
        comment: web server 2
    state: present

- name: Create a TXT record
  hetzner.hcloud.zone_rrset:
    zone: example.com
    name: "@"
    type: "TXT"
    records:
      - value: "{{ 'v=spf1 include:_spf.example.net ~all' | hetzner.hcloud.txt_record }}"
    state: present

- name: Delete a Zone RRSet
  hetzner.hcloud.zone_rrset:
    zone: 42
    name: www
    type: A
    state: absent

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

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

Ключ	Описание
hcloud_zone_rrset dictionary	Экземпляр набора записей зоны. Возвращается: всегда
change_protection boolean	Защита набора записей зоны от изменений (удаления и обновления). Возвращается: всегда Пример: `false`
id string	ID набора записей зоны. Возвращается: всегда Пример: `"www/A"`
labels dictionary	Пользовательские метки (пары «ключ-значение») Возвращается: всегда Пример: `{"key": "value"}`
name string	Имя набора записей зоны. Возвращается: всегда Пример: `"my-zone"`
records list / элементы=dictionary	Записи набора записей зоны. Возвращается: всегда
comment string	Комментарий к записи. Возвращается: всегда Пример: `"webserver 1"`
value string	Значение записи. Возвращается: всегда Пример: `"203.0.113.1"`
ttl integer	TTL набора записей зоны. Возвращается: всегда Пример: `3600`
type string	Тип набора записей зоны. Возвращается: всегда Пример: `"A"`
zone integer	ID родительской зоны. Возвращается: всегда Пример: `42`

Авторы

Jonas Lammler (@jooola)

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

© 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/hetzner/hcloud/zone_rrset_module.html