aws_direct_connect_connection - Создаёт, удаляет, изменяет подключение Direct Connect

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

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

Описание

Создаёт, обновляет или удаляет подключение Direct Connect между сетью и конкретным расположением AWS Direct Connect. При создании подключение может быть добавлено в группу агрегирования каналов или установлено как независимое подключение. Позднее подключение может быть ассоциировано или диссоциировано с группой агрегирования каналов.

Требования

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

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	По умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key	По умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key
bandwidth	Варианты: 1Gbps 10Gbps	Пропускная способность подключения Direct Connect. Требуется, когда state=present.
connection_id		Идентификатор подключения Direct Connect. Требуется name или connection_id для пересоздания или удаления подключения. Изменение атрибутов подключения с forced_update приведёт к новому идентификатору подключения Direct Connect.
ec2_url	По умолчанию: None	URL для подключения к EC2 или облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое есть.
forced_update		Для изменения пропускной способности или расположения подключение необходимо удалить и пересоздать. По умолчанию это не происходит - этот параметр должен быть установлен в True.
link_aggregation_group		Идентификатор группы агрегирования каналов, которую вы хотите ассоциировать с подключением. Это необязательно, если требуется независимое подключение.
location		Расположение подключения Direct Connect. Требуется, когда state=present.
name		Имя подключения Direct Connect. Требуется для создания нового подключения. Для пересоздания или удаления подключения требуется name или connection_id.
profile (добавлено в 1.6)	По умолчанию: None	Использует профиль 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)	По умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state	Варианты: present absent	Состояние подключения Direct Connect.
validate_certs (добавлено в 1.5)	Варианты: no да ←	При значении "no", сертификаты 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), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используется для указания региона AWS, когда это требуется, но это также можно настроить в файле конфигурации boto

Примеры

# create a Direct Connect connection
- aws_direct_connect_connection:
    name: ansible-test-connection
    state: present
    location: EqDC2
    link_aggregation_group: dxlag-xxxxxxxx
    bandwidth: 1Gbps
  register: dc

# disassociate the LAG from the connection
- aws_direct_connect_connection:
    state: present
    connection_id: dc.connection.connection_id
    location: EqDC2
    bandwidth: 1Gbps

# replace the connection with one with more bandwidth
- aws_direct_connect_connection:
    state: present
    name: ansible-test-connection
    location: EqDC2
    bandwidth: 10Gbps
    forced_update: True

# delete the connection
- aws_direct_connect_connection:
    state: absent
    name: ansible-test-connection

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

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

Ключ		Возвращено	Описание
connection сложный		state=present	Атрибуты подключения Direct Connect
	owner_account		Владелец подключения.
	aws_device		Конечная точка, на которой заканчивается физическое подключение.
	location		Расположение подключения.
	region		Регион, в котором существует подключение.
	bandwidth		Пропускная способность подключения.
	connection_state		Состояние подключения.
	connection_id		Идентификатор подключения Direct Connect.

Статус

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

Автор

Слоун Хертель (@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.5/modules/aws_direct_connect_connection_module.html