community.general.hwc_vpc_security_group_rule – Создаёт ресурс Vpc/SecurityGroupRule в Huawei Cloud

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в плейбуке укажите: community.general.hwc_vpc_security_group_rule.

Новое в версии 0.2.0: of community.general

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление группами безопасности VPC.

Требования

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

keystoneauth1 >= 3.6.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка		Предоставляет дополнительную информацию о правиле группы безопасности. Значение — строка длиной не более 255 символов, которая может содержать буквы и цифры.
direction строка / обязательно		Указывает направление управления доступом. Значение может быть egress или ingress.
domain строка / обязательно		Название домена для ограничения (Identity v3). (В настоящее время поддерживаются только имена доменов, а не идентификаторы доменов).
ethertype строка		Указывает версию IP-протокола. Значение может быть IPv4 или IPv6. Если этот параметр не задан, по умолчанию используется IPv4.
id строка		Идентификатор управляемого ресурса.
identity_endpoint строка / обязательно		URL авторизации Identity.
password строка / обязательно		Пароль для входа.
port_range_max целое число		Указывает конечный номер порта. Значение от 1 до 65535. Если протокол не icmp, значение не может быть меньше значения port_range_min. Пустое значение означает все порты.
port_range_min целое число		Указывает начальный номер порта. Значение от 1 до 65535. Значение не может быть больше значения port_range_max. Пустое значение означает все порты.
project строка / обязательно		Имя Tenant (Identity v2) или Project (Identity v3). (В настоящее время поддерживаются только имена проектов, а не идентификаторы проектов).
protocol строка		Указывает тип протокола. Значение может быть icmp, tcp или udp. Если параметр опущен, группа безопасности поддерживает все протоколы.
region строка		Регион, к которому принадлежит проект.
remote_group_id строка		Указывает идентификатор peer группы безопасности. Значение взаимоисключающее с параметром remote_ip_prefix.
remote_ip_prefix строка		Указывает удалённый IP-адрес. Если направление управления доступом установлено в egress, параметр указывает исходный IP-адрес. Если направление управления доступом установлено в ingress, параметр указывает конечный IP-адрес. Значение может быть в формате CIDR или IP-адреса. Параметр взаимоисключающий с параметром remote_group_id.
security_group_id строка / обязательно		Указывает ID правила группы безопасности, который однозначно идентифицирует правило группы безопасности.
state строка	Варианты: present ← absent	Должен ли данный объект существовать в Huawei Cloud.
user строка / обязательно		Имя пользователя для входа (в настоящее время поддерживаются только имена пользователей, а не идентификаторы пользователей).

Примечания

Примечание

Если параметр id указан, он имеет приоритет над enterprise_project_id для выбора правила группы безопасности.
security_group_id используется для выбора правила группы безопасности. Если существует более одного правила группы безопасности с этим параметром, выполнение прерывается.
Обновление параметров не поддерживается. Если один из параметров изменяется, модуль создаст новый ресурс.
Для аутентификации можно задать identity_endpoint с помощью переменной среды ANSIBLE_HWC_IDENTITY_ENDPOINT.
Для аутентификации можно задать user с помощью переменной среды ANSIBLE_HWC_USER.
Для аутентификации можно задать password с помощью переменной среды ANSIBLE_HWC_PASSWORD.
Для аутентификации можно задать domain с помощью переменной среды ANSIBLE_HWC_DOMAIN.
Для аутентификации можно задать project с помощью переменной среды ANSIBLE_HWC_PROJECT.
Для аутентификации можно задать region с помощью переменной среды ANSIBLE_HWC_REGION.
Значения переменных среды будут использоваться только в том случае, если значения плейбука не заданы.

Примеры

# create a security group rule
- name: Create a security group
  hwc_vpc_security_group:
    name: "ansible_network_security_group_test"
  register: sg
- name: Create a security group rule
  community.general.hwc_vpc_security_group_rule:
    direction: "ingress"
    protocol: "tcp"
    ethertype: "IPv4"
    port_range_max: 22
    security_group_id: "{{ sg.id }}"
    port_range_min: 22
    remote_ip_prefix: "0.0.0.0/0"

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

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

Ключ	Возвращаемое значение	Описание
description строка	успех	Предоставляет дополнительную информацию о правиле группы безопасности. Значение — строка длиной не более 255 символов, которая может содержать буквы и цифры.
direction строка	успех	Указывает направление управления доступом. Значение может быть egress или ingress.
ethertype строка	успех	Указывает версию IP-протокола. Значение может быть IPv4 или IPv6. Если этот параметр не задан, по умолчанию используется IPv4.
port_range_max целое число	успех	Указывает конечный номер порта. Значение от 1 до 65535. Если протокол не icmp, значение не может быть меньше значения port_range_min. Пустое значение означает все порты.
port_range_min целое число	успех	Указывает начальный номер порта. Значение от 1 до 65535. Значение не может быть больше значения port_range_max. Пустое значение означает все порты.
protocol строка	успех	Указывает тип протокола. Значение может быть icmp, tcp или udp. Если параметр опущен, группа безопасности поддерживает все протоколы.
remote_group_id строка	успех	Указывает идентификатор peer группы безопасности. Значение взаимоисключающее с параметром remote_ip_prefix.
remote_ip_prefix строка	успех	Указывает удалённый IP-адрес. Если направление управления доступом установлено в egress, параметр указывает исходный IP-адрес. Если направление управления доступом установлено в ingress, параметр указывает конечный IP-адрес. Значение может быть в формате CIDR или IP-адреса. Параметр взаимоисключающий с параметром remote_group_id.
security_group_id строка	успех	Указывает ID правила группы безопасности, который однозначно идентифицирует правило группы безопасности.

Авторы

Huawei Inc. (@huaweicloud)

© 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/community/general/hwc_vpc_security_group_rule_module.html