aws_direct_connect_virtual_interface – Управление виртуальными интерфейсами Direct Connect.

Новое в версии 2.5.

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

Обзор

Создание, удаление или изменение публичного или частного виртуального интерфейса Direct Connect.

Требования

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

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address_type -		Тип IP-адреса для BGP-пира.
amazon_address -		CIDR-адрес Amazon, с которым нужно создать виртуальный интерфейс.
authentication_key -		Ключ аутентификации для конфигурации BGP.
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
bgp_asn -	По умолчанию: 65000	Номер автономной системы (AS) для конфигурации Border Gateway Protocol (BGP).
cidr -		Список CIDR префиксов фильтра маршрута, с которым нужно создать публичный виртуальный интерфейс.
customer_address -		CIDR-адрес клиента, с которым нужно создать виртуальный интерфейс.
ec2_url -		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL.
id_to_associate -		Идентификатор группы агрегации каналов или соединения, с которым нужно связать виртуальный интерфейс. Псевдонимы: link_aggregation_group_id, connection_id
name -		Имя виртуального интерфейса.
profile - добавлено в 1.6		Использует профиль boto. Работает только с boto >= 2.24.0.
public boolean	Варианты: нет да	Тип виртуального интерфейса.
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	Желаемое состояние виртуального интерфейса Direct Connect.
validate_certs boolean добавлено в 1.5	Варианты: нет да ←	Если установлено «нет», сертификаты SSL для boto версий >= 2.6.0 не будут проверяться.
virtual_gateway_id -		Идентификатор виртуального шлюза, необходимый для создания частного виртуального интерфейса.
virtual_interface_id -		Идентификатор виртуального интерфейса.
vlan -	По умолчанию: 100	Идентификатор VLAN.

Примечания

Примечание

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

Примеры

---
- name: create an association between a LAG and connection
  aws_direct_connect_virtual_interface:
    state: present
    name: "{{ name }}"
    link_aggregation_group_id: LAG-XXXXXXXX
    connection_id: dxcon-XXXXXXXX

- name: remove an association between a connection and virtual interface
  aws_direct_connect_virtual_interface:
    state: absent
    connection_id: dxcon-XXXXXXXX
    virtual_interface_id: dxv-XXXXXXXX

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

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

Ключ		Возвращаемое значение	Описание
address_family строка		всегда	Семейство адресов для BGP-пира. Пример: ipv4
amazon_address строка		всегда	IP-адрес, назначенный интерфейсу Amazon. Пример: 169.254.255.1/30
asn целое число		всегда	Номер автономной системы (AS) для конфигурации протокола BGP. Пример: 65000
auth_key строка		всегда	Ключ аутентификации для конфигурации BGP. Пример: 0xZ59Y1JZ2oDOSh6YriIlyRE
bgp_peers сложный тип		всегда	Список BGP-пиров, настроенных на этом виртуальном интерфейсе.
	address_family строка	всегда	Семейство адресов для BGP-пира. Пример: ipv4
	amazon_address строка	всегда	IP-адрес, назначенный интерфейсу Amazon. Пример: 169.254.255.1/30
	asn целое число	всегда	Номер автономной системы (AS) для конфигурации протокола BGP. Пример: 65000
	auth_key строка	всегда	Ключ аутентификации для конфигурации BGP. Пример: 0xZ59Y1JZ2oDOSh6YriIlyRE
	bgp_peer_state строка	всегда	Состояние BGP-пира (верификация, ожидание, доступно) Пример: доступно
	bgp_status строка	всегда	Состояние BGP-пира (включен/выключен). Пример: включен
	customer_address строка	всегда	IP-адрес, назначенный интерфейсу клиента. Пример: 169.254.255.2/30
changed булево значение		всегда	Указывает, был ли виртуальный интерфейс создан/изменен/удален
connection_id строка		всегда	Идентификатор соединения. Это поле также используется в качестве типа идентификатора для операций, использующих несколько типов соединений (LAG, соединение, и/или соединение). Пример: dxcon-fgb175av
customer_address строка		всегда	IP-адрес, назначенный интерфейсу клиента. Пример: 169.254.255.2/30
customer_router_config строка		всегда	Информация для генерации конфигурации маршрутизатора клиента.
location строка		всегда	Расположение соединения. Пример: EqDC2
owner_account строка		всегда	AWS-аккаунт, который будет владельцем нового виртуального интерфейса. Пример: 123456789012
route_filter_prefixes сложный тип		всегда	Список маршрутов, которые будут рекламироваться сети AWS в данном регионе (публичный виртуальный интерфейс).
	cidr строка	всегда	Маршруты, которые будут рекламироваться сети AWS в данном регионе. Пример: 54.227.92.216/30
virtual_gateway_id строка		при public=False	Идентификатор виртуального частного шлюза в VPC. Применимо только к приватным виртуальным интерфейсам. Пример: vgw-f3ce259a
virtual_interface_id строка		всегда	Идентификатор виртуального интерфейса. Пример: dxvif-fh0w7cex
virtual_interface_name строка		всегда	Имя виртуального интерфейса, заданное клиентом. Пример: test_virtual_interface
virtual_interface_state строка		всегда	Состояние виртуального интерфейса (подтверждение, проверка, ожидание, доступно, выключен, отклонено). Пример: доступно
virtual_interface_type строка		всегда	Тип виртуального интерфейса (приватный, публичный). Пример: приватный
vlan целое число		всегда	Идентификатор VLAN. Пример: 100

Статус

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

Авторы

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/aws_direct_connect_virtual_interface_module.html