rax_dns — Управление доменами в Rackspace Cloud DNS

Новое в версии 1.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Обзор

Управление доменами в Rackspace Cloud DNS

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Rackspace, переопределяет credentials. псевдонимы: password
auth_endpoint (добавлено в 1.5)	По умолчанию: https://identity.api.rackspacecloud.com/v2.0/	URI службы аутентификации.
comment		Краткое описание домена. Максимальная длина 160 символов
credentials	По умолчанию: None	Файл для поиска учетных данных Rackspace. Игнорируется, если заданы api_key и username. псевдонимы: creds_file
email		Электронный адрес администратора домена
env (добавлено в 1.5)		Окружение, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type (добавлено в 1.5)	По умолчанию: rackspace	Механизм аутентификации, например, rackspace или keystone.
name		Имя домена для создания
region	По умолчанию: DFW	Регион для создания экземпляра.
state	Варианты: present ← absent	Указывает желаемое состояние ресурса
tenant_id (добавлено в 1.5)		Идентификатор арендатора, используемый для аутентификации.
tenant_name (добавлено в 1.5)		Имя арендатора, используемого для аутентификации.
ttl	По умолчанию: 3600	Время жизни домена в секундах
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлено в 1.5)		Требовать ли проверку SSL для API-эндпоинтов.

Примечания

Примечание

Рекомендуется запускать плейбуки, использующие этот модуль, с 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/rax_dns_module.html