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

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

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

Обзор

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

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account		Аккаунт, к которому относится VPC.
api_http_method	Варианты: get post	HTTP-метод, используемый для запроса к API-точке. Если не задано, используется переменная среды `CLOUDSTACK_METHOD`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — `get`, если не указано.
api_key		Ключ API API CloudStack. Если не задано, используется переменная среды `CLOUDSTACK_KEY`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
api_region	По умолчанию: cloudstack	Имя раздела ini в файле `cloustack.ini`. Если не указано, используется переменная среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ API CloudStack. Если не задано, используется переменная среды `CLOUDSTACK_SECRET`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
api_timeout		Таймаут HTTP в секундах. Если не задано, используется переменная среды `CLOUDSTACK_TIMEOUT`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — 10 секунд, если не указано.
api_url		URL API CloudStack, например, https://cloud.example.com/client/api. Если не задано, используется переменная среды `CLOUDSTACK_ENDPOINT`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
cidr		CIDR VPC, например, 10.1.0.0/16 Все CIDR гостевых сетей VPC должны находиться в этом CIDR. Требуется в `state=present`.
clean_up (добавлено в 2.5)		Переразвернуть маршрутизатор VPC или нет, когда `state=restarted`
display_text		Текст отображения VPC. Если не задано, `name` будет использоваться для создания.
domain		Домен, к которому относится VPC.
name обязательно		Имя VPC.
network_domain		Домен сети для VPC. Все сети внутри VPC будут принадлежать этому домену. Рассматривается только при создании VPC, изменить нельзя.
poll_async	По умолчанию: yes	Проверять асинхронные задачи до завершения.
project		Имя проекта, к которому относится VPC.
state	Варианты: present ← absent restarted	Состояние VPC.
tags		Список тегов. Теги представляют собой список словарей с ключами `key` и `value`. Для удаления всех тегов задайте пустой список, например, `tags: []`. псевдонимы: tag
vpc_offering		Имя предложения VPC. Если не задано, используется предложение 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.
Этот модуль поддерживает режим проверки.

Примеры

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

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

- name: Ensure a VPC is restarted with clean up
  local_action:
    module: cs_vpc
    name: my_vpc
    clean_up: true
    state: restarted

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

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

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

Статус

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

Автор

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.5/modules/cs_vpc_module.html