dimensiondata_vlan — Управление VLAN в домене сети Cloud Control.
Новое в версии 2.5.
Обзор
- Управление VLAN в доменных зонах сети Cloud Control.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_expand | Значение по умолчанию: нет | Разрешить расширение сети целевого 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. | |
| status строка | Статус VLAN. Пример: НОРМАЛЬНО | ||
| private_ipv6_prefix_size целое число | Размер префикса для сети IPV6 VLAN. Пример: 64 | ||
| private_ipv6_base_address строка | Базовый адрес сети IPV6 VLAN. Пример: 2402:9900:111:1195:0:0:0:0 | ||
| private_ipv4_base_address строка | Базовый адрес частной сети IPV4 VLAN. Пример: 192.168.23.0 | ||
| name строка | Имя VLAN. Пример: Моя VLAN | ||
| private_ipv4_prefix_size целое число | Размер префикса для частной сети IPV4 VLAN. Пример: 24 | ||
| location строка | Расположение дата-центра. Пример: NA3 | ||
| private_ipv4_gateway_address строка | Адрес шлюза для частной сети IPV4 VLAN. Пример: 192.168.23.1 | ||
| private_ipv6_gateway_address строка | Адрес шлюза для сети IPV6 VLAN. Пример: 2402:9900:111:1195:0:0:0:1 | ||
| id строка | Идентификатор VLAN. Пример: aaaaa000-a000-4050-a215-2808934ccccc | ||
| description строка | Описание VLAN. Пример: Описание моей VLAN | ||
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратно совместимым.
Автор
- Адам Фридман (@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.5/modules/dimensiondata_vlan_module.html
