cs_instance_nic — Управление сетевыми адаптерами виртуальной машины в облаках на базе Apache CloudStack.

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

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

Обзор

Добавление и удаление сетевых адаптеров к сети

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

python >= 2.6
cs >= 0.6.10

Параметры

параметр	обязательный	по умолчанию	выбор	комментарии
account	нет			Аккаунт, к которому относится виртуальная машина.
api_http_method	нет	get	get post	Используемый HTTP-метод.
api_key	нет			Ключ API CloudStack API.
api_region	нет	cloudstack		Имя раздела ini в файле `cloustack.ini`.
api_secret	нет			Секретный ключ CloudStack API.
api_timeout	нет	10		Таймаут HTTP.
api_url	нет			URL CloudStack API, например, https://cloud.example.com/client/api.
domain	нет			Домен, к которому относится виртуальная машина.
ip_address	нет			IP-адрес, который нужно использовать для сетевого адаптера.
network	да			Имя сети.
poll_async	нет	True		Ожидать завершения асинхронных задач.
project	нет			Имя проекта, в котором развернута виртуальная машина.
state	нет	present	present absent	Состояние сетевого адаптера.
vm	да			Имя виртуальной машины. Синонимы: имя
vpc	нет			Имя VPC, к которому относится `vm`.
zone	нет			Имя зоны, в которой развернута виртуальная машина. Если не указано, используется зона по умолчанию.

Примеры

# Add a nic on another network
- local_action:
    module: cs_instance_nic
    vm: privnet
    network: privNetForBasicZone

# Ensure IP address on a nic
- local_action:
    module: cs_instance_nic
    vm: privnet
    ip_address: 10.10.11.32
    network: privNetForBasicZone

# Remove a secondary nic
- local_action:
    module: cs_instance_nic
    vm: privnet
    state: absent
    network: privNetForBasicZone

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

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

название	описание	возвращается	тип	пример
account	Аккаунт, к которому относится виртуальная машина.	успех	строка	пример аккаунта
domain	Домен, к которому относится виртуальная машина.	успех	строка	пример домена
id	UUID сетевого адаптера.	успех	строка	87b1e0ce-4e01-11e4-bb66-0050569e64b8
ip_address	Основной IP-адрес сетевого адаптера.	успех	строка	10.10.10.10
mac_address	MAC-адрес сетевого адаптера.	успех	строка	02:00:33:31:00:e4
netmask	Маска подсети сетевого адаптера.	успех	строка	255.255.255.0
network	Имя сети, если не по умолчанию.	успех	строка	синхронная сеть
project	Имя проекта, к которому относится виртуальная машина.	успех	строка	Производство
vm	Имя виртуальной машины.	успех	строка	web-01

Примечания

Примечание

Модуль Ansible использует метод конфигурации библиотеки cs, если учетные данные не указаны в аргументах api_url, api_key, api_secret. Конфигурация читается из нескольких мест в следующем порядке: - Файлы CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. - Переменные среды CLOUDSTACK_TIMEOUT. - Переменная среды CLOUDSTACK_CONFIG , указывающая на файл .ini. - Файл cloudstack.ini в текущей рабочей директории. - Файл .cloudstack.ini в домашней директории пользователя. Можно указать несколько учетных данных и конечных точек, используя разделы ini в cloudstack.ini. Для выбора имени раздела используйте аргумент api_region, по умолчанию используется cloudstack. Дополнительная информация находится на странице https://github.com/exoscale/cs.
Подробное руководство по модулям CloudStack можно найти по адресу http://docs.ansible.com/ansible/guide_cloudstack.html
Этот модуль поддерживает режим проверки.

Статус

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

Для получения помощи в разработке модулей, если вас это интересует, прочитайте Информацию о сообществе и участии в разработке, Тестирование 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/cs_instance_nic_module.html