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

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

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус
- Информация о техническом обслуживании

Обзор

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

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
boto

Параметры

параметр	обязательно	по умолчанию	возможные значения	комментарии
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
dhcp_opts_id	нет			Идентификатор DHCP-параметров для использования в этой VPC
dns_hostnames	нет	True	да нет	Включить поддержку имен хостов AWS.
dns_support	нет	True	да нет	Включить поддержку 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.
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	present absent	Состояние VPC. Либо absent, либо present.
tags	нет	None		Теги, которые нужно добавить к VPC. Независимо от значения имени, если вы передадите ключ 'Name', он переопределит имя VPC, если оно отличается. псевдонимы: resource_tags
tenancy	нет	default	default dedicated	Тип аренды (default или dedicated). Не может быть изменен после создания VPC.
validate_certs (добавлено в 1.5)	нет	yes	yes no	Если установлено в "no", сертификаты SSL для boto версий >= 2.6.0 не будут проверены.

Примеры

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

# Create a VPC with dedicate 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.cidr_block	CIDR-блок VPC	успех	строка	10.0.0.0/16
vpc.classic_link_enabled	Указывает, включен ли ClassicLink	успех	логическое	False
vpc.dhcp_options_id	Идентификатор DHCP-опций, связанных с этой VPC	успех	строка	dopt-67236184
vpc.id	Идентификатор ресурса VPC	успех	строка	vpc-b883b2c4
vpc.instance_tenancy	Указывает, использует ли VPC арендованную или выделенную аренд	успех	строка	default
vpc.is_default	Указывает, является ли это стандартной VPC	успех	логическое	False
vpc.state	Состояние VPC	успех	строка	available
vpc.tags	Теги, прикрепленные к VPC, включая имя	успех	словарь	{'Name': 'Моя VPC', 'env': 'staging'}

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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

Статус

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

Информация о техническом обслуживании

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этом knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь с Информацией о сообществе и участии, Тестирование 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/ec2_vpc_net_module.html