azure_rm_dnsrecordset_facts - Получение фактов DNS-набора записей.
Новая версия с 2.4.
- Описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Получение фактов для определенного DNS-набора записей в зоне, определенного типа во всех зонах или в одной зоне и т. д.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.7
- azure >= 2.0.0
Параметры
| параметр | обязателен | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| ad_user |
нет | Имя пользователя Active Directory. Используется при аутентификации с пользователем Active Directory вместо службы-принципала. |
||
| client_id |
нет | Идентификатор клиента Azure. Используется при аутентификации с помощью службы-принципала. |
||
| cloud_environment |
нет | AzureCloud | Для облачных сред, отличных от общедоступного облака США, имя среды (как определено в Azure Python SDK, например, AzureChinaCloud, AzureUSGovernment), или URL-адрес конечной точки обнаружения метаданных (необходим для Azure Stack). Также может быть задан через профиль файла учетных данных или переменную среды AZURE_CLOUD_ENVIRONMENT. |
|
| password |
нет | Пароль пользователя Active Directory. Используется при аутентификации с пользователем Active Directory вместо службы-принципала. |
||
| profile |
нет | Профиль безопасности, найденный в файле ~/.azure/credentials. |
||
| record_type |
нет | Ограничить наборы записей по типу записи. |
||
| relative_name |
нет | Показывать результаты только для набора записей. |
||
| resource_group |
нет | Ограничить результаты по группе ресурсов. Требуется при фильтрации по имени или типу. |
||
| secret |
нет | Секрет клиента Azure. Используется при аутентификации с помощью службы-принципала. |
||
| subscription_id |
нет | Ваш идентификатор подписки Azure. |
||
| tenant |
нет | Идентификатор клиента Azure. Используется при аутентификации с помощью службы-принципала. |
||
| top |
нет | 100 | Ограничить максимальное количество возвращаемых наборов записей. |
|
| zone_name |
нет | Ограничить результаты по зонам. Требуется при фильтрации по имени или типу. |
Примеры
- name: Get facts for one Record Set
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
relative_name: server10
record_type: A
- name: Get facts for all Type A Record Sets in a Zone
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
record_type: A
- name: Get all record sets in one zone
azure_rm_dnsrecordset_facts:
resource_group: Testing
zone_name: example.com
Возвращаемые значения
Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| azure_dnsrecordset | Список словарей набора записей. |
всегда | список |
Примечания
Примечание
- Для аутентификации в Azure вы можете передавать параметры, задавать переменные окружения или использовать профиль, хранящийся в ~/.azure/credentials. Аутентификация возможна с помощью службы-принципала или пользователя 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 в окружении.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимым.
Для помощи в разработке модулей, если у вас есть такое желание, пожалуйста, прочтите Справочная информация по сообществу и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/azure_rm_dnsrecordset_facts_module.html