community.general.dimensiondata_network – Создание, обновление и удаление сетей MCP 1.0 и 2.0
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.dimensiondata_network.
Описание
- Создание, обновление и удаление сетей MCP 1.0 и 2.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description строка | Дополнительное описание домена сети. | |
| location строка / обязательно | Целевой дата-центр. | |
| mcp_password строка | Пароль для аутентификации в API CloudControl. Если не указано, будет использоваться значение из переменной среды MCP_PASSWORD, или ~/.dimensiondata. Требуется, если указан параметр mcp_user. | |
| mcp_user строка | Имя пользователя для аутентификации в API CloudControl. Если не указано, будет использоваться значение из переменной среды MCP_USER, или ~/.dimensiondata. | |
| name строка / обязательно | Имя домена сети для создания. | |
| region строка | Значение по умолчанию: "na" | Целевой регион. Регионы определены в проекте Apache libcloud [libcloud/common/dimensiondata.py] Они также перечислены в https://libcloud.readthedocs.io/en/latest/compute/drivers/dimensiondata.html
Обратите внимание, что значение по умолчанию "na" означает "Северная Америка". Модуль добавляет префикс 'dd-' к выбору региона. |
| service_plan строка |
| Пакет услуг, либо "ESSENTIALS", либо "ADVANCED". Только для MCP 2.0. |
| state строка |
| Ресурс должен быть присутствующим или отсутствующим. |
| validate_certs булево |
| Если false, сертификаты SSL не будут проверены.Это следует использовать только в частных экземплярах API CloudControl, использующих самозаверенные сертификаты. |
| wait булево |
| Должны ли мы ожидать завершения задачи перед переходом к следующей? |
| wait_poll_interval целое число | Значение по умолчанию: 2 | Количество времени (в секундах) ожидания между проверками завершения задачи. Применимо только если wait=true. |
| wait_time целое число | Значение по умолчанию: 600 | Максимальное время (в секундах) ожидания завершения задачи. Применимо только если wait=true. |
Примеры
- name: Create an MCP 1.0 network
community.general.dimensiondata_network:
region: na
location: NA5
name: mynet
- name: Create an MCP 2.0 network
community.general.dimensiondata_network:
region: na
mcp_user: my_user
mcp_password: my_password
location: NA9
name: mynet
service_plan: ADVANCED
- name: Delete a network
community.general.dimensiondata_network:
region: na
location: NA1
name: mynet
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| network сложный тип | При успехе, когда state=present. | Словарь, описывающий сеть. | |
| description строка | успех | Описание сети. Пример: Описание моей сети | |
| id строка | успех | Идентификатор сети. Пример: 8c787000-a000-4050-a215-280893411a7d | |
| location строка | успех | Расположение дата-центра. Пример: NA3 | |
| multicast булево | успех | Включен мультидоступ? (только MCP 1.0) | |
| name строка | успех | Имя сети. Пример: Моя сеть | |
| private_net строка | успех | Приватный подсеть сети. (только MCP 1.0) Пример: 10.2.3.0 | |
| status строка | успех | Статус сети. (только MCP 2.0) Пример: NORMAL | |
Авторы
- Aimon Bustardo (@aimonb)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/dimensiondata_network_module.html
