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 или имя) при использовании состояния отсутствия. | |
| 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. [сообщество]
Авторы
- 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.8/modules/oneandone_private_network_module.html
