theforeman.foreman.domain – Управление доменами
Примечание
Этот плагин является частью коллекции theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в playbook, укажите: theforeman.foreman.domain.
Новое в версии 1.0.0: of theforeman.foreman
Описание
- Создание, обновление и удаление доменов
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Полное имя, описывающее домен псевдонимы: fullname | ||
| dns_proxy строка | DNS-прокси, используемый в данном домене для управления записями A псевдонимы: dns | ||
| locations список / элементы=строка | Список локаций, к которым должна быть присвоена сущность | ||
| name строка / обязательно | Полное доменное имя DNS | ||
| organizations список / элементы=строка | Список организаций, к которым должна быть присвоена сущность | ||
| parameters список / элементы=словарь | Параметры хоста, специфичные для домена | ||
| name строка / обязательно | Имя параметра | ||
| parameter_type строка |
| Тип параметра | |
| value сырой / обязательно | Значение параметра | ||
| password строка / обязательно | Пароль пользователя, осуществляющего доступ к серверу Foreman. Если значение не указано в задании, будет использовано значение переменной среды FOREMAN_PASSWORD. | ||
| server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задании, будет использовано значение переменной среды FOREMAN_SERVER_URL. | ||
| state строка |
| Состояние сущности | |
| updated_name строка | Новое имя домена. При установке этого параметра модуль не будет идемпотентным. | ||
| username строка / обязательно | Имя пользователя, осуществляющего доступ к серверу Foreman. Если значение не указано в задании, будет использовано значение переменной среды FOREMAN_USERNAME. | ||
| validate_certs boolean |
| Подтверждать ли сертификаты TLS сервера Foreman. Если значение не указано в задании, будет использовано значение переменной среды FOREMAN_VALIDATE_CERTS. | |
Примеры
- name: domain
theforeman.foreman.domain:
name: "example.org"
description: "Example Domain"
locations:
- "Munich"
organizations:
- "ACME"
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| entity словарь | success | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| domains список / элементы=словарь | success | Список доменов. | |
Авторы
- Markus Bucher (@m-bucher) ATIX AG
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/domain_module.html