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

Примечание

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

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

Для использования в книге задач укажите: community.google.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.google.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.google.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/google/gce_eip_module.html