ec2_vpc_net — Настройка виртуальных частных облаков AWS

Новая версия с 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Обзор

Создание, изменение и завершение работы виртуальных частных облаков AWS.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	Значение по умолчанию: None	Ключ доступа к AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key
aws_secret_key	Значение по умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key
cidr_block обязательно		Основной CIDR VPC. После версии 2.5 можно указать список CIDR. Первый в списке будет использован как основной CIDR и используется совместно с `name`, чтобы обеспечить идемпотентность.
dhcp_opts_id		Идентификатор DHCP-опций для использования в этой VPC.
dns_hostnames	Варианты: да ← нет	Включить поддержку имен хостов AWS.
dns_support	Варианты: да ← нет	Включить поддержку DNS AWS.
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая есть.
multi_ok	Значение по умолчанию: нет	По умолчанию модуль не создаст другую VPC, если уже есть другая VPC с таким же именем и CIDR-блоком. Установите в значение «true», если хотите создать дублирующие VPC.
name обязательно		Имя для вашей VPC. Используется в сочетании с `cidr_block`, чтобы определить, существует ли VPC.
profile (добавлен в 1.6)	Значение по умолчанию: None	Использует профиль boto. Работает только с boto >= 2.24.0.
purge_cidrs (добавлен в 2.5)	Варианты: да нет ←	Удалить CIDR, связанные с VPC и не указанные в `cidr_block`.
region		Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковая есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region Псевдонимы: aws_region, ec2_region
security_token (добавлен в 1.6)	Значение по умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
state	Варианты: present ← absent	Состояние VPC. Либо absent, либо present.
tags		Метки, которые нужно прикрепить к VPC. Не зависит от имени, при указании ключа «Name», он перезапишет имя VPC, если оно отличается. Псевдонимы: resource_tags
tenancy	Варианты: default ← dedicated	Тип аренды: default или dedicated. Не может быть изменён после создания VPC.
validate_certs (добавлен в 1.5)	Варианты: нет да ←	При значении «нет», сертификаты SSL не будут проверены для boto-версий >= 2.6.0.

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует файл конфигурации boto (обычно ~/.boto), если данные учетных данных не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION можно использовать для указания региона AWS, когда это необходимо, но это также можно настроить в файле конфигурации boto.

Примеры

# Note: These examples do not set authentication details, see the AWS Guide for details.

- name: create a VPC with dedicated tenancy and a couple of tags
  ec2_vpc_net:
    name: Module_dev2
    cidr_block: 10.10.0.0/16
    region: us-east-1
    tags:
      module: ec2_vpc_net
      this: works
    tenancy: dedicated

Возвращаемые значения

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ			Возвращаемое значение	Описание
vpc сложный			всегда	информация о созданной или удаленной VPC
	instance_tenancy строка		всегда	указывает, использует ли VPC стандартную или выделенную арендацию Пример: default
	cidr_block_association_set список		успех	ассоциированные с VPC IPv4 CIDR-блоки Пример: {'cidr_block_association_set': [{'association_id': 'vpc-cidr-assoc-97aeeefd', 'cidr_block': '20.0.0.0/24', 'cidr_block_state': {'state': 'associated'}}]}
	classic_link_enabled NoneType		всегда	указывает, включен ли ClassicLink
	tags сложный		всегда	прикрепленные к VPC метки, включая имя
		Name строка	всегда	метка имени для VPC Пример: pk_vpc4
	id строка		всегда	идентификатор ресурса VPC Пример: vpc-c2e00da5
	is_default bool		всегда	указывает, является ли это стандартной VPC
	state строка		всегда	состояние VPC Пример: available
	cidr_block строка		всегда	CIDR VPC Пример: 10.0.0.0/16
	dhcp_options_id строка		всегда	идентификатор DHCP-параметров, связанных с этой VPC Пример: dopt-0fb8bd6b

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет внесено обратной несовместимости в интерфейсе.

Поддержка

Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний

Автор

Jonathan Davila (@defionscode)
Sloane Hertel (@s-hertel)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/ec2_vpc_net_module.html