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

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

Описание
Параметры
Примечания
Примеры
Значения возврата
Статус
- Автор

Описание

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

Примечания

Примечание

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

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Автор

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