ngine_io.cloudstack.cs_network_offering – Управляет предложениями сетей в облаках на основе Apache CloudStack.
Примечание
Этот плагин входит в коллекцию ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_network_offering.
Новое в версии 0.1.0: of ngine_io.cloudstack
Обзор
- Создание, обновление, включение, выключение и удаление предложений сетей.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке. Если не указан, используется переменная среды CLOUDSTACK_METHOD. |
| api_key строка / обязательно | Ключ API CloudStack API. Если не указан, используется переменная среды CLOUDSTACK_KEY. | |
| api_secret строка / обязательно | Секретный ключ CloudStack API. Если не указан, используется переменная среды CLOUDSTACK_SECRET. | |
| api_timeout целое число | Значение по умолчанию: 10 | Таймаут HTTP в секундах. Если не указан, используется переменная среды CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательно | URL CloudStack API, например, https://cloud.example.com/client/api. Если не указан, используется переменная среды CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверять сертификат CA. Если не указан, используется переменная среды CLOUDSTACK_VERIFY. | |
| availability строка | Доступность предложения сети. Значение по умолчанию — Optional | |
| conserve_mode булево |
| Включен ли режим сохранения IP для предложения сети. |
| details список / элементы=словарь | Подробности предложения сети в виде пар ключ/значение. с поставщиком услуг как значением | |
| display_text строка | Текст для отображения предложения сети. | |
| egress_default_policy строка |
| Политика по умолчанию для исходящего трафика (allow или deny). |
| for_vpc булево |
| Предложение предназначено для VPC или нет. |
| guest_ip_type строка |
| Тип гостевого IP-адреса. |
| keepalive_enabled булево |
| Если true, будет включен keepalive в балансировщике нагрузки. На момент написания это действует только на haproxy. режимы http и httpclose не установлены в файле конфигурации haproxy. |
| max_connections целое число | Максимальное количество одновременных подключений. | |
| name строка / обязательно | Имя предложения сети. | |
| network_rate целое число | Скорость передачи данных в мегабитах в секунду. | |
| persistent булево |
| Истинно, если предложение сети поддерживает постоянные сети По умолчанию ложно, если не указано |
| service_capabilities список / элементы=строка | Требуемые возможности сервиса. псевдонимы: service_capability | |
| service_offering строка | Имя или ID предложения сервиса, используемого поставщиком виртуального маршрутизатора. | |
| service_providers список / элементы=словарь | Сопоставление поставщика с сервисом. Если не указано, поставщик сервиса будет сопоставлен с поставщиком по умолчанию в физической сети. псевдонимы: service_provider | |
| specify_ip_ranges булево |
| Поддерживает ли предложение сети указание диапазонов IP-адресов. По умолчанию API устанавливает no, если не указано. |
| specify_vlan булево |
| Поддерживает ли предложение сети VLAN. |
| state строка |
| Состояние предложения сети. |
| supported_services список / элементы=строка |
| Поддерживаемые сервисы предложения сети. Список одного или нескольких элементов из списка вариантов. псевдонимы: supported_service |
| traffic_type строка | Значение по умолчанию: "Guest" | Тип трафика для предложения сети. |
Примечания
Примечание
- Подробное руководство по модулям Cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create a network offering and enable it
ngine_io.cloudstack.cs_network_offering:
name: my_network_offering
display_text: network offering description
state: enabled
guest_ip_type: Isolated
supported_services: [ Dns, PortForwarding, Dhcp, SourceNat, UserData, Firewall, StaticNat, Vpn, Lb ]
service_providers:
- { service: 'dns', provider: 'virtualrouter' }
- { service: 'dhcp', provider: 'virtualrouter' }
- name: Remove a network offering
ngine_io.cloudstack.cs_network_offering:
name: my_network_offering
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| availability string | success | Доступность сетевого предложения. Пример: Необязательно |
| display_text string | success | Текст отображения сетевого предложения. Пример: Моё сетевое предложение |
| egress_default_policy string | success | Политика выходящего трафика по умолчанию. Пример: allow |
| for_vpc boolean | success | Предложение предназначено для использования в VPC или нет. |
| guest_ip_type string | success | Тип гостевого трафика сетевого предложения. Пример: Isolated |
| id string | success | UUID сетевого предложения. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| is_default boolean | success | Является ли сетевое предложение предложением по умолчанию. |
| is_persistent boolean | success | Поддерживаются ли постоянные сети. |
| max_connections integer | success | Максимальное количество одновременных подключений, обрабатываемых LB. Пример: 300 |
| name string | success | Название сетевого предложения. Пример: MyCustomNetworkOffering |
| network_rate integer | success | Скорость передачи сетевого трафика в Мбит/с. Пример: 200 |
| service_offering_id string | success | ID предложения сервиса. Пример: c5f7a5fc-43f8-11e5-a151-feff819cdc9f |
| state string | success | Состояние сетевого предложения. Пример: Включено |
| traffic_type string | success | Тип трафика. Пример: Гостевой |
Авторы
- David Passante (@dpassante)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_network_offering_module.html
