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

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

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

Обзор

Создание, удаление или изменение группы агрегирования каналов 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 -		Пропускная способность группы агрегирования каналов.
connection_id -		Идентификатор подключения для связывания с группой агрегирования каналов при создании.
delete_with_disassociation -		Используется с state=absent для удаления подключений после отсоединения их от LAG.
ec2_url -		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		Использует профиль 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 boolean добавлено в 1.5	Варианты: no да ←	При значении "no" сертификаты SSL для boto версий >= 2.6.0 не будут валидироваться.
wait boolean	Варианты: 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), если учетные данные не предоставлены. См. https://boto.readthedocs.io/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 Connect, на которой размещается LAG. Пример: EqSe2-1bwfvazist2k0
changed строка	всегда	Изменился ли LAG.
connections список	при state=present	Список соединений, объединённых этим LAG. Пример: {'connections': [{'aws_device': 'EqSe2-1bwfvazist2k0', 'bandwidth': '1Gbps', 'connection_id': 'dxcon-fgzjah5a', 'connection_name': 'Запрошенное соединение 1 для LAG dxlag-fgtoh97h', 'connection_state': 'down', 'lag_id': 'dxlag-fgnsp4rq', 'location': 'EqSe2', 'owner_account': '448830907657', 'region': 'us-west-2'}]}
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.

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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