Модуль ngine_io.cloudstack.cs_instance_nic – Управляет сетевыми интерфейсами экземпляра в облаках на основе 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.

Новое в ngine_io.cloudstack 0.1.0

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

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

Добавление и удаление сетевого интерфейса в сеть и из сети

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

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

Примечания

Примечание

Подробное руководство по модулям 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 строка	Аккаунт, к которому относится виртуальная машина. Возвращается: успех Пример: `"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"`

Авторы

Marc-Aurèle Brothier (@marcaurele)
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_module.html