Spec-Zone.ru › Ansible 2.4

cs_pod — Управление подсетями в облаках на базе Apache CloudStack.

Новая версия с 2.1.

  • Обзор
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус

Обзор

  • Создание, обновление, удаление подсетей.

Требования (к хосту, на котором выполняется модуль)

  • python >= 2.6
  • cs >= 0.6.10

Параметры

параметр обязательно по умолчанию значения комментарии
api_http_method
нет get
  • get
  • post
Используемый HTTP-метод.
api_key
нет
Ключ API CloudStack API.
api_region
нет cloudstack
Имя раздела ini в файле cloustack.ini.
api_secret
нет
Секретный ключ CloudStack API.
api_timeout
нет 10
Таймаут HTTP.
api_url
нет
URL CloudStack API, например, https://cloud.example.com/client/api.
end_ip
нет
Конечный IP-адрес для подсети.
gateway
нет
Шлюз для подсети.
Требуется в state=present.
id
нет
uuid существующей подсети.
name
да
Имя подсети.
netmask
нет
Маска подсети.
Требуется в state=present.
start_ip
нет
Начальный IP-адрес подсети.
Требуется в state=present.
state
нет present
  • present
  • enabled
  • disabled
  • absent
Состояние подсети.
zone
нет
Имя зоны, к которой принадлежит подсеть.
Если не задано, используется зона по умолчанию.

Примеры

# Ensure a pod is present
- local_action:
    module: cs_pod
    name: pod1
    zone: ch-zrh-ix-01
    start_ip: 10.100.10.101
    gateway: 10.100.10.1
    netmask: 255.255.255.0

# Ensure a pod is disabled
- local_action:
    module: cs_pod
    name: pod1
    zone: ch-zrh-ix-01
    state: disabled

# Ensure a pod is enabled
- local_action:
    module: cs_pod
    name: pod1
    zone: ch-zrh-ix-01
    state: enabled

# Ensure a pod is absent
- local_action:
    module: cs_pod
    name: pod1
    zone: ch-zrh-ix-01
    state: absent

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

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

имя описание возвращается тип пример
allocation_state
Состояние подсети.
успех строка Enabled
end_ip
Конечный IP-адрес подсети.
успех строка 10.100.1.254
gateway
Шлюз подсети.
успех строка 10.100.1.1
id
UUID подсети.
успех строка 04589590-ac63-4ffc-93f5-b698b8ac38b6
name
Имя подсети.
успех строка pod01
netmask
Маска подсети.
успех строка 255.255.255.0
start_ip
Начальный IP-адрес подсети.
успех строка 10.100.1.101
zone
Имя зоны, в которой находится подсеть.
успех строка ch-gva-2

Примечания

Примечание

  • 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 можно найти на http://docs.ansible.com/ansible/guide_cloudstack.html
  • Этот модуль поддерживает режим проверки.

Статус

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

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API