cs_securitygroup — Управление группами безопасности на облаках Apache CloudStack.

Новая версия с 2.0.

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

Обзор

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

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account		Аккаунт, к которому относится группа безопасности.
api_http_method	Варианты: get post	HTTP-метод, используемый для запроса к конечной точке API. Если не указан, используется переменная среды `CLOUDSTACK_METHOD`. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — `get`, если не указано.
api_key		Ключ API CloudStack API. Если не указан, используется переменная среды `CLOUDSTACK_KEY`. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
api_region	По умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. Если не указан, используется переменная среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ API CloudStack API. Если не задан, используется переменная среды `CLOUDSTACK_SECRET`. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
api_timeout		Таймаут HTTP в секундах. Если не указан, используется переменная среды `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — 10 секунд, если не указано.
api_url		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указан, используется переменная среды `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
description		Описание группы безопасности.
domain		Домен, к которому относится группа безопасности.
name обязательно		Имя группы безопасности.
project		Имя проекта, в котором должна быть создана группа безопасности.
state	Варианты: present ← absent	Состояние группы безопасности.

Примечания

Примечание

Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких мест в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. Переменные среды CLOUDSTACK_TIMEOUT. Переменная среды CLOUDSTACK_CONFIG, указывающая на файл .ini. Файл cloudstack.ini в текущей рабочей директории. Файл .cloudstack.ini в домашней директории пользователя. Допускается указание нескольких учетных данных и конечных точек с использованием разделов ini в файле cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию используется раздел cloudstack. Дополнительную информацию можно найти на странице https://github.com/exoscale/cs.
Подробное руководство по модулям cloudstack можно найти в руководстве по облаку CloudStack CloudStack Cloud Guide.
Этот модуль поддерживает режим проверки.

Примеры

- name: create a security group
  local_action:
    module: cs_securitygroup
    name: default
    description: default security group

- name: remove a security group
  local_action:
    module: cs_securitygroup
    name: default
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
account строка	успех	Аккаунт, к которому относится группа безопасности. Пример: example account
description строка	успех	Описание группы безопасности. Пример: application security group
domain строка	успех	Домен, к которому относится группа безопасности. Пример: example domain
id строка	успех	UUID группы безопасности. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
name строка	успех	Имя группы безопасности. Пример: app
project строка	успех	Имя проекта, к которому относится группа безопасности. Пример: Production
tags словарь	успех	Список тегов ресурсов, связанных с группой безопасности. Пример: [ { "key": "foo", "value": "bar" } ]

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют отсутствие несовместимых изменений интерфейса.

Обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробную информацию см. в разделе Обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

René Moser (@resmo)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cs_securitygroup_module.html