oneandone_private_network - Настройка частной сети 1&1.
Новое в версии 2.5.
Обзор
- Создание, удаление, переконфигурация, обновление частной сети. Этот модуль зависит от 1and1 >= 1.0
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- 1and1
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_members | Список идентификаторов серверов (имя или идентификатор), которые необходимо добавить в частную сеть. | |
| 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 или имя) сети, используемый в состоянии update. | |
| remove_members | Список идентификаторов серверов (имя или идентификатор), которые необходимо удалить из частной сети. | |
| state |
| Определяет состояние сети для создания, удаления или обновления. |
| subnet_mask | Установите маску подсети для частной сети, например, 255.255.255.0 | |
| wait bool |
| ожидать, пока экземпляр не перейдет в состояние 'running' перед возвратом |
| wait_interval | По умолчанию: 5 | Определяет количество секунд ожидания при использовании методов _wait_for |
| wait_timeout | По умолчанию: 600 | Сколько времени ожидать, прежде чем wait прекратит ожидание, в секундах |
Примеры
# 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 dict | всегда | Информация о частной сети. Пример: {"name": "backup_network", "id": "55726DEDA20C99CF6F2AF8F18CAC9963"} |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как community, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом 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.6/modules/oneandone_private_network_module.html
