Spec-Zone.ru › Ansible

Модуль ngine_io.cloudstack.network_acl_rule — управление правилами списка управления доступом к сети (ACL) в облаках на базе 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.network_acl_rule.

Добавлено в ngine_io.cloudstack 0.1.0

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

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

  • Добавление, изменение и удаление правил ACL сети.

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

account

строка

Учётная запись, к которой относится VPC.

action_policy

псевдонимы: action

строка

Политика действия правила.

Варианты:

  • "allow" ← (по умолчанию)
  • "deny"

api_http_method

строка

Метод HTTP, используемый для запроса к конечной точке API.

Если значение не задано, используется переменная окружения CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

строка / обязательный

Ключ API CloudStack.

Если значение не задано, используется переменная окружения CLOUDSTACK_KEY.

api_secret

строка / обязательный

Секретный ключ API CloudStack.

Если значение не задано, используется переменная окружения CLOUDSTACK_SECRET.

api_timeout

целое число

Тайм-аут HTTP в секундах.

Если значение не задано, используется переменная окружения CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

строка / обязательный

URL API CloudStack, например https://cloud.example.com/client/api.

Если значение не задано, используется переменная окружения CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

строка

Проверять файл сертификата центра сертификации.

Если значение не задано, используется переменная окружения CLOUDSTACK_VERIFY.

cidrs

псевдонимы: cidr

список / элементы=строка

Диапазоны CIDR правила.

По умолчанию: ["0.0.0.0/0"]

domain

строка

Домен, к которому относится VPC.

end_port

целое число

Конечный порт для этого правила.

Учитывается, если protocol=tcp или protocol=udp.

Если не указан, совпадает со значением start_port.

icmp_code

целое число

Код ошибки для этого сообщения ICMP.

Учитывается, если protocol=icmp.

icmp_type

целое число

Тип отправляемого сообщения ICMP.

Учитывается, если protocol=icmp.

network_acl

псевдонимы: acl

строка / обязательный

Имя ACL сети.

poll_async

логическое значение

Опрос асинхронных заданий до их завершения.

Варианты:

  • false
  • true ← (по умолчанию)

project

строка

Имя проекта, к которому относится VPC.

protocol

строка

Протокол правила

Варианты:

  • "tcp" ← (по умолчанию)
  • "udp"
  • "icmp"
  • "all"
  • "by_number"

protocol_number

целое число

Номер протокола от 1 до 256; обязателен, если protocol=by_number.

rule_position

псевдонимы: number

целое число / обязательный

Позиция правила ACL сети.

start_port

псевдонимы: port

целое число

Начальный порт для этого правила.

Учитывается, если protocol=tcp или protocol=udp.

state

строка

Состояние правила ACL сети.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

псевдонимы: tag

список / элементы=словарь

Список тегов. Теги представляют собой список словарей с ключами key и value.

Чтобы удалить все теги, задайте пустой список, например tags: [].

traffic_type

псевдонимы: type

строка

Тип трафика правила.

Варианты:

  • "ingress" ← (по умолчанию)
  • "egress"

validate_certs

логическое значение

добавлено в ngine_io.cloudstack 2.4.0

Если false, сертификаты SSL не проверяются.

Если значение не задано, используется переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на сайтах под вашим контролем, использующих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

vpc

строка / обязательный

VPC, к которому относится ACL сети.

zone

строка / обязательный

Имя зоны, к которой относится VPC.

Примечания

Примечание

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

Примеры

- name: create a network ACL rule, allow port 80 ingress
  ngine_io.cloudstack.network_acl_rule:
    network_acl: web
    rule_position: 1
    vpc: my vpc
    zone: zone01
    traffic_type: ingress
    action_policy: allow
    port: 80
    cidr: 0.0.0.0/0

- name: create a network ACL rule, deny port range 8000-9000 ingress for 10.20.0.0/16 and 10.22.0.0/16
  ngine_io.cloudstack.network_acl_rule:
    network_acl: web
    rule_position: 1
    vpc: my vpc
    zone: zone01
    traffic_type: ingress
    action_policy: deny
    start_port: 8000
    end_port: 9000
    cidrs:
    - 10.20.0.0/16
    - 10.22.0.0/16

- name: remove a network ACL rule
  ngine_io.cloudstack.network_acl_rule:
    network_acl: web
    rule_position: 1
    vpc: my vpc
    zone: zone01
    state: absent

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

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

Ключ

Описание

account

строка

Учётная запись, к которой относится правило ACL сети.

Возвращается: success

Пример: "example account"

action_policy

строка

Политика действия правила ACL сети.

Возвращается: success

Пример: "deny"

cidr

строка

Диапазон CIDR правила ACL сети.

Возвращается: success

Пример: "0.0.0.0/0"

cidrs

список / элементы=строка

Диапазоны CIDR правила ACL сети.

Возвращается: success

Пример: ["0.0.0.0/0"]

domain

строка

Домен, к которому относится правило ACL сети.

Возвращается: success

Пример: "example domain"

end_port

целое число

Конечный порт правила ACL сети.

Возвращается: success

Пример: 80

icmp_code

целое число

Код ICMP правила ACL сети.

Возвращается: success

Пример: 8

icmp_type

целое число

Тип ICMP правила ACL сети.

Возвращается: success

Пример: 0

network_acl

строка

Имя ACL сети.

Возвращается: success

Пример: "customer acl"

project

строка

Имя проекта, к которому относится правило ACL сети.

Возвращается: success

Пример: "Production"

protocol

строка

Протокол правила ACL сети.

Возвращается: success

Пример: "tcp"

protocol_number

целое число

Номер протокола, если он задан числом.

Возвращается: success

Пример: 8

rule_position

целое число

Позиция правила ACL сети.

Возвращается: success

Пример: 1

start_port

целое число

Начальный порт правила ACL сети.

Возвращается: success

Пример: 80

state

строка

Состояние правила ACL сети.

Возвращается: success

Пример: "Active"

tags

список / элементы=строка

Список тегов ресурса, связанных с правилом ACL сети.

Возвращается: success

Пример: ["[ { \"key\": \"foo\"", " \"value\": \"bar\" } ]"]

traffic_type

строка

Тип трафика правила ACL сети.

Возвращается: success

Пример: "ingress"

vpc

строка

VPC ACL сети.

Возвращается: success

Пример: "customer vpc"

zone

строка

Зона, к которой относится VPC.

Возвращается: success

Пример: "ch-gva-2"

Авторы

  • 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/network_acl_rule_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API