ec2_vpc_vgw - Создание и удаление виртуальных шлюзов AWS VPN.
Новая версия с 2.2.
Описание
- Создаёт виртуальные шлюзы AWS VPN.
- Удаляет виртуальные шлюзы AWS VPN.
- Подключает виртуальные шлюзы к VPC.
- Отключает виртуальные шлюзы от VPC.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- boto3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| asn (добавлено в 2.6) | BGP ASN со стороны Amazon. | |
| name | Имя создаваемого или удаляемого ВШ. | |
| region | Регион AWS. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| state |
| present — гарантирует создание ресурса. absent — удаляет ресурс. |
| tags | Словарь тегов ресурса. Псевдонимы: resource_tags | |
| type |
| Тип виртуального шлюза для создания. |
| vpc_id | ID VPC для подключения или отключения. | |
| vpn_gateway_id | ID виртуального шлюза существующего ВШ. | |
| wait_timeout | По умолчанию: 320 | Количество секунд ожидания статуса во время подключения и отключения VPC. |
Примеры
- name: Create a new vgw attached to a specific VPC
ec2_vpc_vgw:
state: present
region: ap-southeast-2
profile: personal
vpc_id: vpc-12345678
name: personal-testing
type: ipsec.1
register: created_vgw
- name: Create a new unattached vgw
ec2_vpc_vgw:
state: present
region: ap-southeast-2
profile: personal
name: personal-testing
type: ipsec.1
tags:
environment: production
owner: ABC
register: created_vgw
- name: Remove a new vgw using the name
ec2_vpc_vgw:
state: absent
region: ap-southeast-2
profile: personal
name: personal-testing
type: ipsec.1
register: deleted_vgw
- name: Remove a new vgw using the vpn_gateway_id
ec2_vpc_vgw:
state: absent
region: ap-southeast-2
profile: personal
vpn_gateway_id: vgw-3a9aa123
register: deleted_vgw
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result словарь | успех | Результат операции создания или удаления. |
Статус
Этот модуль помечен как stableinterface, что означает, что поддерживающие его специалисты гарантируют, что не будет внесено обратной совместимости с интерфейсом.
Техническое обслуживание
Этот модуль помечен как сертифицированный, что означает, что он поддерживается партнёром Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых партнёром Ansible, см. здесь.
Автор
- Ник Асланидис (@naslanidis)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/ec2_vpc_vgw_module.html