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

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

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

Обзор

Создание, назначение и удаление плавающих IP-адресов на облачной платформе cloudscale.ch IaaS.
Все операции выполняются с использованием публичного API cloudscale.ch v1.
Для получения подробной информации обратитесь к полной документации 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 отсутствует. псевдонимы: сеть
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-адреса.

Примечания

Примечание

Вместо параметра 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

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом 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.7/modules/cloudscale_floating_ip_module.html