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-блок адреса клиента для создания виртуального интерфейса.
debug_botocore_endpoint_logs логический тип добавлено в 2.8	Варианты: нет ← да	Используйте регистрирующую службу botocore.endpoint для анализа уникальных (а не суммарных) API-вызовов "ресурс:действие", сделанных во время задачи, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода полного списка, созданного во время выполнения playbook. Переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS также может быть использована.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если не используется регион. Если не задан, используется значение переменной среды EC2_URL, если она есть.
id_to_associate -		Идентификатор группы агрегирования каналов или подключения для ассоциации с виртуальным интерфейсом. Псевдонимы: link_aggregation_group_id, connection_id
name -		Имя виртуального интерфейса.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0.
public логический тип	Варианты: нет да	Тип виртуального интерфейса.
region строка		AWS-регион для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region Псевдонимы: aws_region, ec2_region
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
state -	Варианты: present absent	Желаемое состояние виртуального интерфейса Direct Connect.
validate_certs логический тип	Варианты: нет да ←	Если установлено в "нет", сертификаты 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) для конфигурации Border Gateway Protocol (BGP). Пример: 65000
auth_key строка		всегда	Ключ аутентификации для конфигурации BGP. Пример: 0xZ59Y1JZ2oDOSh6YriIlyRE
bgp_peers сложное		всегда	Список BGP-пиров, настроенных на этом виртуальном интерфейсе.
	address_family строка	всегда	Семейство адресов для BGP-пира. Пример: ipv4
	amazon_address строка	всегда	IP-адрес, назначенный интерфейсу Amazon. Пример: 169.254.255.1/30
	asn целое число	всегда	Номер автономной системы (AS) для конфигурации Border Gateway Protocol (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. [community]

Авторы

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