cloudscale_floating_ip – Управляет плавающими IP-адресами на IaaS-сервисе cloudscale.ch

Новая версия с 2.5.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Создание, назначение и удаление плавающих IP-адресов на IaaS-сервисе cloudscale.ch.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout -	Значение по умолчанию: 30	Время ожидания в секундах для вызовов API cloudscale.ch.
api_token -		Токен API cloudscale.ch. Также может быть передан в переменной среды `CLOUDSCALE_API_TOKEN`.
ip строка		Адрес плавающего IP-адреса для изменения. Требуется для назначения IP-адреса другому серверу или если параметр state отсутствует. псевдонимы: network
ip_version целое число	Варианты: 4 6	Версия протокола IP плавающего IP-адреса.
prefix_length целое число	Варианты: 56	Действителен только если ip_version равен 6. Длина префикса для сети IPv6. В настоящее время можно запросить только префикс /56. Если prefix_length отсутствует, создаётся единственный адрес.
reverse_ptr строка		Запись PTR для обратного поиска этого адреса. Вы не можете установить запись PTR для плавающих сетей IPv6. Записи PTR разрешены только для отдельных адресов.
server строка		UUID сервера, которому назначен этот плавающий IP-адрес. Требуется, если state отсутствует.
state строка	Варианты: present ← absent	Состояние плавающего IP-адреса.

Примечания

Примечание

Для создания нового плавающего IP-адреса необходимо указать как минимум параметры ip_version и server.
После создания плавающего IP-адреса все параметры, кроме server, являются только для чтения.
Невозможно запросить плавающий IP-адрес без одновременной привязки его к серверу.
Для работы данного модуля требуется библиотека ipaddress для Python. Эта библиотека включена в Python начиная с версии 3.3. Для более ранних версий она доступна как модуль на PyPI.
Вместо параметра api_token можно использовать переменную среды CLOUDSCALE_API_TOKEN.
Все операции выполняются с использованием публичного API cloudscale.ch v1.
Подробную информацию см. в полной документации API: https://www.cloudscale.ch/ru/api/v1.
Для всех операций требуется действительный токен API. Вы можете создать любое количество токенов, используя панель управления cloudscale.ch по адресу https://control.cloudscale.ch.

Примеры

# 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	Обратный указатель для этого плавающего IP-адреса. Пример: 185-98-122-176.cust.cloudscale.ch
server строка	успех, когда state == present	Плавающий IP-адрес маршрутизируется на этот сервер. Пример: 47cec963-fcd2-482f-bdb6-24461b2d47b1
state строка	успех	Текущее состояние плавающего IP-адреса. Пример: present

Статус

Интерфейс этого модуля не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Gaudenz Steinlin (@gaudenz)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/cloudscale_floating_ip_module.html