cs_staticnat — Управление статическими NAT на облаках Apache CloudStack.

Новое в версии 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Создание, обновление и удаление статических NAT.

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account		Учетная запись, к которой относится статический NAT.
api_http_method	Варианты: get post	Метод HTTP, используемый для запроса к API-точке входа. Если не указано, используется значение переменной среды `CLOUDSTACK_METHOD`. В качестве последнего варианта используется значение из конфигурационного файла ini, см. также раздел Примечания. Значение по умолчанию `get`, если не указано.
api_key		Ключ API CloudStack API. Если не указано, используется значение переменной среды `CLOUDSTACK_KEY`. В качестве последнего варианта используется значение из конфигурационного файла ini, см. также раздел Примечания.
api_region	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. Если не указано, используется значение переменной среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ CloudStack API. Если не задано, используется значение переменной среды `CLOUDSTACK_SECRET`. В качестве последнего варианта используется значение из конфигурационного файла ini, см. также раздел Примечания.
api_timeout		Таймаут HTTP в секундах. Если не указано, используется значение переменной среды `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта используется значение из конфигурационного файла ini, см. также раздел Примечания. Значение по умолчанию 10 секунд, если не указано.
api_url		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется значение переменной среды `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта используется значение из конфигурационного файла ini, см. также раздел Примечания.
domain		Домен, к которому относится статический NAT.
ip_address обязательно		Общедоступный IP-адрес, назначенный статическому NAT.
network (добавлено в 2.2)		Сеть, к которой относится IP-адрес.
poll_async bool	Варианты: no да ←	Проверять асинхронные задачи до завершения.
project		Имя проекта, к которому относится статический NAT.
state	Варианты: present ← absent	Состояние статического NAT.
vm		Имя виртуальной машины, для которой создаётся статический NAT. Обязательно, если `state=present`.
vm_guest_ip bool	Варианты: нет ← да	Вторичный IP-адрес гостевой ОС виртуальной машины для статического NAT.
vpc (добавлено в 2.3)		VPC, к которой относится сеть.
zone		Имя зоны, в которой находится виртуальная машина. Если не задано, используется зона по умолчанию.

Примечания

Примечание

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 можно найти в Руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

# create a static NAT: 1.2.3.4 -> web01
- local_action:
    module: cs_staticnat
    ip_address: 1.2.3.4
    vm: web01

# remove a static NAT
- local_action:
    module: cs_staticnat
    ip_address: 1.2.3.4
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
account строка	успех	Учетная запись, к которой относится статический NAT. Пример: пример учетной записи
domain строка	успех	Домен, к которому относится статический NAT. Пример: пример домена
id строка	успех	UUID ip_address. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
ip_address строка	успех	Общедоступный IP-адрес. Пример: 1.2.3.4
project строка	успех	Имя проекта, к которому относится статический NAT. Пример: Производство
vm_display_name строка	успех	Имя отображения виртуальной машины. Пример: web-01
vm_guest_ip строка	успех	IP виртуальной машины. Пример: 10.101.65.152
vm_name строка	успех	Имя виртуальной машины. Пример: web-01
zone строка	успех	Имя зоны, к которой относится статический NAT. Пример: ch-gva-2

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики данного модуля гарантируют отсутствие изменений интерфейса, несовместимых со старыми версиями.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

René Moser (@resmo)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cs_staticnat_module.html