aws_direct_connect_link_aggregation_group - Управление группами агрегации каналов Direct Connect.

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

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

Обзор

Создание, удаление или изменение группы агрегации каналов 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		Пропускная способность группы агрегации каналов.
connection_id		Идентификатор подключения для связи с группой агрегации каналов при создании.
delete_with_disassociation		Используется с state=absent для удаления подключений после их отсоединения от LAG.
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковая имеется.
force_delete		Это позволяет установить минимальное количество подключений в 0, отсоединить все подключенные соединения и удалить все виртуальные интерфейсы, связанные с LAG.
link_aggregation_group_id		Идентификатор группы агрегации каналов Direct Connect.
location		Расположение группы агрегации каналов.
min_links		Минимальное количество физических подключений, которые должны быть активными для работоспособности LAG.
name		Имя группы агрегации каналов Direct Connect.
num_connections		Количество подключений, с которыми необходимо инициализировать группу агрегации каналов.
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 yes ←	Если установлено значение "no", сертификаты SSL для boto версий >= 2.6.0 не будут проверены.
wait	Варианты: no yes	Дожидаться завершения операции или нет. Может быть полезно при ожидании удаления виртуальных интерфейсов. Может изменить время ожидания с помощью `wait_timeout`.
wait_timeout	Значение по умолчанию: 120	Время ожидания в секундах, если wait равно True.

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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_link_aggregation_group:
  state: present
  location: EqDC2
  lag_id: dxlag-xxxxxxxx
  bandwidth: 1Gbps

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

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

Ключ	Возвращаемое значение	Описание
aws_device строка	при state=present	Конечная точка AWS Direct Connection, которая содержит LAG. Пример: EqSe2-1bwfvazist2k0
changed строка	всегда	Изменился ли LAG.
connections список	при state=present	Список подключений, объединенных в этом LAG. Пример: {'connections': [{'aws_device': 'EqSe2-1bwfvazist2k0', 'region': 'us-west-2', 'connection_state': 'down', 'connection_name': 'Requested Connection 1 for Lag dxlag-fgtoh97h', 'owner_account': '448830907657', 'connection_id': 'dxcon-fgzjah5a', 'bandwidth': '1Gbps', 'location': 'EqSe2', 'lag_id': 'dxlag-fgnsp4rq'}]}
connections_bandwidth строка	при state=present	Индивидуальная пропускная способность физических подключений, объединенных в LAG. Пример: 1Gbps
lag_id строка	при state=present	Уникальный идентификатор группы агрегации каналов. Пример: dxlag-fgnsp4rq
lag_name строка	при state=present	Имя группы агрегации каналов, заданное пользователем.
lag_state строка	при state=present	Состояние LAG. Пример: pending
location строка	при state=present	Местоположение подключения. Пример: EqSe2
minimum_links целое число	при state=present	Минимальное количество физических подключений, которые должны быть активными для работоспособности LAG.
number_of_connections целое число	при state=present	Количество физических подключений, объединенных в LAG.
owner_account строка	при state=present	Идентификатор учетной записи владельца LAG.
region строка	при state=present	Регион, в котором существует LAG.

Статус

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

Автор

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.5/modules/aws_direct_connect_link_aggregation_group_module.html