community.general.dimensiondata_vlan – Управление VLAN в домене сети Cloud Control.

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

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

Для использования в книге задач укажите: community.general.dimensiondata_vlan

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

Обзор

Управление VLAN в домене сети Cloud Control.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_expand boolean	Варианты: нет ← да	Разрешить расширение сети целевого VLAN, если параметры модуля указывают на более широкую сеть, чем та, которой обладает VLAN в настоящее время. Если `False`, модуль завершится неудачей в этих условиях. Это предназначено для предотвращения случайного расширения сети VLAN (поскольку эта операция необратима).
description string		Описание VLAN.
location string / required		Целевой дата-центр.
mcp_password string		Пароль, используемый для аутентификации в API CloudControl. Если не указано, будет использоваться значение по умолчанию из переменной окружения или `~/.dimensiondata` Требуется, если указан параметр mcp_user.
mcp_user string		Имя пользователя, используемый для аутентификации в API CloudControl. Если не указано, будет использоваться значение по умолчанию из переменной окружения или `~/.dimensiondata`
name string / required		Имя целевого VLAN.
network_domain string / required		Идентификатор или имя целевого домена сети.
private_ipv4_base_address string		Базовый адрес IPv4 сети VLAN (например, 192.168.1.0).
private_ipv4_prefix_size integer		Размер адресного пространства IPv4, например 24. Требуется, если указан `private_ipv4_base_address`
region string	Значение по умолчанию: "na"	Целевой регион. Регионы определены в проекте Apache libcloud [libcloud/common/dimensiondata.py] Они также перечислены на https://libcloud.readthedocs.io/en/latest/compute/drivers/dimensiondata.html Обратите внимание, что значение по умолчанию "na" означает "Северная Америка". Модуль добавляет "dd-" к выбору региона.
state string	Варианты: наличие ← отсутствие только для чтения	Желаемое состояние целевого VLAN. `readonly` гарантирует, что состояние будет только считываться, а не изменяться (модуль завершится ошибкой, если ресурс не существует).
validate_certs boolean	Варианты: нет да ←	Если `false`, сертификаты SSL не будут проверены. Это следует использовать только для частных экземпляров API CloudControl, использующих самозаверяющие сертификаты.
wait boolean	Варианты: нет ← да	Должны ли мы ждать завершения задачи перед переходом к следующей.
wait_poll_interval integer	Значение по умолчанию: 2	Время (в секундах) ожидания между проверками завершения задачи. Применимо только если wait=true.
wait_time integer	Значение по умолчанию: 600	Максимальное время (в секундах) ожидания завершения задачи. Применимо только если wait=true.

Примеры

- name: Add or update VLAN
  community.general.dimensiondata_vlan:
    region: na
    location: NA5
    network_domain: test_network
    name: my_vlan1
    description: A test VLAN
    private_ipv4_base_address: 192.168.23.0
    private_ipv4_prefix_size: 24
    state: present
    wait: yes

- name: Read / get VLAN details
  community.general.dimensiondata_vlan:
    region: na
    location: NA5
    network_domain: test_network
    name: my_vlan1
    state: readonly
    wait: yes

- name: Delete a VLAN
  community.general.dimensiondata_vlan:
    region: na
    location: NA5
    network_domain: test_network
    name: my_vlan_1
    state: absent
    wait: yes

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

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

Ключ		Возвращается	Описание
vlan complex		При успешном выполнении, когда state равен 'наличие'	Словарь, описывающий VLAN.
	description string	успех	Описание VLAN. Пример: Описание моего VLAN
	id string	успех	Идентификатор VLAN. Пример: aaaaa000-a000-4050-a215-2808934ccccc
	location string	успех	Местоположение дата-центра. Пример: NA3
	name string	успех	Название VLAN. Пример: Мой VLAN
	private_ipv4_base_address string	успех	Базовый адрес частной сети IPV4 VLAN. Пример: 192.168.23.0
	private_ipv4_gateway_address string	успех	Адрес шлюза частной сети IPV4 VLAN. Пример: 192.168.23.1
	private_ipv4_prefix_size integer	успех	Размер префикса частной сети IPV4 VLAN. Пример: 24
	private_ipv6_base_address string	успех	Базовый адрес сети IPV6 VLAN. Пример: 2402:9900:111:1195:0:0:0:0
	private_ipv6_gateway_address string	успех	Адрес шлюза сети IPV6 VLAN. Пример: 2402:9900:111:1195:0:0:0:1
	private_ipv6_prefix_size integer	успех	Размер префикса сети IPV6 VLAN. Пример: 64
	status string	успех	Статус VLAN. Пример: NORMAL

Авторы

Адам Фридман (@tintoy)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/dimensiondata_vlan_module.html