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

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: ngine_io.cloudstack.cs_instance_nic_secondaryip.

Новая версия в ngine_io.cloudstack 0.1.0

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

Описание

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

Требования

Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.

python >= 2.6
cs >= 0.9.0

Параметры

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

Авторы

René Moser (@resmo)

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

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