gce_eip – Создание или уничтожение глобальных или региональных внешних IP-адресов.
Новая версия 2.3.
Описание
- Создание (резервирование) или Уничтожение (освобождение) региональных или глобальных IP-адресов. Подробнее о резервировании статических адресов см. https://cloud.google.com/compute/docs/configure-instance-ip-addresses#reserve_new_static.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- apache-libcloud >= 0.19.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name
- /
обязательно
|
Имя адреса.
|
|
| region
- /
обязательно
|
Регион для создания адреса. Установите 'global', чтобы создать глобальный адрес.
|
|
| state
-
|
|
Состояние, в котором должен находиться адрес.
present или absent — единственно допустимые варианты. |
Примечания
Примечание
- Глобальные адреса могут использоваться только с глобальными правилами маршрутизации.
Примеры
# Create a Global external IP address
- gce_eip:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
name: my-global-ip
region: global
state: present
# Create a Regional external IP address
- 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
|
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/gce_eip_module.html
