Модуль community.general.dimensiondata_network — Создание, обновление и удаление сетей MCP 1.0 и 2.0

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

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

Для установки используйте: 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 строка	Целевой регион. Регионы определены в проекте Apache libcloud [libcloud/common/dimensiondata.py]. Они также перечислены в https://libcloud.readthedocs.io/en/latest/compute/drivers/dimensiondata.html. Обратите внимание, что значение по умолчанию `na` обозначает «Северная Америка». Модуль добавляет `dd-` к выбору региона. По умолчанию: `"na"`
service_plan строка	План услуг, либо «ESSENTIALS», либо «ADVANCED». Только для MCP 2.0. Варианты: `"ESSENTIALS"` ← (по умолчанию) `"ADVANCED"`
state строка	Ресурс должен быть присутствующим или отсутствующим. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs булево	Если `false`, сертификаты SSL не будут проверены. Это следует использовать только с частными экземплярами API CloudControl, которые используют самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)
wait булево	Должны ли мы ждать завершения задачи, прежде чем перейти к следующей. Варианты: `false` ← (по умолчанию) `true`
wait_poll_interval целое число	Время (в секундах) ожидания между проверками завершения задачи. Применимо только если `wait=true`. По умолчанию: `2`
wait_time целое число	Максимальное время (в секундах) ожидания завершения задачи. Применимо только если `wait=true`. По умолчанию: `600`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может работать в режиме `check_mode` и возвращать прогноз статуса изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Вернёт детали изменений (или, возможно, необходимых изменений в `check_mode`) при использовании режима diff.

Примеры

- 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 строка	Описание сети. Возвращается: успех Пример: `"My network description"`
id строка	ID сети. Возвращается: успех Пример: `"8c787000-a000-4050-a215-280893411a7d"`
location строка	Расположение дата-центра. Возвращается: успех Пример: `"NA3"`
multicast булево	Включен ли мультипост? (только MCP 1.0) Возвращается: успех Пример: `false`
name строка	Имя сети. Возвращается: успех Пример: `"My network"`
private_net строка	Подсеть частной сети. (только MCP 1.0) Возвращается: успех Пример: `"10.2.3.0"`
status строка	Статус сети. (только MCP 2.0) Возвращается: успех Пример: `"NORMAL"`

Авторы

Aimon Bustardo (@aimonb)

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

© 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/community/general/dimensiondata_network_module.html