community.general.gce_eip – Создание или уничтожение глобальных или региональных внешних адресов IP.

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.gce_eip.

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

Обзор

Создание (резервирование) или уничтожение (освобождение) региональных или глобальных IP-адресов. Подробнее о резервировании статических адресов см. https://cloud.google.com/compute/docs/configure-instance-ip-addresses#reserve_new_static.

Требования

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

python >= 2.6
apache-libcloud >= 0.19.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
credentials_file путь		Путь к JSON-файлу, связанному с электронной почтой учетной записи сервиса.
name строка / обязательно		Имя адреса.
pem_file путь		Путь к PEM-файлу, связанному с электронной почтой учетной записи сервиса. Этот параметр устарел и может быть удален в будущих версиях. Используйте credentials_file вместо него.
project_id строка		Идентификатор проекта Google Cloud Platform, который нужно использовать.
region строка / обязательно		Регион для создания адреса. Установите 'global', чтобы создать глобальный адрес.
service_account_email строка		электронная почта учетной записи сервиса
service_account_permissions список / элементы=строка		разрешения учетной записи сервиса
state строка	Варианты: present ← absent	Состояние, в котором должен находиться адрес. `present` или `absent` — единственные допустимые варианты.

Примечания

Примечание

Глобальные адреса могут использоваться только с глобальными правилами перенаправления.

Примеры

- name: Create a Global external IP address
  community.general.gce_eip:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    name: my-global-ip
    region: global
    state: present

- name: Create a Regional external IP address
  community.general.gce_eip:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    name: my-global-ip
    region: us-east1
    state: present

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
address строка	всегда	IP-адрес, с которым выполняются операции Пример: 35.186.222.233
name строка	всегда	имя адреса, с которым выполняются операции Пример: my-address
region строка	всегда	Регион, к которому относится адрес. Пример: global

Авторы

Tom Melendez (@supertom) <tom@supertom.com>

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