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 |
| Состояние, в котором должен находиться адрес. 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 |
Примечания
Примечание
- Глобальные адреса могут использоваться только с глобальными правилами маршрутизации.
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы так захотите, пожалуйста, прочтите Информацию о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/gce_eip_module.html