cisco.meraki.meraki_mx_vlan – Управление VLAN в облаке Meraki

Примечание

Этот плагин входит в коллекцию cisco.meraki (версия 2.2.0).

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

Для использования в книге задач укажите: cisco.meraki.meraki_mx_vlan.

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
appliance_ip строка			IP-адрес устройства. Адрес должен находиться в подсети, указанной в параметре `subnet`.
auth_key строка / обязательно			Ключ аутентификации, предоставленный панелью управления. Требуется, если переменная окружения `MERAKI_KEY` не задана.
dhcp_boot_filename строка			Имя файла для загрузки при DHCP-загрузке.
dhcp_boot_next_server строка			Параметр DHCP для направления загрузки клиентов на сервер для загрузки файла загрузки.
dhcp_boot_options_enabled булево		Варианты: нет да	Включить параметры DHCP-загрузки.
dhcp_handling строка		Варианты: Запустить DHCP-сервер Передать DHCP другому серверу Не отвечать на запросы DHCP нет сервер ретрансляция	Как обрабатывать пакеты DHCP в сети.
dhcp_lease_time строка		Варианты: 30 минут 1 час 4 часа 12 часов 1 день 1 неделя	Настройка таймера аренды DHCP.
dhcp_options список / элементы=словарь			Список значений параметров DHCP.
	code целое число		Номер опции DHCP.
	type строка	Варианты: текст ip шестнадцатеричный целое число	Тип значения для опции DHCP.
	value строка		Значение для опции DHCP.
dhcp_relay_server_ips список / элементы=строка			IP-адреса для пересылки пакетов DHCP.
dns_nameservers строка			Список IP-адресов DNS, разделенных точкой с запятой. Укажите один из следующих вариантов для предварительно запрограммированных записей DNS: opendns, google_dns, upstream_dns
fixed_ip_assignments список / элементы=словарь			Назначения статических IP-адресов, которые должны распределяться через DHCP по MAC-адресу.
	ip строка		IP-адрес для привязки статического IP-адреса.
	mac строка		MAC-адрес для привязки статического IP-адреса.
	name строка		Дескриптивное имя привязки IP-адреса.
host строка		По умолчанию: "api.meraki.com"	Имя хоста для панели управления Meraki. Можно использовать для доступа к региональным средам Meraki, таким как Китай.
internal_error_retry_time целое число		По умолчанию: 60	Количество секунд для повторной попытки, если сервер возвращает ошибку внутренней серверной ошибки.
name строка			Имя VLAN. псевдонимы: vlan_name
net_id строка			Идентификатор сети, в которой находится или должна находиться VLAN.
net_name строка			Имя сети, в которой находится или должна находиться VLAN. псевдонимы: сеть
org_id строка			Идентификатор организации.
org_name строка			Имя организации. псевдонимы: организация
output_format строка		Варианты: snakecase ← camelcase	Указывает модулю, должны ли ключи ответа быть в формате snake case (например, `net_id`) или camel case (например, `netId`).
output_level строка		Варианты: отладка обычный ←	Устанавливает количество отладочной информации во время выполнения модуля.
rate_limit_retry_time целое число		По умолчанию: 165	Количество секунд для повторной попытки, если срабатывает ограничитель скорости.
reserved_ip_range список / элементы=словарь			Диапазоны IP-адресов, которые должны быть зарезервированы и не распределены через DHCP.
	comment строка		Описание резервирования IP-адресов.
	end строка		Последний IP-адрес зарезервированного диапазона IP-адресов включительно.
	start строка		Первый IP-адрес зарезервированного диапазона IP-адресов включительно.
state строка		Варианты: отсутствует присутствует запрос ←	Указывает, следует ли запросить объект, создать/изменить или удалить.
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.

Примечания

Примечание

