cloudscale_floating_ip — Управление плавающими IP-адресами на IaaS-сервисе cloudscale.ch
Новая версия с 2.5.
Обзор
- Создание, назначение и удаление плавающих IP-адресов на IaaS-сервисе cloudscale.ch.
- Все операции выполняются с использованием публичного API v1 cloudscale.ch.
- Подробную информацию см. в полной документации API: https://www.cloudscale.ch/en/api/v1.
- Для всех операций требуется действительный токен API. Вы можете создать любое количество токенов с помощью панели управления cloudscale.ch по адресу https://control.cloudscale.ch.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Значение по умолчанию: 30 | Время ожидания в секундах для вызовов API cloudscale.ch. |
| api_token | Токен API cloudscale.ch. Также может быть передан в переменной среды CLOUDSCALE_API_TOKEN. | |
| ip | Плавающий IP-адрес для изменения. Требуется для назначения IP другому серверу или если параметр state отсутствует. псевдонимы: network | |
| ip_version |
| Версия протокола IP плавающего IP-адреса. |
| prefix_length |
| Действителен только если ip_version равен 6. Длина префикса для IPv6-сети. В настоящее время можно запросить только префикс /56. Если prefix_length не указан, создается единственный адрес. |
| reverse_ptr | Обратная запись PTR для этого адреса. Вы не можете установить обратную запись PTR для IPv6-плавающих сетей. Обратные записи PTR разрешены только для отдельных адресов. | |
| server | UUID сервера, назначенного этому плавающему IP-адресу. Требуется, если параметр state отсутствует. | |
| state |
| Состояние плавающего IP-адреса. |
Примечания
Примечание
- Вместо параметра api_token можно использовать переменную среды CLOUDSCALE_API_TOKEN.
- Для создания нового плавающего IP-адреса требуется как минимум опции
ip_versionиserver. - После создания плавающего IP-адреса все параметры, кроме
server, являются только для чтения. - Невозможно запросить плавающий IP-адрес без одновременного назначения его серверу.
- Этот модуль требует библиотеки ipaddress для языка Python. Эта библиотека включена в Python с версии 3.3. Она доступна как модуль на PyPi для более ранних версий.
Примеры
# Request a new floating IP
- name: Request a floating IP
cloudscale_floating_ip:
ip_version: 4
server: 47cec963-fcd2-482f-bdb6-24461b2d47b1
reverse_ptr: my-server.example.com
api_token: xxxxxx
register: floating_ip
# Assign an existing floating IP to a different server
- name: Move floating IP to backup server
cloudscale_floating_ip:
ip: 192.0.2.123
server: ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48
api_token: xxxxxx
# Request a new floating IPv6 network
- name: Request a floating IP
cloudscale_floating_ip:
ip_version: 6
prefix_length: 56
server: 47cec963-fcd2-482f-bdb6-24461b2d47b1
api_token: xxxxxx
register: floating_ip
# Assign an existing floating network to a different server
- name: Move floating IP to backup server
cloudscale_floating_ip:
ip: '{{ floating_ip.network | ip }}'
server: ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48
api_token: xxxxxx
# Release a floating IP
- name: Release floating IP
cloudscale_floating_ip:
ip: 192.0.2.123
state: absent
api_token: xxxxxx
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| href строка | успешно при state == present | URL API для получения подробной информации об этом плавающем IP-адресе. Пример: https://api.cloudscale.ch/v1/floating-ips/2001:db8::cafe |
| ip строка | успешно | Плавающий IP-адрес или сеть. Он всегда присутствует и используется для идентификации плавающих IP-адресов после создания. Пример: 185.98.122.176 |
| network строка | успешно при state == present | Нотация CIDR сети, маршрутизируемой на ваш сервер. Пример: 2001:db8::cafe/128 |
| next_hop строка | успешно при state == present | Ваш плавающий IP-адрес маршрутизируется на этот IP-адрес. Пример: 2001:db8:dead:beef::42 |
| reverse_ptr строка | успешно при state == present | Обратный указатель PTR для этого плавающего IP-адреса. Пример: 185-98-122-176.cust.cloudscale.ch |
| server строка | успешно при state == present | Плавающий IP-адрес маршрутизируется на этот сервер. Пример: 47cec963-fcd2-482f-bdb6-24461b2d47b1 |
| state строка | успешно | Текущее состояние плавающего IP-адреса. Пример: present |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантирует обратной совместимости.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробности см. в разделе Поддержка и техническое обслуживание модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Gaudenz Steinlin (@gaudenz) <gaudenz.steinlin@cloudscale.ch>
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cloudscale_floating_ip_module.html
