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

Новая в версии 2.5.

Описание
Параметры
Примеры
Возвращаемые значения
Статус

Описание

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

Параметры

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

Примеры

# Add or update VLAN
- 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
# Read / get VLAN details
- dimensiondata_vlan:
    region: na
    location: NA5
    network_domain: test_network
    name: my_vlan1
    state: readonly
    wait: yes
# Delete a VLAN
- dimensiondata_vlan:
    region: na
    location: NA5
    network_domain: test_network
    name: my_vlan_1
    state: absent
    wait: yes

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

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

Ключ		Возвращаемое значение	Описание
vlan complex		При успехе, когда state равен 'present'	Словарь, описывающий 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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается Сообществом Ansible. [сообщество]

Авторы

Adam Friedman (@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.9/modules/dimensiondata_vlan_module.html