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. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом 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.6/modules/gce_eip_module.html
