community.general.rax_dns – Управление доменами в Rackspace Cloud DNS
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.rax_dns.
Обзор
- Управление доменами в Rackspace Cloud DNS
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется данный модуль.
- pyrax
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key строка | Ключ API Rackspace, переопределяет credentials. псевдонимы: password | |
| auth_endpoint строка | URI сервиса аутентификации. Если не указан, будет установлен по умолчанию на https://identity.api.rackspacecloud.com/v2.0/
| |
| comment строка | Краткое описание домена. Максимальная длина 160 символов | |
| credentials путь | Файл с данными учетной записи Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file | |
| email строка | Адрес электронной почты администратора домена | |
| env строка | Окружение, настроенное в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration. | |
| identity_type строка | По умолчанию: "rackspace" | Механизм аутентификации, например, rackspace или keystone. |
| name строка | Имя домена для создания | |
| region строка | Регион для создания экземпляра. | |
| state строка |
| Указывает желаемое состояние ресурса |
| tenant_id строка | Идентификатор клиента, используемый для аутентификации. | |
| tenant_name строка | Имя клиента, используемое для аутентификации. | |
| ttl целое число | По умолчанию: 3600 | Время жизни домена в секундах |
| username строка | Имя пользователя Rackspace, переопределяет credentials. | |
| validate_certs логическое |
| Требовать ли проверку SSL API-точек доступа. псевдонимы: verify_ssl |
Примечания
Примечание
- Рекомендуется запускать плейбуки с использованием этого модуля с
serial: 1для предотвращения превышения лимита запросов API, накладываемого API Rackspace CloudDNS - Можно использовать следующие переменные окружения:
RAX_USERNAME,RAX_API_KEY,RAX_CREDS_FILE,RAX_CREDENTIALS,RAX_REGION. -
RAX_CREDENTIALSиRAX_CREDS_FILEуказывают на файл с данными учетной записи, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating -
RAX_USERNAMEиRAX_API_KEYисключают необходимость использования файла с данными учетной записи -
RAX_REGIONопределяет регион Rackspace Public Cloud (DFW, ORD, LON, …) - Можно использовать следующие переменные окружения:
RAX_USERNAME,RAX_API_KEY,RAX_CREDS_FILE,RAX_CREDENTIALS,RAX_REGION. -
RAX_CREDENTIALSиRAX_CREDS_FILEуказывают на файл с данными учетной записи, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating -
RAX_USERNAMEиRAX_API_KEYисключают необходимость использования файла с данными учетной записи -
RAX_REGIONопределяет регион Rackspace Public Cloud (DFW, ORD, LON, …)
Примеры
- name: Create domain
hosts: all
gather_facts: False
tasks:
- name: Domain create request
local_action:
module: rax_dns
credentials: ~/.raxpub
name: example.org
email: admin@example.org
register: rax_dns
Авторы
- Matt Martz (@sivel)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/rax_dns_module.html