API Meraki вернёт ошибку, если VLAN не включены в сети. VLAN возвращаются правильно, если VLAN включены в сети.
Некоторые опции, вероятно, используются только разработчиками Meraki.
API Meraki по умолчанию предполагает, что поддержка VLAN в сетях отключена, и нет способа включить поддержку VLAN в API. Поддержка VLAN должна быть включена вручную.
Дополнительную информацию об API Meraki можно найти по адресу https://dashboard.meraki.com/api_docs.
Некоторые опции, вероятно, используются только разработчиками Meraki.
Начиная с Ansible 2.9, модули Meraki выводят ключи в формате snake case. Чтобы использовать camel case, установите переменную окружения ANSIBLE_MERAKI_FORMAT в camelcase.
Модули Meraki Ansible прекратят поддержку вывода camel case в Ansible 2.13. Обновите свои книги задач.
Режим проверки загружает текущую конфигурацию с панели управления, а затем сравнивает изменения с этой загрузкой. Режим проверки сообщит об изменениях, если есть различия в конфигурациях, но не отправляет изменения в API для проверки изменений.

Примеры

- 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: Enable DHCP on VLAN with options
  meraki_vlan:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_name: YourNet
    vlan_id: 2
    name: TestVLAN
    subnet: 192.168.250.0/24
    appliance_ip: 192.168.250.2
    dhcp_handling: server
    dhcp_lease_time: 1 hour
    dhcp_boot_options_enabled: false
    dhcp_options:
      - code: 5
        type: ip
        value: 192.0.1.1
  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 complex				success	Информация об организации, которая была создана или изменена
	appliance_ip string			success	IP-адрес устройства Meraki в VLAN Пример: 192.0.1.1
	dhcp_boot_filename string			success	Имя файла загрузки. Пример: boot.txt
	dhcp_boot_next_server string			success	Параметр DHCP для перенаправления загрузки клиентов на сервер для загрузки файла загрузки. Пример: 192.0.1.2
	dhcp_boot_options_enabled boolean			success	Включены ли параметры загрузки DHCP.
	dhcp_handling string			success	Состояние DHCP-сервера на VLAN. Пример: Запуск DHCP-сервера
	dhcp_lease_time string			success	Срок аренды DHCP, когда сервер активен. Пример: 1 день
	dhcp_options complex			success	Параметры DHCP.
		code integer		success	Код для параметра DHCP. Целое число от 2 до 254. Пример: 43
		type string		success	Тип параметра DHCP. Варианты: `text`, `ip`, `hex`, `integer`. Пример: text
		value string		success	Значение параметра DHCP. Пример: 192.0.1.2
	dnsnamservers string			success	IP-адрес или определённые Meraki DNS-серверы, которые VLAN должен использовать по умолчанию Пример: upstream_dns
	fixed_ip_assignments complex			success	Список MAC-адресов, которым назначены IP-адреса.
		macaddress complex		success	MAC-адрес, которому назначен IP-адрес. Ключевое значение - фактический MAC-адрес.
			ip string	success	IP-адрес, назначенный MAC-адресу. Пример: 192.0.1.4
			name string	success	Дескриптивное имя для привязки. Пример: fixed_ip
	id integer			success	Номер идентификатора VLAN. Пример: 2
	name string			success	Дескриптивное имя VLAN. Пример: TestVLAN
	networkId string			success	Идентификатор Meraki сети, к которой связан VLAN. Пример: N_12345
	reserved_ip_ranges complex			success	Список диапазонов IP-адресов, зарезервированных для статического назначения.
		comment string		success	Описание для резервирования IP-адреса. Пример: reserved_range
		end string		success	Последний IP-адрес в диапазоне резервирования. Пример: 192.0.1.10
		start string		success	Первый IP-адрес в диапазоне резервирования. Пример: 192.0.1.5
	subnet string			success	IP-подсеть VLAN в CIDR-нотации. Пример: 192.0.1.0/24

Авторы

Kevin Breit (@kbreit)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/meraki/meraki_mx_vlan_module.html