Модуль cisco.dnac.reserve_ip_subpool_create – Модуль ресурса для создания резервируемого IP-субпула

Примечание

Этот модуль входит в коллекцию cisco.dnac (версия 6.20.0).

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

Для установки используйте: ansible-galaxy collection install cisco.dnac. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в playbook укажите: cisco.dnac.reserve_ip_subpool_create.

Добавлен в cisco.dnac 4.0.0

Обзор
Требования
Параметры
Примечания
См. также
Примеры
Значения возврата

Обзор

Управление операцией создания ресурса Reserve Ip Subpool Create.
API для резервирования IP-субпула из глобального пула.

Примечание

Данный модуль имеет соответствующий плагин действий.

Требования

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

dnacentersdk >= 2.7.2
python >= 3.5

Параметры

Параметр	Комментарии
dnac_debug boolean	Флаг для Cisco DNA Center SDK для включения отладки. Варианты: `false` ← (default) `true`
dnac_host string / required	Имя хоста Cisco DNA Center.
dnac_password string	Пароль Cisco DNA Center для аутентификации.
dnac_port integer	Порт Cisco DNA Center. По умолчанию: `443`
dnac_username aliases: user string	Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: `"admin"`
dnac_verify boolean	Флаг для включения или отключения проверки SSL-сертификата. Варианты: `false` `true` ← (default)
dnac_version string	Информирует SDK о версии Cisco DNA Center, которая будет использоваться. По умолчанию: `"2.3.7.6"`
ipv4DhcpServers list / elements=string	IPv4-ввод для IP-адреса DHCP-сервера, например, «1.1.1.1».
ipv4DnsServers list / elements=string	IPv4-ввод для IP-адреса DNS-сервера, например, «4.4.4.4».
ipv4GateWay string	Данные IP-адреса шлюза, например, 175.175.0.1.
ipv4GlobalPool string	IP v4-адрес глобального пула с CIDR, например, 175.175.0.0/16.
ipv4Prefix boolean	Если значение IPv4 prefix равно true, поле ввода длины префикса ip4 включено, если оно равно false, включен ввод общего количества хостов ipv4. Варианты: `false` `true`
ipv4PrefixLength integer	Длина префикса ipv4 необходима, когда значение ipv4prefix равно true.
ipv4Subnet string	IPv4-адрес подсети, например, 175.175.0.0. Необходимо передать либо ipv4Subnet, либо ipv4TotalHost при создании IPv4-подпула.
ipv4TotalHost integer	Общее количество хостов IPv4 необходимо, когда значение ipv4prefix равно false.
ipv6AddressSpace boolean	Если значение опущено или равно false, необходим только ввод ipv4, в противном случае необходимы как ipv6, так и ipv4. Варианты: `false` `true`
ipv6DhcpServers list / elements=string	DHCP-сервер в формате IPv6, например, «2001 db8 1234».
ipv6DnsServers list / elements=string	DNS-сервер в формате IPv6, например, «2001 db8 1234».
ipv6GateWay string	Данные IP-адреса шлюза, например, 2001 db8 85a3 0 100 1.
ipv6GlobalPool string	IPv6-адрес глобального пула с CIDR, это необходимо, когда значение Ipv6AddressSpace равно true, например, 2001 db8 85a3 /64.
ipv6Prefix boolean	Если значение ipv6 prefix равно true, поле ввода длины префикса ip6 включено, если оно равно false, включен ввод общего количества хостов ipv6. Варианты: `false` `true`
ipv6PrefixLength integer	Длина префикса IPv6 необходима, когда значение ipv6prefix равно true.

ipv6Subnet string	Адрес подсети IPv6, пример 2001 db8 85a3 0 100. Нужно указать либо ipv6Subnet, либо ipv6TotalHost при создании подсети IPv6.
ipv6TotalHost integer	Полное количество хостов IPv6 необходимо, когда значение ipv6prefix равно false.
name string	Имя резервируемой подсети IP.
siteId string	Параметр пути siteId. Идентификатор сайта для резервирования подсети IP.
slaacSupport boolean	Поддержка SLAAC. Варианты: `false` `true`
type string	Тип резервируемой подсети IP.
validate_response_schema boolean	Флаг для Cisco DNA Center SDK для включения проверки тел запросов по схеме JSON. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Используемые методы SDK: network_settings.NetworkSettings.reserve_ip_subpool,
Используемые пути: post /dna/intent/api/v1/reserve-ip-subpool/{siteId},
Не поддерживает check_mode
Плагин работает на контрольном узле и не использует плагины соединения ansible, а вместо этого использует встроенный менеджер подключений Cisco DNAC SDK
Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления соединения

См. также

Документация Cisco DNA Center по резервированию подсети Network Settings ReserveIPSubpool: Полное описание API ReserveIPSubpool.

Примеры

- name: Create
  cisco.dnac.reserve_ip_subpool_create:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    ipv4DhcpServers:
    - string
    ipv4DnsServers:
    - string
    ipv4GateWay: string
    ipv4GlobalPool: string
    ipv4Prefix: true
    ipv4PrefixLength: 0
    ipv4Subnet: string
    ipv4TotalHost: 0
    ipv6AddressSpace: true
    ipv6DhcpServers:
    - string
    ipv6DnsServers:
    - string
    ipv6GateWay: string
    ipv6GlobalPool: string
    ipv6Prefix: true
    ipv6PrefixLength: 0
    ipv6Subnet: string
    ipv6TotalHost: 0
    name: string
    siteId: string
    slaacSupport: true
    type: string

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

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

Ключ	Описание
dnac_response словарь	Словарь или список с ответом, возвращенным Cisco DNAC Python SDK Возвращается: всегда Пример: `{"executionId": "string", "executionStatusUrl": "string", "message": "string"}`

Авторы

Rafael Campos (@racampos)

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

© 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/cisco/dnac/reserve_ip_subpool_create_module.html