Модуль community.general.hwc_vpc_security_group – создание ресурса VPC/SecurityGroup в Huawei Cloud

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

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

Чтобы использовать модуль в плейбуке, укажите: community.general.hwc_vpc_security_group.

Добавлено в community.general 0.2.0

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

Обзор

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

Требования

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

keystoneauth1 >= 3.6.0

Параметры

Параметр	Комментарии
domain string / обязательный	Имя области (Domain), в рамках которой выполняется действие (Identity v3). В настоящее время поддерживаются только имена областей, но не их идентификаторы.
enterprise_project_id string	Указывает идентификатор корпоративного проекта. При создании группы безопасности свяжите ее с указанным идентификатором корпоративного проекта.
id string	Идентификатор управляемого ресурса.
identity_endpoint string / обязательный	URL-адрес аутентификации Identity.
name string / обязательный	Задает имя группы безопасности. Значение должно быть строкой длиной от 1 до 64 символов и может содержать буквы, цифры, символы подчеркивания (`_`), дефисы (`-`) и точки (`.`).
password string / обязательный	Пароль для входа.
project string / обязательный	Имя арендатора (Tenant) (Identity v2) или проекта (Project) (Identity v3). В настоящее время поддерживаются только имена проектов, но не их идентификаторы.
region string	Регион, к которому относится проект.
state string	Должен ли указанный объект существовать в Huawei Cloud. Варианты: `"present"` ← (по умолчанию) `"absent"`
user string / обязательный	Имя пользователя для входа. В настоящее время поддерживаются только имена пользователей, но не их идентификаторы.
vpc_id string	Указывает идентификатор ресурса VPC, к которому относится группа безопасности.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и прогнозировать статус изменений, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

Если задан параметр id, он имеет приоритет над параметрами name, enterprise_project_id и vpc_id при выборе группы безопасности.
Параметры name, enterprise_project_id и vpc_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
- name: Create a security group
  community.general.hwc_vpc_security_group:
    name: "ansible_network_security_group_test"

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

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

Ключ	Описание
enterprise_project_id string	Указывает идентификатор корпоративного проекта. При создании группы безопасности свяжите ее с указанным идентификатором корпоративного проекта. Возвращается: при успешном выполнении
name string	Задает имя группы безопасности. Значение должно быть строкой длиной от 1 до 64 символов и может содержать буквы, цифры, символы подчеркивания (`_`), дефисы (`-`) и точки (`.`). Возвращается: при успешном выполнении
rules list / elements=dictionary	Указывает правило группы безопасности, которое обеспечивает возможность взаимодействия ресурсов в этой группе друг с другом. Возвращается: при успешном выполнении
description string	Дополнительная информация о правиле группы безопасности. Возвращается: при успешном выполнении
direction string	Указывает направление управления доступом. Возможные значения: egress или ingress. Возвращается: при успешном выполнении
ethertype string	Указывает версию протокола IP. Возможные значения: IPv4 или IPv6. Возвращается: при успешном выполнении
id string	Указывает идентификатор правила группы безопасности. Возвращается: при успешном выполнении
port_range_max integer	Указывает номер конечного порта. Значение находится в диапазоне от 1 до 65535. Если протокол не icmp, значение не может быть меньше значения port_range_min. Пустое значение означает все порты. Возвращается: при успешном выполнении
port_range_min integer	Указывает номер начального порта. Значение находится в диапазоне от 1 до 65535. Оно не может быть больше значения port_range_max. Пустое значение означает все порты. Возвращается: при успешном выполнении
protocol string	Указывает тип протокола. Возможные значения: icmp, tcp, udp или другие. Если параметр не задан, группа безопасности поддерживает все протоколы. Возвращается: при успешном выполнении
remote_address_group_id string	Указывает идентификатор удаленной группы IP-адресов. Возвращается: при успешном выполнении
remote_group_id string	Указывает идентификатор одноранговой группы безопасности. Возвращается: при успешном выполнении
remote_ip_prefix string	Указывает удаленный IP-адрес. Если для направления управления доступом задано egress, параметр указывает исходный IP-адрес. Если задано ingress, параметр указывает IP-адрес назначения. Возвращается: при успешном выполнении
vpc_id string	Указывает идентификатор ресурса VPC, к которому относится группа безопасности. Возвращается: при успешном выполнении

Авторы

Huawei Inc. (@huaweicloud)

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

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