meraki_vlan – Управление VLAN в облаке Meraki

Новое в версии 2.7.

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

Описание

Создание, редактирование, запросы или удаление VLAN в среде Meraki.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
appliance_ip -		IP-адрес устройства. Адрес должен находиться в подсети, указанной в параметре `subnet`.
auth_key -		Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная среды MERAKI_KEY не задана.
dns_nameservers -		Список IP-адресов DNS, разделенных точкой с запятой. Укажите один из следующих вариантов для предварительно запрограммированных записей DNS: opendns, google_dns, upstream_dns
fixed_ip_assignments -		Назначение статических IP-адресов, которые будут распределяться через DHCP по MAC-адресу.
host строка	По умолчанию: "api.meraki.com"	Имя хоста для панели управления Meraki. Полезно только для внутренних разработчиков Meraki.
name -		Имя VLAN. Псевдонимы: vlan_name
net_id -		Идентификатор сети, в которой находится или должна находиться VLAN.
net_name -		Имя сети, в которой находится или должна находиться VLAN. Псевдонимы: network
org_id -		Идентификатор организации.
org_name -		Имя организации. Псевдонимы: организация
output_level -	Варианты: normal ← debug	Устанавливает количество отладочного вывода во время выполнения модуля
reserved_ip_range -		Диапазоны IP-адресов, которые следует зарезервировать и не распределять через DHCP.
state -	Варианты: absent present query ←	Указывает, следует ли запросить объект, создать/изменить или удалить.
subnet -		Подсеть сети в CIDR-нотации.
timeout целое число	По умолчанию: 30	Время ожидания для HTTP-запросов.
use_https булево	Варианты: нет да ←	Если `no`, будет использоваться HTTP. В противном случае будет использоваться HTTPS. Полезно только для внутренних разработчиков Meraki.
use_proxy булево	Варианты: нет да	Если `no`, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах.
validate_certs булево	Варианты: нет да ←	Включить проверку сертификатов HTTP.
vlan_id -		Идентификационный номер VLAN. Идентификатор должен быть в диапазоне от 1 до 4096.
vpn_nat_subnet -		Перевод подсети VPN, если VPN и перевод подсети VPN включены в VLAN.

Примечания

Примечание

Некоторые параметры, вероятно, используются только разработчиками Meraki.
API Meraki по умолчанию не позволяет использовать VLAN на сетях, и нет способа включить поддержку VLAN в API. Поддержка VLAN должна быть включена вручную.
Более подробную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
Некоторые параметры, вероятно, используются только разработчиками Meraki

Примеры

- name: Query all VLANs in a network.
  meraki_vlan:
    auth_key: abc12345
    org_name: YourOrg
    net_name: YourNet
    state: query
  delegate_to: localhost

- name: Query information about a single VLAN by ID.
  meraki_vlan:
    auth_key: abc12345
    org_name: YourOrg
    net_name: YourNet
    vlan_id: 2
    state: query
  delegate_to: localhost

- name: Create a VLAN.
  meraki_vlan:
    auth_key: abc12345
    org_name: YourOrg
    net_name: YourNet
    state: present
    vlan_id: 2
    name: TestVLAN
    subnet: 192.0.1.0/24
    appliance_ip: 192.0.1.1
  delegate_to: localhost

- name: Update a VLAN.
  meraki_vlan:
    auth_key: abc12345
    org_name: YourOrg
    net_name: YourNet
    state: present
    vlan_id: 2
    name: TestVLAN
    subnet: 192.0.1.0/24
    appliance_ip: 192.168.250.2
    fixed_ip_assignments:
      - mac: "13:37:de:ad:be:ef"
        ip: 192.168.250.10
        name: fixed_ip
    reserved_ip_range:
      - start: 192.168.250.10
        end: 192.168.250.20
        comment: reserved_range
    dns_nameservers: opendns
  delegate_to: localhost

- name: Delete a VLAN.
  meraki_vlan:
    auth_key: abc12345
    org_name: YourOrg
    net_name: YourNet
    state: absent
    vlan_id: 2
  delegate_to: localhost

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

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

Ключ				Возвращаемое значение	Описание
response сложный				успех	Информация об организации, которая была создана или изменена
	applianceIp строка			успех	IP-адрес устройства Meraki во VLAN Пример: 192.0.1.1
	dhcpBootFilename строка			успех	Имя файла загрузки. Пример: boot.txt
	dhcpBootNextServer строка			успех	Параметр DHCP для перенаправления клиентов на сервер для загрузки файла загрузки. Пример: 192.0.1.2
	dhcpBootOptionsEnabled булево			успех	Включены ли параметры DHCP boot?
	dhcpHandling строка			успех	Состояние DHCP-сервера в VLAN. Пример: Запустить DHCP-сервер
	dhcpLeaseTime строка			успех	Срок аренды DHCP при активном сервере. Пример: 1 день
	dhcpOptions сложный			успех	Параметры DHCP.
		code целое число		успех	Код параметра DHCP. Целое число от 2 до 254. Пример: 43
		type строка		успех	Тип параметра DHCP. Варианты: `text`, `ip`, `hex`, `integer`. Пример: текст
		value строка		успех	Значение параметра DHCP. Пример: 192.0.1.2
	dnsnamservers строка			успех	IP-адрес или определённые Meraki DNS-серверы, которые VLAN должна использовать по умолчанию Пример: upstream_dns
	fixedIpAssignments сложный			успех	Список MAC-адресов, которым назначены IP-адреса.
		macaddress сложный		успех	MAC-адрес, которому назначен IP-адрес. Ключевое значение - фактический MAC-адрес.
			ip строка	успех	IP-адрес, назначенный MAC-адресу. Пример: 192.0.1.4
			name строка	успех	Дескриптивное имя для привязки. Пример: fixed_ip
	id целое число			успех	Номер идентификатора VLAN. Пример: 2
	name строка			успех	Дескриптивное имя VLAN. Пример: TestVLAN
	networkId строка			успех	Номер идентификатора Meraki сети, к которой относится VLAN. Пример: N_12345
	reservedIpRanges сложный			успех	Список диапазонов IP-адресов, зарезервированных для статической привязки.
		comment строка		успех	Описание резервирования IP-адресов. Пример: reserved_range
		end строка		успех	Последний IP-адрес в диапазоне резервирования. Пример: 192.0.1.10
		start строка		успех	Первый IP-адрес в диапазоне резервирования. Пример: 192.0.1.5
	subnet строка			успех	IP-подсеть VLAN в CIDR-нотации. Пример: 192.0.1.0/24

Статус

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

Авторы

Kevin Breit (@kbreit)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/meraki_vlan_module.html