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

Примечание

Этот плагин входит в коллекцию community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws.

Чтобы использовать его в playbook, укажите: community.aws.aws_direct_connect_virtual_interface.

Введено в версии 1.0.0: из community.aws

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

Обзор

Создание, удаление или изменение публичного или частного виртуального интерфейса 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. Если задан параметр profile, этот параметр игнорируется. Одновременное указание параметров aws_access_key и profile устарело и будет исключено после 2022-06-01. Псевдонимы: ec2_access_key, access_key
aws_ca_bundle путь		Расположение файла с набором сертификатов CA для проверки SSL-сертификатов. Используется только для модулей на основе boto3. Примечание: Набор CA считывается на стороне модуля и может потребоваться явное копирование с контроллера, если модуль не выполняется локально.
aws_config словарь		Словарь для изменения конфигурации botocore. Параметры можно найти на странице https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config. Для модулей boto используется только ключ 'user_agent'. Подробную информацию о конфигурации boto см. на странице http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto.
aws_secret_key строка		Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Если задан параметр profile, этот параметр игнорируется. Одновременное указание параметров aws_secret_key и profile устарело и будет исключено после 2022-06-01. Псевдонимы: ec2_secret_key, secret_key
bgp_asn целое число	По умолчанию: 65000	Номер автономной системы (AS) для конфигурации Border Gateway Protocol (BGP).
cidr список / элементы=строка		Список префиксов CIDR фильтров маршрутизации для создания публичного виртуального интерфейса.
customer_address строка		CIDR-адрес клиента для создания виртуального интерфейса.
debug_botocore_endpoint_logs булево	Варианты: нет ← да	Использование логгера botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие» во время задачи, выводящий набор в ключ task results.resource_actions. Используйте обратный вызов aws_resource_action для вывода общего списка, созданного во время выполнения playbook. Также может быть использована переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
direct_connect_gateway_id строка		ID шлюза Direct Connect для создания частного виртуального интерфейса. Для создания частного виртуального интерфейса требуется virtual_gateway_id или direct_connect_gateway_id. Эти параметры взаимоисключающие.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковая есть. Псевдонимы: aws_endpoint_url, endpoint_url
id_to_associate строка / обязательно		ID группы агрегации каналов или подключения для ассоциации с виртуальным интерфейсом. Псевдонимы: link_aggregation_group_id, connection_id
name строка		Имя виртуального интерфейса.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0. Использование profile переопределяет aws_access_key, aws_secret_key и security_token, а поддержка их одновременного указания с profile устарела. aws_access_key, aws_secret_key и security_token будут взаимоисключающими с profile после 2022-06-01. Псевдонимы: aws_profile
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. Если задан параметр profile, этот параметр игнорируется. Одновременное указание параметров security_token и profile устарело и будет исключено после 2022-06-01. Псевдонимы: aws_security_token, access_token
state строка / обязательно	Варианты: present absent	Желаемое состояние виртуального интерфейса Direct Connect.
validate_certs булево	Варианты: нет да ←	Если установлено «нет», SSL-сертификаты для boto-версий >= 2.6.0 не будут проверены.
virtual_gateway_id строка		ID виртуального шлюза, необходимый для создания частного виртуального интерфейса. Для создания частного виртуального интерфейса требуется virtual_gateway_id или direct_connect_gateway_id. Эти параметры взаимоисключающие.
virtual_interface_id строка		ID виртуального интерфейса.
vlan целое число	По умолчанию: 100	ID VLAN.

Примечания

Примечание

Если параметры не заданы в модуле, могут быть использованы следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_PROFILE или AWS_DEFAULT_PROFILE, 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, AWS_CA_BUNDLE
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
  community.aws.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
  community.aws.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 строка		всегда	Информация для генерации конфигурации маршрутизатора клиента.
direct_connect_gateway_id строка		при public=False	Идентификатор шлюза Direct Connect. Это относится только к частным виртуальным интерфейсам. Пример: f7593767-eded-44e8-926d-a2234175835d
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

Авторы

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.10/collections/community/aws/aws_direct_connect_virtual_interface_module.html