Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции ngine_io.cloudstack (версия 2.5.0).

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

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

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

Новое в ngine_io.cloudstack 0.1.0

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

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

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

account

string

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

Взаимоисключающий с project.

api_http_method

string

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

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

Варианты:

  • "get" ← (default)
  • "post"

api_key

string / required

Ключ API CloudStack API.

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

api_secret

string / required

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

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

api_timeout

integer

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

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

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

api_url

string / required

URL CloudStack API, например 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 установлен для системных VM, no если нет

Варианты:

  • false ← (default)
  • true

for_virtual_network

boolean

added in ngine_io.cloudstack 1.0.0

yes если VLAN виртуального типа, no если прямого.

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

Варианты:

  • false ← (default)
  • true

gateway

string

Шлюз диапазона IP VLAN.

Требуется, если state=present.

gateway_ipv6

string

Шлюз IPv6 сети.

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

netmask

string

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

Требуется, если state=present.

network

string

Имя или ID сети.

Требуется, если for_virtual_network и physical_network не установлены.

physical_network

string

Имя или ID физической сети.

pod

string

added in ngine_io.cloudstack 1.0.0

Имя подсети.

project

string

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

Взаимоисключающий с account.

start_ip

string / required

Начальный IPv4 адрес в диапазоне IP VLAN.

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

start_ipv6

string

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

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

state

string

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

Варианты:

  • "present" ← (default)
  • "absent"

validate_certs

boolean

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

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

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

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

Варианты:

  • false
  • true ← (default)

vlan

string

ID или VID сети.

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

zone

string / required

ID зоны диапазона 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

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

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

Пример: "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 виртуального типа или нет.

Возвращается: успех

Пример: 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

ID или VID VLAN.

Возвращается: успех

Пример: "vlan://98"

zone

string

Название зоны.

Возвращается: успех

Пример: "zone-02"

Авторы

  • David Passante (@dpassante)

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

  • Система отслеживания ошибок
  • Репозиторий (Исходный код)

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

Spec-Zone.ru

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