azure.azcollection.azure_rm_dnsrecordset – Создание, удаление и обновление наборов и записей DNS
Примечание
Этот плагин входит в коллекцию azure.azcollection (версия 1.3.1).
Для его установки используйте: ansible-galaxy collection install azure.azcollection.
Для использования в книге задач, укажите: azure.azcollection.azure_rm_dnsrecordset.
Добавлен в версии 0.1.0: коллекции azure.azcollection
Описание
- Создаёт, удаляет и обновляет наборы и записи DNS в существующей зоне Azure DNS.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- azure >= 2.0.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| ad_user строка | Имя пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы. | ||
| adfs_authority_url строка добавлен в 0.0.1 коллекции azure.azcollection | URL авторизации Azure AD. Используется при аутентификации с именем пользователя/паролем и собственной авторизацией ADFS. | ||
| api_profile строка добавлен в 0.0.1 коллекции azure.azcollection | По умолчанию: "latest" | Выбирает профиль API для взаимодействия с Azure-сервисами. Значение по умолчанию latest подходит для общедоступных облаков; будущие значения позволят использовать Azure Stack. | |
| append_tags логическое значение |
| Управление тем, является ли поле тегов каноническим или просто добавляет теги к существующим. При каноническом виде любые теги, отсутствующие в параметре тегов, будут удалены из метаданных объекта. | |
| auth_source строка добавлен в 0.0.1 коллекции azure.azcollection |
| Управляет источником учетных данных для аутентификации. Также может быть задан через переменную окружения ANSIBLE_AZURE_AUTH_SOURCE.При значении auto (значение по умолчанию) приоритет: параметры модуля -> env -> credential_file -> cli.При значении env, учетные данные будут считываться из переменных среды.При значении credential_file, профиль будет считан из ~/.azure/credentials.При значении cli, учетные данные будут взяты из профиля Azure CLI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID может быть использована для идентификации идентификатора подписки, если их несколько, иначе используется стандартная подписка az cli.При значении msi, хост-машина должна быть Azure-ресурсом с включенным расширением MSI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID может быть использована для идентификации идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, иначе выбирается первая подписка.msi был добавлен в Ansible 2.6. | |
| cert_validation_mode строка добавлен в 0.0.1 коллекции azure.azcollection |
| Управляет поведением проверки сертификатов для Azure-точек входа. По умолчанию все модули будут проверять серверный сертификат, но при использовании прокси-сервера HTTPS или работе с Azure Stack может потребоваться отключить это поведение, передав ignore. Также может быть задан в файле профиля учетных данных или в переменной среды AZURE_CERT_VALIDATION. | |
| client_id строка | Идентификатор клиента Azure. Используется при аутентификации с принципалом службы. | ||
| cloud_environment строка добавлен в 0.0.1 коллекции azure.azcollection | По умолчанию: "AzureCloud" | Для облачных сред, отличных от общедоступного облака США, используется имя среды (как определено Azure Python SDK, например, AzureChinaCloud, AzureUSGovernment), или URL конечной точки обнаружения метаданных (требуется для Azure Stack). Также может быть задан в профиле файла учетных данных или в переменной среды AZURE_CLOUD_ENVIRONMENT. | |
| password строка | Пароль пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы. | ||
| profile строка | Профиль безопасности, найденный в файле ~/.azure/credentials. | ||
| record_mode строка |
| Удаление существующих значений записей, не отправленных в модуль. | |
| record_type строка / обязательный |
| Тип набора записей для создания или удаления. | |
| records строка | Список записей для создания, в зависимости от типа записи (набора). | ||
| entry строка | Основное значение данных для всех типов записей. | ||
| port строка | Используется для создания набора/записей типа SRV. | ||
| preference строка | Используется для создания набора/записей типа MX. | ||
| priority строка | Используется для создания набора/записей типа SRV. | ||
| weight строка | Используется для создания набора/записей типа SRV. | ||
| relative_name строка / обязательный | Относительное имя набора записей. | ||
| resource_group строка / обязательный | Имя группы ресурсов. | ||
| secret строка | Секретный ключ клиента Azure. Используется при аутентификации с принципалом службы. | ||
| state строка |
| Устанавливает состояние набора записей. Используйте present для создания или обновления и absent для удаления. | |
| subscription_id строка | Ваш идентификатор подписки Azure. | ||
| tags словарь | Словарь пар «строка:строка» для назначения метаданных объекту. Метаданные тегов объекта будут обновлены с любыми предоставленными значениями. Для удаления тегов установите параметр append_tags в false. | ||
| tenant строка | Идентификатор Azure-арендатора. Используется при аутентификации с принципалом службы. | ||
| time_to_live строка | По умолчанию: 3600 | Время жизни набора записей в секундах. | |
| zone_name строка / обязательный | Имя существующей зоны DNS, в которой нужно управлять набором записей. | ||
Примечания
Примечание
- Для аутентификации с Azure можно передать параметры, задать переменные среды, использовать профиль, сохранённый в ~/.azure/credentials, или войти в систему перед выполнением задач или книги задач с помощью
az login. - Аутентификация также возможна с помощью принципала службы или пользователя Active Directory.
- Для аутентификации через принципала службы передайте subscription_id, client_id, secret и tenant или установите переменные среды AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET и AZURE_TENANT.
- Для аутентификации через пользователя Active Directory передайте ad_user и password или установите AZURE_AD_USER и AZURE_PASSWORD в среде.
- В качестве альтернативы учетные данные можно сохранить в ~/.azure/credentials. Это файл ini, содержащий раздел [default] и следующие ключи: subscription_id, client_id, secret и tenant или subscription_id, ad_user и password. Также можно добавить дополнительные профили. Укажите профиль, передав profile или установив AZURE_PROFILE в среде.
См. также
См. также
- Вход в Azure CLI
-
Как войти с помощью команды
az login.
Примеры
- name: ensure an "A" record set with multiple records
azure_rm_dnsrecordset:
resource_group: myResourceGroup
relative_name: www
zone_name: testing.com
record_type: A
records:
- entry: 192.168.100.101
- entry: 192.168.100.102
- entry: 192.168.100.103
- name: delete a record set
azure_rm_dnsrecordset:
resource_group: myResourceGroup
record_type: A
relative_name: www
zone_name: testing.com
state: absent
- name: create multiple "A" record sets with multiple records
azure_rm_dnsrecordset:
resource_group: myResourceGroup
zone_name: testing.com
relative_name: "{{ item.name }}"
record_type: "{{ item.type }}"
records: "{{ item.records }}"
with_items:
- { name: 'servera', type: 'A', records: [ { entry: '10.10.10.20' }, { entry: '10.10.10.21' }] }
- { name: 'serverb', type: 'A', records: [ { entry: '10.10.10.30' }, { entry: '10.10.10.41' }] }
- { name: 'serverc', type: 'A', records: [ { entry: '10.10.10.40' }, { entry: '10.10.10.41' }] }
- name: create SRV records in a new record set
azure_rm_dnsrecordset:
resource_group: myResourceGroup
relative_name: _sip._tcp.testing.com
zone_name: testing.com
time_to_live: 7200
record_type: SRV
records:
- entry: sip.testing.com
preference: 10
priority: 20
weight: 10
port: 5060
- name: create PTR record in a new record set
azure_rm_dnsrecordset:
resource_group: myResourceGroup
relative_name: 192.168.100.101.in-addr.arpa
zone_name: testing.com
record_type: PTR
records:
- entry: servera.testing.com
- name: create TXT record in a new record set
azure_rm_dnsrecordset:
resource_group: myResourceGroup
relative_name: mail.testing.com
zone_name: testing.com
record_type: TXT
records:
- entry: 'v=spf1 a -all'
Авторы
- Obezimnaka Boms (@ozboms)
- Matt Davis (@nitzmahone)
При разборе документации для этого плагина были обнаружены некоторые ошибки. Пожалуйста, отправьте сообщение об ошибке в коллекцию.
Ошибки:
-
Unable to normalize azure_rm_dnsrecordset: return due to: 7 validation errors for PluginReturnSchema return -> state -> contains -> arecords -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> etag -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> fqdn -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> provisioning_state -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> target_resource -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> ttl -> return extra fields not permitted (type=value_error.extra) return -> state -> contains -> type -> return extra fields not permitted (type=value_error.extra)
© 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/azure/azcollection/azure_rm_dnsrecordset_module.html