Модуль ngine_io.cloudstack.security_group_rule – управление правилами групп безопасности в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.security_group_rule.

Новый в ngine_io.cloudstack 0.1.0

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

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

Добавление и удаление правил групп безопасности.

Псевдонимы: cs_securitygroup_rule

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
api_http_method string	Метод HTTP, используемый для запроса к конечной точке API. Если не задан, используется переменная окружения `CLOUDSTACK_METHOD`. Допустимые значения: `"get"` ← (по умолчанию) `"post"`
api_key string / обязательный	Ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_KEY`.
api_secret string / обязательный	Секретный ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_SECRET`.
api_timeout integer	Тайм-аут HTTP в секундах. Если не задан, используется переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url string / обязательный	URL API CloudStack, например https://cloud.example.com/client/api. Если не задан, используется переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert string	Проверять файл сертификата центра сертификации. Если не задан, используется переменная окружения `CLOUDSTACK_VERIFY`.
cidr string	Диапазон CIDR (полная запись), используемый для правила группы безопасности. По умолчанию: `"0.0.0.0/0"`
end_port integer	Конечный порт для этого правила. Обязателен, если protocol=tcp или protocol=udp; если не задан, используется start_port.
icmp_code integer	Код ошибки для этого сообщения ICMP. Обязателен, если protocol=icmp.
icmp_type integer	Тип отправляемого сообщения ICMP. Обязателен, если protocol=icmp.
poll_async boolean	Ожидать завершения асинхронных заданий, опрашивая их состояние. Допустимые значения: `false` `true` ← (по умолчанию)
project string	Имя проекта, в котором будет создана группа безопасности.
protocol string	Протокол правила группы безопасности. Допустимые значения: `"tcp"` ← (по умолчанию) `"udp"` `"icmp"` `"ah"` `"esp"` `"gre"`
security_group string / обязательный	Имя группы безопасности, к которой относится правило. Группа безопасности должна существовать.
start_port псевдонимы: port integer	Начальный порт для этого правила. Обязателен, если protocol=tcp или protocol=udp.
state string	Состояние правила группы безопасности. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
type string	Правило группы безопасности для входящего или исходящего трафика. Допустимые значения: `"ingress"` ← (по умолчанию) `"egress"`
user_security_group string	Группа безопасности, на основе которой создано это правило.
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если значение `false`, SSL-сертификаты не будут проверяться. Если не задано, используется переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Этот параметр следует использовать только на сайтах, находящихся под личным управлением и использующих самоподписанные сертификаты. Допустимые значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

---
- name: allow inbound port 80/tcp from 1.2.3.4 added to security group 'default'
  ngine_io.cloudstack.security_group_rule:
    security_group: default
    port: 80
    cidr: 1.2.3.4/32

- name: allow tcp/udp outbound added to security group 'default'
  ngine_io.cloudstack.security_group_rule:
    security_group: default
    type: egress
    start_port: 1
    end_port: 65535
    protocol: '{{ item }}'
  with_items:
  - tcp
  - udp

- name: allow inbound icmp from 0.0.0.0/0 added to security group 'default'
  ngine_io.cloudstack.security_group_rule:
    security_group: default
    protocol: icmp
    icmp_code: -1
    icmp_type: -1

- name: remove rule inbound port 80/tcp from 0.0.0.0/0 from security group 'default'
  ngine_io.cloudstack.security_group_rule:
    security_group: default
    port: 80
    state: absent

- name: allow inbound port 80/tcp from security group web added to security group 'default'
  ngine_io.cloudstack.security_group_rule:
    security_group: default
    port: 80
    user_security_group: web

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

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

Ключ	Описание
cidr string	Диапазон CIDR правила. Возвращается: при успешном выполнении, если задан cidr Пример: `"0.0.0.0/0"`
end_port integer	Конечный порт правила. Возвращается: при успешном выполнении Пример: `80`
id string	UUID правила. Возвращается: при успешном выполнении Пример: `"a6f7a5fc-43f8-11e5-a151-feff819cdc9f"`
protocol string	Протокол правила. Возвращается: при успешном выполнении Пример: `"tcp"`
security_group string	Группа безопасности правила. Возвращается: при успешном выполнении Пример: `"default"`
start_port integer	Начальный порт правила. Возвращается: при успешном выполнении Пример: `80`
type string	Тип правила. Возвращается: при успешном выполнении Пример: `"ingress"`
user_security_group string	Группа безопасности пользователя для этого правила. Возвращается: при успешном выполнении, если задан user_security_group Пример: `"default"`

Авторы

René Moser (@resmo)

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

© 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/ngine_io/cloudstack/security_group_rule_module.html