oneandone_private_network – Настройка частной сети 1&1
Новая версия 2.5.
Обзор
- Создание, удаление, переконфигурация, обновление частной сети. Этот модуль зависит от 1and1 >= 1.0
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- 1and1
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
add_members
-
|
Список идентификаторов серверов (имя или ID), которые необходимо добавить в частную сеть.
|
|
|
api_url
-
|
Пользовательский URL API. Переопределяет переменную окружения ONEANDONE_API_URL.
|
|
|
auth_token
- / обязательно
|
Аутентифицирующий токен API, предоставленный 1&1.
|
|
|
datacenter
-
|
Идентификатор дата-центра, где будет создана частная сеть.
|
|
|
description
-
|
Установите описание для сети.
|
|
|
name
- / обязательно
|
Имя частной сети, используемое при проверке состояния. Используется в качестве идентификатора (ID или имя) при использовании состояния absent.
|
|
|
network_address
-
|
Укажите пространство частной сети, например, 192.168.1.0
|
|
|
private_network
- / обязательно
|
Идентификатор (ID или имя) сети, используемой при обновлении состояния.
|
|
|
remove_members
-
|
Список идентификаторов серверов (имя или ID), которые необходимо удалить из частной сети.
|
|
|
state
-
|
|
Определите состояние сети для создания, удаления или обновления.
|
|
subnet_mask
-
|
Установите маску подсети для частной сети, например, 255.255.255.0
|
|
|
wait
boolean
|
|
дождаться состояния экземпляра 'running', прежде чем вернуть значение
|
|
wait_interval
-
|
По умолчанию: 5
|
Определяет количество секунд ожидания при использовании методов _wait_for
|
|
wait_timeout
-
|
По умолчанию: 600
|
время ожидания в секундах
|
Примеры
# Provisioning example. Create and destroy private networks.
- 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
- oneandone_private_network:
auth_token: oneandone_private_api_key
state: absent
name: backup_network
# Modify the private network.
- 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
# Add members to the private network.
- oneandone_private_network:
auth_token: oneandone_private_api_key
state: update
private_network: backup_network
add_members:
- server identifier (id or name)
# Remove members from the private network.
- oneandone_private_network:
auth_token: oneandone_private_api_key
state: update
private_network: backup_network
remove_members:
- server identifier (id or name)
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
|
private_network
словарь
|
всегда |
Информация о частной сети.
Пример:
{"name": "backup_network", "id": "55726DEDA20C99CF6F2AF8F18CAC9963"}
|
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Amel Ajdinovic (@aajdinov)
- Ethan Devenport (@edevenport)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/oneandone_private_network_module.html
