Spec-Zone.ru › Ansible 2.4

cs_vpc — Управляет VPC на облаках на основе Apache CloudStack.

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

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

Описание

  • Создание, обновление и удаление VPC.

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

параметр обязателен по умолчанию выбор примечания
account
нет
Аккаунт, к которому относится VPC.
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.
cidr
нет
CIDR VPC, например 10.1.0.0/16
Все CIDR-адреса гостевых сетей VPC должны находиться в этом CIDR.
Обязательно в state=present.
display_text
нет
Отображаемый текст VPC.
Если не задано, используется значение name, при создании.
domain
нет
Домен, к которому относится VPC.
name
да
Имя VPC.
network_domain
нет
Домен сети для VPC.
Все сети внутри VPC будут принадлежать этому домену.
poll_async
нет True
Ожидать завершения асинхронных задач.
project
нет
Имя проекта, к которому относится VPC.
state
нет present
  • present
  • absent
  • restarted
Состояние VPC.
tags
нет
Список тегов. Теги — список словарей, содержащих ключи key и value.
Для удаления всех тегов задайте пустой список, например tags: [].
псевдонимы: тег
vpc_offering
нет
Имя VPC-предложения.
Если не задано, используется стандартное VPC-предложение.
zone
нет
Имя зоны.
Если не задано, используется стандартная зона.

Примеры

# Ensure a VPC is present
- local_action:
    module: cs_vpc
    name: my_vpc
    display_text: My example VPC
    cidr: 10.10.0.0/16

# Ensure a VPC is absent
- local_action:
    module: cs_vpc
    name: my_vpc
    state: absent

# Ensure a VPC is restarted
- local_action:
    module: cs_vpc
    name: my_vpc
    state: restarted

Значения возврата

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

имя описание возвращается тип пример
account
Аккаунт, к которому относится VPC.
успех строка пример аккаунта
cidr
CIDR VPC.
успех строка 10.10.0.0/16
display_text
Отображаемый текст VPC.
успех строка Моя примерная VPC
distributed_vpc_router
Используется ли в VPC распределённый маршрутизатор.
успех булево True
domain
Домен, к которому относится VPC.
успех строка пример домена
id
UUID VPC.
успех строка 04589590-ac63-4ffc-93f5-b698b8ac38b6
name
Имя VPC.
успех строка my_vpc
network_domain
Домен сети VPC.
успех строка example.com
project
Имя проекта, к которому относится VPC.
успех строка Производство
redundant_vpc_router
Используются ли в VPC избыточные маршрутизаторы.
успех булево True
region_level_vpc
Является ли VPC региональным.
успех булево True
restart_required
Требуется ли перезапуск маршрутизатора VPC.
успех булево True
state
Состояние VPC.
успех строка Включено
tags
Список тегов ресурса, связанных с VPC.
успех словарь [ { "key": "foo", "value": "bar" } ]
zone
Имя зоны, в которой находится VPC.
успех строка 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_vpc_module.html

Spec-Zone.ru

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