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

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

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата
Статус

Описание

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

Требования

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

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key -		Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key -		Секретный ключ 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 -		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где регион является обязательным. Должен быть указан для всех остальных модулей, если регион не используется. Если не указан, используется значение переменной среды EC2_URL, если она есть.
multi_ok -	По умолчанию: "нет"	По умолчанию модуль не создаст другую VPC, если уже есть другая VPC с тем же именем и CIDR. Укажите "true", если нужно создать дубликаты VPC.
name - / обязательно		Имя для вашей VPC. Используется совместно с `cidr_block`, чтобы определить, существует ли уже VPC.
profile - добавлен в 1.6		Использует профиль 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		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state -	Варианты: present ← absent	Состояние VPC. Либо отсутствует, либо присутствует.
tags -		Теги, которые необходимо добавить к VPC. Не зависит от имени, если вы передаете ключ 'Name', он переопределит имя VPC, если оно отличается. псевдонимы: resource_tags
tenancy -	Варианты: 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), если учетные данные не предоставлены. См. https://boto.readthedocs.io/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
	cidr_block строка		всегда	CIDR VPC Пример: 10.0.0.0/16
	cidr_block_association_set список		успех	ассоциированные IPv4 CIDR блоки с VPC Пример: {'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
	dhcp_options_id строка		всегда	идентификатор DHCP параметров, связанных с этим VPC Пример: dopt-0fb8bd6b
	id строка		всегда	идентификатор ресурса VPC Пример: vpc-c2e00da5
	instance_tenancy строка		всегда	указывает, использует ли VPC стандартную или выделенную арендацию Пример: default
	is_default булево		всегда	указывает, является ли это значение по умолчанию для VPC
	state строка		всегда	состояние VPC Пример: available
	tags сложный		всегда	метки, прикрепленные к VPC, включая имя
		Name строка	всегда	метка имени для VPC Пример: pk_vpc4

Статус

Данный модуль гарантированно не будет содержать обратной совместимости в будущем. [stableinterface]
Этот модуль поддерживается командой Ansible Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке данного модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/ec2_vpc_net_module.html