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 -		Идентификатор соединения для связи с группой агрегирования каналов при создании.
debug_botocore_endpoint_logs логический тип добавлено в 2.8	Варианты: нет ← да	Используйте логирование botocore.endpoint для анализа уникальных (а не общих) API-вызовов "resource:action" во время задачи, выводия множество в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода в полный список, созданный во время выполнения книги задач.
delete_with_disassociation логический тип	Варианты: нет да	Используется с state=absent для удаления подключений после их разъединения с группой агрегирования каналов.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое имеется.
force_delete логический тип	Варианты: нет да	Это позволяет установить минимальное количество связей в 0, разъединить все подключённые соединения и удалить все виртуальные интерфейсы, связанные с группой агрегирования каналов.
link_aggregation_group_id -		Идентификатор группы агрегирования каналов Direct Connect.
location -		Расположение группы агрегирования каналов.
min_links -		Минимальное количество физических подключений, которые должны быть активны для работы самой группы агрегирования каналов.
name -		Имя группы агрегирования каналов Direct Connect.
num_connections -		Количество подключений для инициализации группы агрегирования каналов.
profile строка		Использует профиль 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 строка		AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state -	Варианты: present absent	Состояние группы агрегирования каналов Direct Connect.
validate_certs логический тип	Варианты: нет да ←	Если установлено в "нет", сертификаты SSL не будут проверены для boto версий >= 2.6.0.
wait логический тип	Варианты: нет да	Ожидать ли завершения операции. Может быть полезно при ожидании удаления виртуальных интерфейсов. Может изменять время ожидания с `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 Connection, на которой размещается 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.9/modules/aws_direct_connect_link_aggregation_group_module.html