cs_nic - Управление сетевыми адаптерами (NIC) и дополнительными IP-адресами экземпляра в облаках на основе Apache CloudStack.
Новая версия с 2.3.
- УСТАРЕВШЕ
- Описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
УСТАРЕВШЕ
Устарело в 2.4. Используйте cs_instance_nic_secondaryip вместо этого.
Описание
- Добавление и удаление дополнительных IP-адресов для сетевого адаптера (NIC).
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| account | нет | Аккаунт, к которому относится экземпляр. | ||
| api_http_method | нет | get |
| Используемый 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 | нет | Домен, к которому относится экземпляр. | ||
| network | нет | Имя сети. Требуется для поиска сетевого адаптера (NIC), если экземпляру назначено несколько сетей. | ||
| poll_async | нет | True | Следить за асинхронными заданиями до завершения. | |
| project | нет | Имя проекта, в котором развернут экземпляр. | ||
| state | нет | present |
| Состояние IP-адреса. |
| vm | да | Имя экземпляра. Псевдонимы: name | ||
| vm_guest_ip | нет | Дополнительный IP-адрес, который нужно добавить к сетевому адаптеру экземпляра. Если не указан, API всегда возвращает новый IP-адрес, и идемпотентность не гарантируется. Псевдонимы: secondary_ip | ||
| vpc | нет | Имя VPC, к которому относится vm. | ||
| zone | нет | Имя зоны, в которой развернут экземпляр. Если не указано, используется зона по умолчанию. |
Примеры
# Assign a specific IP to the default NIC of the VM
- local_action:
module: cs_nic
vm: customer_xy
vm_guest_ip: 10.10.10.10
# Assign an IP to the default NIC of the VM
# Note: If vm_guest_ip is not set, you will get a new IP address on every run.
- local_action:
module: cs_nic
vm: customer_xy
# Remove a specific IP from the default NIC
- local_action:
module: cs_nic
vm: customer_xy
vm_guest_ip: 10.10.10.10
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| account | Аккаунт, к которому относится виртуальная машина (VM). | успех | строка | пример аккаунта |
| domain | Домен, к которому относится виртуальная машина (VM). | успех | строка | пример домена |
| id | UUID сетевого адаптера (NIC). | успех | строка | 87b1e0ce-4e01-11e4-bb66-0050569e64b8 |
| ip_address | Основной IP-адрес NIC. | успех | строка | 10.10.10.10 |
| mac_address | MAC-адрес NIC. | успех | строка | 02:00:33:31:00:e4 |
| netmask | Маска сети NIC. | успех | строка | 255.255.255.0 |
| network | Имя сети, если не по умолчанию. | успех | строка | sync network |
| project | Имя проекта, к которому относится виртуальная машина (VM). | успех | строка | Производство |
| vm | Имя виртуальной машины (VM). | успех | строка | web-01 |
| vm_guest_ip | Дополнительный IP-адрес NIC. | успех | строка | 10.10.10.10 |
Примечания
Примечание
- 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_nic_module.html
