dimensiondata_vlan - Управление VLAN в домене сети Cloud Control.
Новое в версии 2.5.
Обзор
- Управление VLAN в облачных доменных сетях Cloud Control.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_expand bool |
| Разрешить расширение сети целевого VLAN, если параметры модуля задают большую сеть, чем у VLAN в настоящее время? Если False, модуль завершится ошибкой в этих условиях.Это предназначено для предотвращения случайного расширения сети VLAN (поскольку эта операция необратима). |
| description | Описание VLAN. | |
| location обязательно | Целевой дата-центр. | |
| mcp_password | Пароль, используемый для аутентификации в API CloudControl. Если не указан, используется значение по умолчанию MCP_PASSWORD из переменной среды или ~/.dimensiondata. Необходимо, если указан параметр mcp_user. | |
| mcp_user | Имя пользователя, используемое для аутентификации в 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 |
"na" | Целевой регион. |
| state |
| Желаемое состояние целевого VLAN. readonly гарантирует, что состояние будет только считываться, а не изменяться (модуль завершится ошибкой, если ресурс не существует). |
| validate_certs | Значение по умолчанию: "да" | Если false, сертификаты SSL не будут проверяться.Это следует использовать только для частных экземпляров API CloudControl, которые используют самозаверяемые сертификаты. |
| wait | Значение по умолчанию: "нет" | Должны ли мы ожидать завершения задачи перед переходом к следующей? |
| wait_poll_interval | Значение по умолчанию: 2 | Время (в секундах) ожидания между проверками завершения задачи. Применимо только если wait=true. |
| wait_time | Значение по умолчанию: 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 сложный | При успешном выполнении, когда state равно 'present' | Словарь, описывающий VLAN. | |
| id строка | Идентификатор VLAN. Пример: aaaaa000-a000-4050-a215-2808934ccccc | ||
| name строка | Имя VLAN. Пример: Мой VLAN | ||
| description строка | Описание VLAN. Пример: Описание моего VLAN | ||
| location строка | Расположение дата-центра. Пример: NA3 | ||
| private_ipv4_base_address строка | Базовый адрес частной IPV4 сети VLAN. Пример: 192.168.23.0 | ||
| private_ipv4_prefix_size целое число | Размер префикса для частной IPV4 сети VLAN. Пример: 24 | ||
| private_ipv4_gateway_address строка | Адрес шлюза для частной IPV4 сети VLAN. Пример: 192.168.23.1 | ||
| private_ipv6_base_address строка | Базовый адрес IPV6 сети VLAN. Пример: 2402:9900:111:1195:0:0:0:0 | ||
| private_ipv6_prefix_size целое число | Размер префикса для IPV6 сети VLAN. Пример: 64 | ||
| private_ipv6_gateway_address строка | Адрес шлюза для IPV6 сети VLAN. Пример: 2402:9900:111:1195:0:0:0:1 | ||
| status строка | Статус VLAN. Пример: НОРМАЛЬНЫЙ | ||
Статус
Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Адам Фридман (@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.6/modules/dimensiondata_vlan_module.html
