Модуль ngine_io.cloudstack.instance_nic_secondaryip — управление дополнительными IP-адресами экземпляра в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.instance_nic_secondaryip.

Добавлено в ngine_io.cloudstack 0.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Добавление и удаление дополнительных IP-адресов сетевого интерфейса экземпляра.

Псевдонимы: cs_instance_nic_secondaryip

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Описание
account string	Учетная запись, с которой связан экземпляр.
api_http_method string	Метод HTTP для обращения к конечной точке API. Если значение не задано, используется переменная среды `CLOUDSTACK_METHOD`. Допустимые значения: `"get"` ← (по умолчанию) `"post"`
api_key string / обязательный	Ключ API CloudStack. Если значение не задано, используется переменная среды `CLOUDSTACK_KEY`.
api_secret string / обязательный	Секретный ключ API CloudStack. Если значение не задано, используется переменная среды `CLOUDSTACK_SECRET`.
api_timeout integer	Тайм-аут HTTP в секундах. Если значение не задано, используется переменная среды `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url string / обязательный	URL API CloudStack, например https://cloud.example.com/client/api. Если значение не задано, используется переменная среды `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert string	Проверять файл сертификата центра сертификации. Если значение не задано, используется переменная среды `CLOUDSTACK_VERIFY`.
domain string	Домен, с которым связан экземпляр.
network string	Название сети. Требуется для поиска сетевого интерфейса, если экземпляру назначено несколько сетей.
poll_async boolean	Ожидать завершения асинхронных заданий, опрашивая их состояние. Допустимые значения: `false` `true` ← (по умолчанию)
project string	Название проекта, в котором развернут экземпляр.
state string	Состояние IP-адреса. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если задано `false`, SSL-сертификаты не будут проверяться. Если значение не задано, используется переменная среды `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Используйте этот параметр только на сайтах под вашим личным контролем, где применяются самоподписанные сертификаты. Допустимые значения: `false` `true` ← (по умолчанию)
vm псевдонимы: name string / обязательный	Имя экземпляра.
vm_guest_ip псевдонимы: secondary_ip string	Дополнительный IP-адрес, который нужно добавить сетевому интерфейсу экземпляра. Если значение не задано, API всегда возвращает новый IP-адрес, поэтому идемпотентность не гарантируется.
vpc string	Название VPC, с которой связан vm.
zone string / обязательный	Название зоны, в которой развернут экземпляр.

Примечания

Примечание

Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Assign a specific IP to the default NIC of the VM
  ngine_io.cloudstack.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.instance_nic_secondaryip:
    vm: customer_xy
    zone: zone01

- name: Remove a specific IP from the default NIC
  ngine_io.cloudstack.instance_nic_secondaryip:
    vm: customer_xy
    zone: zone01
    vm_guest_ip: 10.10.10.10
    state: absent

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

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

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

Авторы

René Moser (@resmo)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/instance_nic_secondaryip_module.html