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