Spec-Zone.ru › Ansible

Модуль openstack.cloud.recordset — управление наборами DNS-записей OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.recordset.

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

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

  • Управление наборами DNS-записей OpenStack. Наборы записей можно создавать, удалять и обновлять. Обновлять можно только значения records, description и ttl.

Требования

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

  • python >= 3.6
  • openstacksdk >= 1.0.0

Параметры

Параметр

Комментарии

api_timeout

integer

Время ожидания сокетного уровня перед истечением времени ожидания вызовов API. Если параметр не указан, библиотеке requests ничего не передаётся.

auth

dictionary

Словарь с данными аутентификации, необходимыми для используемой облачной стратегии плагина аутентификации. Для плагина password, используемого по умолчанию, в него входят auth_url, username, password, project_name и сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые соответствующему плагину аутентификации. Этот параметр не требуется, если указано именованное облако или заданы переменные среды OpenStack OS_*.

auth_type

string

Имя используемого плагина аутентификации. Если облако использует не аутентификацию по паролю, здесь следует указать имя плагина и соответствующим образом изменить содержимое параметра auth.

ca_cert

псевдонимы: cacert

string

Путь к пакету сертификатов центра сертификации, который можно использовать для проверки запросов API SSL.

client_cert

псевдонимы: cert

string

Путь к сертификату клиента, используемому при SSL-соединении.

client_key

псевдонимы: key

string

Путь к ключу клиента, используемому при SSL-соединении.

cloud

any

Именованное облако или конфигурация облака, с которым нужно работать. Если cloud — строка, она указывает на конфигурацию именованного облака, определённую в файле OpenStack clouds.yaml. Параметр задаёт значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или заданы переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе файла clouds.yaml.

description

string

Описание набора записей

interface

псевдонимы: endpoint_type

string

Тип URL конечной точки, получаемой из каталога служб.

Варианты:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

name

string / обязательный

Имя набора записей. Оно должно заканчиваться именем DNS-зоны.

records

list / элементы=string

Список определений набора записей.

Обязателен, если state=present.

recordset_type

string

Тип набора записей

Обязателен, если state=present.

Варианты:

  • "a"
  • "aaaa"
  • "mx"
  • "cname"
  • "txt"
  • "ns"
  • "srv"
  • "ptr"
  • "caa"

region_name

string

Имя региона.

sdk_log_level

string

Уровень ведения журнала OpenStackSDK

Варианты:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

string

Путь к файлу журнала OpenStackSDK. Если путь не указан, журнал не ведётся.

state

string

Должен ли ресурс присутствовать или отсутствовать.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeout

integer

Сколько времени Ansible должен ожидать запрошенный ресурс.

По умолчанию: 180

ttl

integer

Значение TTL (время жизни) в секундах

validate_certs

псевдонимы: verify

boolean

Следует ли проверять запросы API SSL.

До Ansible 2.3 значением по умолчанию было true.

Варианты:

  • false
  • true

wait

boolean

Должен ли Ansible ожидать завершения обработки запрошенного ресурса.

Варианты:

  • false
  • true ← (по умолчанию)

zone

string / обязательный

Имя или ID зоны, управляющей набором записей

Примечания

Примечание

  • Вместо явного указания значений можно использовать стандартные переменные среды OpenStack, например OS_USERNAME.
  • Данные аутентификации обрабатываются openstacksdk. Это означает, что значения могут поступать из файла конфигурации YAML /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды и, наконец, из явных параметров плейбука. Подробнее см. на странице https://docs.openstack.org/openstacksdk/

Примеры

# Create a recordset named "www.example.net."
- openstack.cloud.recordset:
    cloud: mycloud
    state: present
    zone: example.net.
    name: www.example.net.
    recordset_type: "a"
    records: ['10.1.1.1']
    description: test recordset
    ttl: 3600

# Update the TTL on existing "www.example.net." recordset
- openstack.cloud.recordset:
    cloud: mycloud
    state: present
    zone: example.net.
    name: www.example.net.
    recordset_type: "a"
    records: ['10.1.1.1']
    ttl: 7200

# Delete recordset named "www.example.net."
- openstack.cloud.recordset:
    cloud: mycloud
    state: absent
    zone: example.net.
    name: www.example.net.

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

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

Ключ

Описание

recordset

dictionary

Словарь с описанием набора записей.

Возвращается: при успешном выполнении, если state имеет значение ‘present’.

action

string

Текущее выполняемое действие над ресурсом

Возвращается: всегда

created_at

string

Временная метка создания зоны

Возвращается: всегда

description

string

Описание набора записей

Возвращается: всегда

Пример: "Test description"

id

string

Уникальный идентификатор набора записей

Возвращается: при успешном выполнении

Пример: "c1c530a3-3619-46f3-b0f6-236927b2618c"

links

dictionary

Ссылки, связанные с ресурсом

Возвращается: всегда

name

string

Имя набора записей

Возвращается: всегда

Пример: "www.example.net."

project_id

string

ID проекта, которому принадлежит набор записей

Возвращается: всегда

records

list / элементы=string

Записи набора записей

Возвращается: всегда

Пример: ["10.0.0.1"]

status

string

Статус набора записей

Допустимые значения: `PENDING_CREATE`, `ACTIVE`,`PENDING_DELETE`, `ERROR`

Возвращается: всегда

ttl

integer

Значение TTL зоны

Возвращается: всегда

Пример: 3600

type

string

Тип набора записей

Допустимые значения: `A`, `AAAA`, `MX`, `CNAME`, `TXT`, `NS`, `SSHFP`, `SPF`, `SRV`, `PTR`

Возвращается: всегда

Пример: "A"

zone_id

string

ID зоны, которой принадлежит этот набор записей

Возвращается: всегда

Пример: "9508e177-41d8-434e-962c-6fe6ca880af7"

zone_name

string

Имя зоны, которой принадлежит этот набор записей

Возвращается: всегда

Пример: "example.com."

Авторы

  • Специальная группа Ansible OpenStack

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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/openstack/cloud/recordset_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API