avi_gslbservice - Модуль для настройки GslbService Avi RESTful объекта
Новая версия 2.4.
Обзор
- Этот модуль используется для конфигурации объекта GslbService
- дополнительные примеры по адресу https://github.com/avinetworks/devops
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- avisdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_context (добавлен в 2.5) | Контекст API Avi, включающий текущий идентификатор сессии и маркер CSRF. Это позволяет пользователю выполнить единый вход и повторно использовать сессию. | |
| api_version | По умолчанию: 16.4.4 | Версия API Avi для использования с Avi API и объектами. |
| application_persistence_profile_ref (добавлен в 2.5) | Федеративное сохранение состояния приложения, связанное с функциями сохранения состояния сайта gslbservice. Это ссылка на объект типа applicationpersistenceprofile. Поле введено в 17.2.1. | |
| avi_api_patch_op (добавлен в 2.5) |
| Операция исправления, используемая при использовании avi_api_update_method как patch. |
| avi_api_update_method (добавлен в 2.5) |
| Метод по умолчанию для обновления объекта — HTTP PUT. Установка в patch переопределит это поведение, чтобы использовать HTTP PATCH. |
| avi_credentials (добавлен в 2.5) | Словарь Avi Credentials, который можно использовать вместо перечисления учетных данных входа в Avi Controller. | |
| controller | По умолчанию: | IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная среды AVI_CONTROLLER. |
| controller_health_status_enabled |
| Общий статус здоровья члена Gs определяется на основе комбинации входов статуса здоровья контроллера и плоскости данных. Обратите внимание, что статус плоскости данных определяется путем сопоставления профилей монитора здоровья. Только предоставляемый контроллером статус определяется с помощью этой конфигурации. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как True. |
| created_by | Имя создателя. Поле введено в 17.1.2. | |
| description | Пользовательское описание объекта. | |
| domain_names | Полное доменное имя службы gslb. | |
| down_response | Ответ клиенту, когда служба gslb недоступна. | |
| enabled |
| Включить или отключить службу gslb. Если служба gslb включена, то виртуальные серверы отправляются в ответах DNS на основе достижимости и настроенного алгоритма. Если служба gslb отключена, то виртуальные серверы больше недоступны в ответе DNS. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как True. |
| groups | Выберите список пулов, принадлежащих этой службе gslb. | |
| health_monitor_refs | Проверьте vs здоровье, применив один или несколько мониторов здоровья. Активные мониторы генерируют синтетический трафик из DNS-сервисного движка и для обозначения vs как активных или неактивных на основе ответа. Это ссылка на объект типа healthmonitor. | |
| health_monitor_scope | Зондирование монитора состояния может выполняться для всех членов, или оно может выполняться только для сторонних членов. Этот режим работы полезен для сокращения числа зондирований монитора состояния в случае гибридной ситуации. В таком случае члены avi могут иметь статус, определенный контроллером, в то время как не-avi члены могут быть запробованы через зондирования мониторов состояния в плоскости данных. Варианты перечисления — GSLB_SERVICE_HEALTH_MONITOR_ALL_MEMBERS, GSLB_SERVICE_HEALTH_MONITOR_ONLY_NON_AVI_MEMBERS. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как GSLB_SERVICE_HEALTH_MONITOR_ALL_MEMBERS. | |
| is_federated |
| Это поле указывает, что этот объект дублируется в федерации gslb. Поле введено в 17.1.3. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как True. |
| min_members (добавлен в 2.5) | Минимальное количество членов для распределения трафика. Допустимые значения — 1–65535. Специальные значения — 0 — «отключить». Поле введено в 17.2.4. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как 0. | |
| name обязательно | Имя службы gslb. | |
| num_dns_ip | Количество IP-адресов этой службы gslb, которые будут возвращены службой DNS. Введите 0, чтобы вернуть все IP-адреса. Допустимые значения — 1–20. Специальные значения — 0 — «вернуть все IP-адреса». | |
| password | По умолчанию: | Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная среды AVI_PASSWORD. |
| pool_algorithm (добавлен в 2.5) | Алгоритм балансировки нагрузки выберет пул gslb в списке доступных пулов службы gslb. Варианты перечисления — GSLB_SERVICE_ALGORITHM_PRIORITY, GSLB_SERVICE_ALGORITHM_GEO. Поле введено в 17.2.3. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как GSLB_SERVICE_ALGORITHM_PRIORITY. | |
| site_persistence_enabled (добавлен в 2.5) |
| Включить сохранение состояния сайта для gslbservice. Поле введено в 17.2.1. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как False. |
| state |
| Состояние, которое должно быть применено к сущности. |
| tenant | По умолчанию: admin | Имя клиента, используемое для всех вызовов API Avi и контекста объекта. |
| tenant_ref | Это ссылка на объект типа клиент. | |
| tenant_uuid | По умолчанию: | UUID клиента, используемый для всех вызовов API Avi и контекста объекта. |
| ttl | Значение ttl (в секундах) для записей, предоставленных для этой службы gslb службой DNS. Допустимые значения — 1–86400. Единицы (с) | |
| url | URL контроллера Avi объекта. | |
| use_edns_client_subnet |
| Использовать подсеть IP-адреса клиента из параметра edns в качестве исходного IP-адреса для геолокации клиента и алгоритма консистентного хеширования. По умолчанию true. Поле введено в 17.1.1. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как True. |
| username | По умолчанию: | Имя пользователя, используемое для доступа к контроллеру Avi. Значение по умолчанию — переменная среды AVI_USERNAME. |
| uuid | Uuid службы gslb. | |
| wildcard_match |
| Включить сопоставление с подстановкой подстановочных знаков, если точное совпадение не найдено в таблице DNS, то выбирается самое длинное совпадение путем подстановки подстановочных знаков fqdn в запросе DNS. По умолчанию false. Поле введено в 17.1.1. Значение по умолчанию, если не указано в API или модуле, интерпретируется Avi Controller как False. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Avi Network см. на странице https://www.ansible.com/ansible-avi-networks.
Примеры
- name: Example to create GslbService object
avi_gslbservice:
controller: 10.10.25.42
username: admin
password: something
state: present
name: sample_gslbservice
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| obj dict | успех, изменение | Объект GslbService (api/gslbservice) |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- Gaurav Rastogi (grastogi@avinetworks.com)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/avi_gslbservice_module.html
