Spec-Zone.ru › Ansible

Модуль ngine_io.cloudstack.vlan_ip_range — управление диапазонами IP-адресов VLAN в облаках на базе 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.vlan_ip_range.

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

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

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

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

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

account

string

Учетная запись, которой принадлежит VLAN.

Взаимоисключающий параметр с project.

api_http_method

string

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

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

Варианты:

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

api_key

string / обязательный

Ключ API CloudStack.

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

api_secret

string / обязательный

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

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

api_timeout

integer

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

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

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

api_url

string / обязательный

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

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

api_verify_ssl_cert

string

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

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

cidr_ipv6

string

Блок CIDR сети IPv6; должен быть не меньше /64.

domain

string

Домен учетной записи, которой принадлежит VLAN.

end_ip

string

Последний IPv4-адрес в диапазоне IP-адресов VLAN.

Если не указан, используется значение start_ip.

Учитывается только при создании.

end_ipv6

string

Последний IPv6-адрес в диапазоне сети IPv6.

Если не указан, используется значение start_ipv6.

Учитывается только при создании.

for_system_vms

boolean

yes, если диапазон IP-адресов назначен системным виртуальным машинам, и no в противном случае

Варианты:

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

for_virtual_network

boolean

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

yes, если VLAN относится к типу Virtual, и no, если к типу Direct.

Если задано значение yes, но не указан ни physical_network, ни network, CloudStack попытается добавить диапазон VLAN в физическую сеть с типом трафика Public.

Варианты:

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

gateway

string

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

Обязательный параметр при state=present.

gateway_ipv6

string

Шлюз сети IPv6.

Учитывается только при создании.

netmask

string

Маска подсети диапазона IP-адресов VLAN.

Обязательный параметр при state=present.

network

string

Имя или идентификатор сети.

Обязательный параметр, если не заданы for_virtual_network и physical_network.

physical_network

string

Имя или идентификатор физической сети.

pod

string

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

Имя pod.

project

string

Проект, которому принадлежит VLAN.

Взаимоисключающий параметр с account.

start_ip

string / обязательный

Первый IPv4-адрес в диапазоне IP-адресов VLAN.

Учитывается только при создании.

start_ipv6

string

Первый IPv6-адрес в диапазоне сети IPv6.

Учитывается только при создании.

state

string

Состояние диапазона IP-адресов сети.

Варианты:

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

validate_certs

boolean

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

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

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

Этот параметр следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами.

Варианты:

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

vlan

string

Идентификатор или VID сети.

Если не указан, по умолчанию используется VLAN сети.

zone

string / обязательный

Идентификатор зоны диапазона IP-адресов VLAN.

Примечания

Примечание

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

Примеры

- name: create a VLAN IP range for network test
  ngine_io.cloudstack.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.vlan_ip_range:
    state: absent
    network: test
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    zone: zone-02

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

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

Ключ

Описание

account

string

Учетная запись, которой принадлежит сеть.

Возвращается: если доступно

Пример: "example account"

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 для системных виртуальных машин.

Возвращается: при успешном выполнении

Пример: false

for_virtual_network

boolean

Указывает, относится ли диапазон IP-адресов VLAN к типу Virtual.

Возвращается: при успешном выполнении

Пример: false

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

Проект, которому принадлежит сеть.

Возвращается: если доступно

Пример: "example project"

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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/vlan_ip_range_module.html

Spec-Zone.ru

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