ngine_io.cloudstack.cs_instance_nic – Управляет сетевыми адаптерами виртуальной машины на облаках, основанных на Apache CloudStack.
Примечание
Этот плагин входит в состав коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в книге задач укажите: ngine_io.cloudstack.cs_instance_nic.
В версии 0.1.0: плагина ngine_io.cloudstack
Обзор
- Добавление и удаление сетевых адаптеров к сети и из сети
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Аккаунт, к которому относится виртуальная машина. | |
| api_http_method строка |
| HTTP-метод, используемый для запроса конечной точки API. Если не указано, рассматривается переменная среды CLOUDSTACK_METHOD. |
| api_key строка / обязательно | Ключ API API CloudStack. Если не указано, рассматривается переменная среды CLOUDSTACK_KEY. | |
| api_secret строка / обязательно | Секретный ключ API CloudStack. Если не задано, рассматривается переменная среды CLOUDSTACK_SECRET. | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не указано, рассматривается переменная среды CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательно | URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, рассматривается переменная среды CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверка файла сертификата CA. Если не указано, рассматривается переменная среды CLOUDSTACK_VERIFY. | |
| domain строка | Домен, к которому относится виртуальная машина. | |
| ip_address строка | IP-адрес, который нужно использовать для сетевого адаптера. | |
| network строка / обязательно | Имя сети. | |
| poll_async логическое |
| Проверять асинхронные задачи, пока задача не завершится. |
| project строка | Имя проекта, в котором развернута виртуальная машина. | |
| state строка |
| Состояние сетевого адаптера. |
| vm строка / обязательно | Имя виртуальной машины. псевдонимы: имя | |
| vpc строка | Имя VPC, к которому относится vm. | |
| zone строка / обязательно | Имя зоны, в которой развернута виртуальная машина. |
Примечания
Примечание
- Подробное руководство по модулям Cloudstack можно найти в руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Add a nic on another network
ngine_io.cloudstack.cs_instance_nic:
vm: privnet
network: privNetForBasicZone
zone: zone01
- name: Ensure IP address on a nic
ngine_io.cloudstack.cs_instance_nic:
vm: privnet
ip_address: 10.10.11.32
network: privNetForBasicZone
zone: zone01
- name: Remove a secondary nic
ngine_io.cloudstack.cs_instance_nic:
vm: privnet
state: absent
network: privNetForBasicZone
zone: zone01
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| account строка | success | Аккаунт, к которому относится виртуальная машина. Пример: example account |
| domain строка | success | Домен, к которому относится виртуальная машина. Пример: example domain |
| id строка | success | UUID сетевого адаптера. Пример: 87b1e0ce-4e01-11e4-bb66-0050569e64b8 |
| ip_address строка | success | Основной IP-адрес сетевого адаптера. Пример: 10.10.10.10 |
| mac_address строка | success | MAC-адрес сетевого адаптера. Пример: 02:00:33:31:00:e4 |
| netmask строка | success | Маска сети сетевого адаптера. Пример: 255.255.255.0 |
| network строка | success | Имя сети, если это не сеть по умолчанию. Пример: sync network |
| project строка | success | Имя проекта, к которому относится виртуальная машина. Пример: Производство |
| vm строка | success | Имя виртуальной машины. Пример: web-01 |
Авторы
- Marc-Aurèle Brothier (@marcaurele)
- René Moser (@resmo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_instance_nic_module.html
