ngine_io.cloudstack.cs_instance_nic_secondaryip – Управляет дополнительными IP-адресами экземпляра в облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack
Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_instance_nic_secondaryip
Новое в версии 0.1.0: of ngine_io.cloudstack
Описание
- Добавление и удаление дополнительных IP-адресов к сетевой карте экземпляра.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, выполняющем этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Аккаунт, к которому относится экземпляр. | |
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке. Если не задано, рассматривается переменная среды CLOUDSTACK_METHOD |
| api_key строка / обязательно | API-ключ CloudStack API. Если не задано, рассматривается переменная среды CLOUDSTACK_KEY | |
| api_secret строка / обязательно | Секретный ключ CloudStack API. Если не задано, рассматривается переменная среды CLOUDSTACK_SECRET | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не задано, рассматривается переменная среды CLOUDSTACK_TIMEOUT |
| api_url строка / обязательно | URL CloudStack API, например, https://cloud.example.com/client/api. Если не задано, рассматривается переменная среды CLOUDSTACK_ENDPOINT | |
| api_verify_ssl_cert строка | Проверка сертификата авторитета CA. Если не задано, рассматривается переменная среды CLOUDSTACK_VERIFY | |
| domain строка | Домен, к которому относится экземпляр. | |
| network строка | Имя сети. Требуется для поиска сетевой карты, если экземпляру назначено несколько сетей. | |
| poll_async логическое значение |
| Проверять асинхронные задачи до завершения. |
| project строка | Имя проекта, в котором развернут экземпляр. | |
| state строка |
| Состояние IP-адреса. |
| vm строка / обязательно | Имя экземпляра. псевдонимы: name | |
| vm_guest_ip строка | Дополнительный IP-адрес, который нужно добавить к сетевой карте экземпляра. Если не задано, API всегда возвращает новый IP-адрес, и идемпотентность не гарантируется. псевдонимы: secondary_ip | |
| vpc строка | Имя VPC, к которому относится vm. | |
| zone строка / обязательно | Имя зоны, в которой развернут экземпляр. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Assign a specific IP to the default NIC of the VM
ngine_io.cloudstack.cs_instance_nic_secondaryip:
vm: customer_xy
zone: zone01
vm_guest_ip: 10.10.10.10
# Note: If vm_guest_ip is not set, you will get a new IP address on every run.
- name: Assign an IP to the default NIC of the VM
ngine_io.cloudstack.cs_instance_nic_secondaryip:
vm: customer_xy
zone: zone01
- name: Remove a specific IP from the default NIC
ngine_io.cloudstack.cs_instance_nic_secondaryip:
vm: customer_xy
zone: zone01
vm_guest_ip: 10.10.10.10
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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 |
| vm_guest_ip строка | успех | Дополнительный IP-адрес сетевой карты. Пример: 10.10.10.10 |
Авторы
- 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_secondaryip_module.html
