ngine_io.cloudstack.cs_vlan_ip_range – Управляет диапазонами IP-адресов VLAN в облаках на основе Apache CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).

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

Для использования в плейбуке укажите: ngine_io.cloudstack.cs_vlan_ip_range.

Новое в версии 0.1.0: от ngine_io.cloudstack

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

Обзор

Создание и удаление диапазона IP-адресов VLAN.

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account строка		Аккаунт, владелец VLAN. Взаимоисключающее с project.
api_http_method строка	Варианты: get ← post	HTTP-метод, используемый для запроса к API-точке. Если не указано, используется переменная среды `CLOUDSTACK_METHOD`.
api_key строка / обязательно		API-ключ CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_KEY`.
api_secret строка / обязательно		Секретный ключ CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_SECRET`.
api_timeout целое число	По умолчанию: 10	Таймаут HTTP в секундах. Если не указано, используется переменная среды `CLOUDSTACK_TIMEOUT`.
api_url строка / обязательно		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert строка		Проверять сертификат удостоверяющего центра. Если не указано, используется переменная среды `CLOUDSTACK_VERIFY`.
cidr_ipv6 строка		CIDR IPv6 сети, должен быть не менее /64.
domain строка		Домен аккаунта, владеющего VLAN.
end_ip строка		Конечный IPv4 адрес в диапазоне IP VLAN. Если не указано, используется значение start_ip. Учитывается только при создании.
end_ipv6 строка		Конечный IPv6 адрес в диапазоне IPv6 сети. Если не указано, используется значение start_ipv6. Учитывается только при создании.
for_system_vms логическое	Варианты: нет ← да	`yes` если диапазон IP установлен для системных виртуальных машин, `no` если нет
for_virtual_network логическое добавлено в 1.0.0 от ngine_io.cloudstack	Варианты: нет ← да	`yes` если VLAN виртуального типа, `no` если прямой. Если установлено `yes`, но не указаны ни physical_network, ни network, CloudStack попытается добавить диапазон VLAN в физическую сеть с типом трафика «Публичный».
gateway строка		Шлюз диапазона IP VLAN. Обязательно, если state=present.
gateway_ipv6 строка		Шлюз IPv6 сети. Учитывается только при создании.
netmask строка		Маска подсети диапазона IP VLAN. Обязательно, если state=present.
network строка		Имя или идентификатор сети. Обязательно, если for_virtual_network и physical_network не заданы.
physical_network строка		Имя или идентификатор физической сети.
pod строка добавлено в 1.0.0 от ngine_io.cloudstack		Имя подсети.
project строка		Проект, владелец VLAN. Взаимоисключающее с account.
start_ip строка / обязательно		Начальный IPv4 адрес в диапазоне IP VLAN. Учитывается только при создании.
start_ipv6 строка		Начальный IPv6 адрес в диапазоне IPv6 сети. Учитывается только при создании.
state строка	Варианты: present ← absent	Состояние диапазона IP сети.
vlan строка		Идентификатор или VID сети. Если не указано, будет использовано VLAN сети по умолчанию.
zone строка / обязательно		Идентификатор зоны диапазона IP VLAN.

Примечания

Примечание

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

Примеры

- name: create a VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    network: test
    vlan: 98
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    gateway: 10.2.4.1
    netmask: 255.255.255.0
    zone: zone-02

- name: remove a VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    state: absent
    network: test
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    zone: zone-02

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

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

Ключ	Возвращаемое значение	Описание
account string	если доступно	Аккаунт, владеющий сетью. Пример: примерный аккаунт
cidr_ipv6 string	если доступно	CIDR IPv6 сети. Пример: 2001:db8::/64
domain string	успех	Имя домена диапазона IP-адресов VLAN. Пример: ROOT
end_ip string	успех	Конечный IP-адрес диапазона IP-адресов VLAN. Пример: 10.2.4.100
end_ipv6 string	если доступно	Конечный IPv6-адрес диапазона IP-адресов VLAN. Пример: 2001:db8::50
for_systemvms boolean	успех	Принадлежит ли диапазон IP-адресов VLAN виртуальным машинам системы.
for_virtual_network boolean	успех	Является ли диапазон IP-адресов VLAN виртуального типа.
gateway string	успех	IPv4 шлюз. Пример: 10.2.4.1
gateway_ipv6 string	если доступно	IPv6 шлюз. Пример: 2001:db8::1
id string	успех	UUID диапазона IP-адресов VLAN. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6
netmask string	успех	IPv4 маска сети. Пример: 255.255.255.0
network string	если доступно	Сеть диапазона vlan. Пример: test
physical_network string	успех	Физическая сеть, к которой принадлежит диапазон IP-адресов VLAN. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6
project string	если доступно	Проект, владеющий сетью. Пример: примерный проект
start_ip string	успех	Начальный IP-адрес диапазона IP-адресов VLAN. Пример: 10.2.4.10
start_ipv6 string	если доступно	Начальный IPv6-адрес диапазона IP-адресов VLAN. Пример: 2001:db8::10
vlan string	успех	Идентификатор или VID VLAN. Пример: vlan://98
zone string	успех	Название зоны. Пример: zone-02

Авторы

David Passante (@dpassante)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_vlan_ip_range_module.html