Модуль community.general.oneandone_private_network – Настройка частной сети 1&1

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.

Для использования в playbook, укажите: community.general.oneandone_private_network.

Краткое описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Создание, удаление, перенастройка, обновление частной сети. Этот модуль зависит от 1and1 >= 1.0.

Требования

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

1and1

Параметры

Параметр	Комментарии
add_members список / элементы=строка	Список идентификаторов серверов (имя или ID), которые нужно добавить в частную сеть. По умолчанию: `[]`
api_url строка	Пользовательский URL API. Переопределяет переменную среды ONEANDONE_API_URL.
auth_token строка	Токен аутентификации API, предоставленный 1&1.
datacenter строка	Идентификатор ЦОД, где будет создана частная сеть Варианты: `"US"` `"ES"` `"DE"` `"GB"`
description строка	Установите описание сети.
name строка	Имя частной сети, используемое с состоянием present. Используется в качестве идентификатора (ID или имя), когда используется с состоянием absent.
network_address строка	Установите пространство частной сети, например, 192.168.1.0
private_network строка	Идентификатор (ID или имя) сети, используемый с состоянием update.
remove_members список / элементы=строка	Список идентификаторов серверов (имя или ID), которые нужно удалить из частной сети. По умолчанию: `[]`
state строка	Определите состояние сети для создания, удаления или обновления. Варианты: `"present"` ← (по умолчанию) `"absent"` `"update"`
subnet_mask строка	Установите маску подсети для частной сети, например, 255.255.255.0
wait логическое	ждать, пока экземпляр не перейдет в состояние «запущен», прежде чем возвращаться Варианты: `false` `true` ← (по умолчанию)
wait_interval целое число	Определяет количество секунд ожидания при использовании методов _wait_for По умолчанию: `5`
wait_timeout целое число	сколько времени ждать, прежде чем ожидание завершится, в секундах По умолчанию: `600`

Атрибуты

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

Примеры

- name: Create a private network
  community.general.oneandone_private_network:
    auth_token: oneandone_private_api_key
    name: backup_network
    description: Testing creation of a private network with ansible
    network_address: 70.35.193.100
    subnet_mask: 255.0.0.0
    datacenter: US

- name: Destroy a private network
  community.general.oneandone_private_network:
    auth_token: oneandone_private_api_key
    state: absent
    name: backup_network

- name: Modify the private network
  community.general.oneandone_private_network:
    auth_token: oneandone_private_api_key
    state: update
    private_network: backup_network
    network_address: 192.168.2.0
    subnet_mask: 255.255.255.0

- name: Add members to the private network
  community.general.oneandone_private_network:
    auth_token: oneandone_private_api_key
    state: update
    private_network: backup_network
    add_members:
     - server identifier (id or name)

- name: Remove members from the private network
  community.general.oneandone_private_network:
    auth_token: oneandone_private_api_key
    state: update
    private_network: backup_network
    remove_members:
     - server identifier (id or name)

Значения возврата

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

Ключ	Описание
private_network словарь	Информация о частной сети. Возвращается: всегда Пример: `{"id": "55726DEDA20C99CF6F2AF8F18CAC9963", "name": "backup_network"}`

Авторы

Amel Ajdinovic (@aajdinov)
Ethan Devenport (@edevenport)

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

© 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/oneandone_private_network_module.html