aws_direct_connect_connection — Создаёт, удаляет, изменяет соединение Direct Connect

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

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

Обзор

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

Требования

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

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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
bandwidth	Варианты: 1 Гбит/с 10 Гбит/с	Пропускная способность соединения Direct Connect. Требуется, когда state=present.
connection_id		Идентификатор соединения Direct Connect. name или connection_id требуется для воссоздания или удаления соединения. Изменение атрибутов соединения с forced_update приведёт к новому идентификатору соединения Direct Connect.
ec2_url		URL для подключения к EC2 или вашей облачной платформе Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она существует.
forced_update bool	Варианты: нет да	Для изменения пропускной способности или расположения соединения необходимо удалить и воссоздать его. По умолчанию это не происходит — этот параметр должен быть установлен в True.
link_aggregation_group		Идентификатор группы агрегирования каналов, которую вы хотите связать с соединением. Это необязательно, если нужно создать независимое соединение.
location		Расположение соединения Direct Connect. Требуется, когда state=present.
name		Имя соединения Direct Connect. Требуется для создания нового соединения. Для воссоздания или удаления соединения требуется name или connection_id.
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 absent	Состояние соединения Direct Connect.
validate_certs bool (добавлен в 1.5)	Варианты: нет да ←	При значении "нет", сертификаты 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.
	aws_device строка	когда запрашиваемое состояние больше не 'requested'	Конечная точка физического подключения. Пример: EqDC2-12pmo7hemtz1z
	bandwidth строка	всегда	Пропускная способность соединения. Пример: 1 Гбит/с
	connection_id строка	всегда	Идентификатор соединения. Пример: dxcon-ffy9ywed
	connection_name строка	всегда	Имя соединения. Пример: ansible-test-connection
	connection_state строка	всегда	Состояние соединения. Пример: pending
	loa_issue_time строка	при выдаче LOA-CFA (состояние соединения больше не 'requested')	Время выдачи письма об авторизации - назначение подключённого оборудования. Пример: 2018-03-20T17:36:26-04:00
	location строка	всегда	Расположение соединения. Пример: EqDC2
	owner_account строка	всегда	Аккаунт, которому принадлежит соединение direct connect. Пример: 123456789012
	region строка	всегда	Регион, в котором существует соединение. Пример: us-east-1

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Поддержка и техническое обслуживание модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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