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 обязательно |
Имя частной сети, используемое при проверке состояния. Используется в качестве идентификатора (идентификатор или имя) при использовании состояния absent. |
|
| network_address | Установите адресное пространство частной сети, например, 192.168.1.0 |
|
| private_network обязательно |
Идентификатор (идентификатор или имя) сети, используемой при обновлении состояния. |
|
| remove_members | Список идентификаторов серверов (имя или идентификатор) для удаления из частной сети. |
|
| state |
|
Определите состояние сети для создания, удаления или обновления. |
| subnet_mask | Установите маску подсети для частной сети, например, 255.255.255.0 |
|
| wait |
|
ожидание состояния экземпляра '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"} |
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/oneandone_private_network_module.html