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

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

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
- Статус

Обзор

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

Требования (к хосту, на котором выполняется модуль)

boto3
botocore

Параметры

параметр	обязательный	значения	комментарии
bandwidth	нет	1Gbps 10Gbps	Пропускная способность соединения Direct Connect. Требуется, когда state=present.
connection_id	нет		ID соединения Direct Connect. name или connection_id требуется для воссоздания или удаления соединения. Изменение атрибутов соединения с force_update приведёт к новому ID соединения Direct Connect.
force_update	нет		Для изменения пропускной способности или расположения необходимо удалить и воссоздать соединение. По умолчанию этого не происходит — этот параметр должен быть установлен в True.
link_aggregation_group	нет		ID группы агрегирования каналов, которую нужно ассоциировать с соединением. Это необязательно, если требуется отдельное соединение.
location	нет		Расположение соединения Direct Connect. Требуется, когда state=present.
name	нет		Имя соединения Direct Connect. Требуется для создания нового соединения. Для воссоздания или удаления соединения требуется name или connection_id.
state	нет	present absent	Состояние соединения Direct Connect.

Примеры

# 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
  force_update: True

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

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

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

имя

описание

возвращается

тип

пример

connection

Атрибуты соединения Direct Connect

I(state=present)

сложный

содержит:

имя	описание	возвращается	тип	пример
owner_account	Владелец соединения.
aws_device	Точка подключения, на которой физически завершается соединение.
location	Расположение соединения.
region	Регион, в котором существует соединение.
bandwidth	Пропускная способность соединения.
connection_state	Состояние соединения.
connection_id	ID соединения Direct Connect.

Статус

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

Для получения помощи в разработке модулей, если вы так захотите, обратитесь к Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/aws_direct_connect_connection_module.html