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-адрес без одновременного его назначения серверу.
Для этого модуля требуется библиотека python ipaddress. Эта библиотека включена в Python с версии 3.3. Она доступна как модуль в PyPI для более ранних версий.
Вместо параметра api_token можно использовать переменную окружения CLOUDSCALE_API_TOKEN.
Все операции выполняются с помощью общедоступного API cloudscale.ch v1.
Для получения подробной информации обратитесь к полной документации API: https://www.cloudscale.ch/en/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. [сообщество]

Авторы

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