Модуль community.general.oneandone_public_ip — Настройка общедоступных IP-адресов 1&1

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Чтобы использовать его в плейбуке, укажите: community.general.oneandone_public_ip.

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

Описание

Создание, обновление и удаление общедоступных IP-адресов. Этот модуль зависит от 1and1 >= 1.0.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

1and1

Параметры

Параметр	Комментарии
api_url строка	Пользовательский URL-адрес API. Переопределяет переменную среды ONEANDONE_API_URL.
auth_token строка	Токен аутентификации API, предоставленный 1&1.
datacenter строка	ID дата-центра, в котором будет создан IP-адрес (только для неназначенных IP-адресов). Варианты: `"US"` ← (по умолчанию) `"ES"` `"DE"` `"GB"`
public_ip_id строка	Идентификатор общедоступного IP-адреса, используемый для состояний обновления и удаления.
reverse_dns строка	Имя обратного DNS. maxLength=256
state строка	Определяет состояние общедоступного IP-адреса для создания, удаления или обновления. Варианты: `"present"` ← (по умолчанию) `"absent"` `"update"`
type строка	Тип IP-адреса. В настоящее время доступен только IPV4. Варианты: `"IPV4"` ← (по умолчанию) `"IPV6"`
wait логическое	Ожидать, пока экземпляр перейдет в состояние «запущен» перед возвратом. Варианты: `false` `true` ← (по умолчанию)
wait_interval целое число	Определяет количество секунд ожидания при использовании методов _wait_for. По умолчанию: `5`
wait_timeout целое число	Сколько времени ждать, прежде чем ожидание завершится, в секундах. По умолчанию: `600`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменённого состояния без изменения целевого объекта.
diff_mode	Поддержка: отсутствует	Возвращает подробности о том, что изменилось (или, возможно, должно быть изменено в `check_mode`), когда включен режим сравнения.

Примеры

- name: Create a public IP
  community.general.oneandone_public_ip:
    auth_token: oneandone_private_api_key
    reverse_dns: example.com
    datacenter: US
    type: IPV4

- name: Update a public IP
  community.general.oneandone_public_ip:
    auth_token: oneandone_private_api_key
    public_ip_id: public ip id
    reverse_dns: secondexample.com
    state: update

- name: Delete a public IP
  community.general.oneandone_public_ip:
    auth_token: oneandone_private_api_key
    public_ip_id: public ip id
    state: absent

Значения возврата

Общие значения возврата документированы здесь, следующие — это поля, уникальные для данного модуля:

Ключ	Описание
public_ip словарь	Информация о публичном IP-адресе, который был обработан Возвращается: всегда Пример: `{"id": "F77CC589EBC120905B4F4719217BFF6D", "ip": "10.5.132.106"}`

Авторы

Amel Ajdinovic (@aajdinov)
Ethan Devenport (@edevenport)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/oneandone_public_ip_module.html