ngine_io.cloudstack.cs_vpc – Управляет VPC на облаках, основанных на Apache CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack

Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_vpc

Новое в версии 0.1.0: модуля ngine_io.cloudstack

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account строка		Аккаунт, к которому относится VPC.
api_http_method строка	Варианты: get ← post	Метод HTTP, используемый для запроса к API-точке. Если не указано, используется переменная среды `CLOUDSTACK_METHOD`
api_key строка / обязательно		Ключ API CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_KEY`
api_secret строка / обязательно		Секретный ключ API CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_SECRET`
api_timeout целое число	По умолчанию: 10	Таймаут HTTP в секундах. Если не указано, используется переменная среды `CLOUDSTACK_TIMEOUT`
api_url строка / обязательно		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды `CLOUDSTACK_ENDPOINT`
api_verify_ssl_cert строка		Проверка файла сертификата CA. Если не указано, используется переменная среды `CLOUDSTACK_VERIFY`
cidr строка		CIDR VPC, например 10.1.0.0/16 Все CIDR сетей VPC должны находиться в этом CIDR. Требуется при state=present.
clean_up логическое	Варианты: no yes	Переразвёртывать маршрутизатор VPC или нет, когда state=restarted
display_text строка		Текст отображения VPC. Если не указан, используется name для создания.
domain строка		Домен, к которому относится VPC.
name строка / обязательно		Имя VPC.
network_domain строка		Домен сети для VPC. Все сети внутри VPC будут принадлежать этому домену. Рассматривается только при создании VPC, не может быть изменён.
poll_async логическое	Варианты: no yes ←	Выполнять опрос асинхронных задач, пока задача не завершится.
project строка		Имя проекта, к которому относится VPC.
state строка	Варианты: present ← absent stopped restarted	Состояние VPC. Состояние `present` создаёт запущенную VPC. Состояние `stopped` рассматривается только при создании VPC, добавлено в версии 2.6.
tags список / элементы=словарь		Список тегов. Теги — список словарей, содержащих ключи key и value. Для удаления всех тегов установите пустой список, например, tags: []. псевдонимы: тег
vpc_offering строка		Имя предложения VPC. Если не указано, используется предложение VPC по умолчанию.
zone строка / обязательно		Имя зоны.

Примечания

Примечание

Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Ensure a VPC is present but not started after creating
  ngine_io.cloudstack.cs_vpc:
    name: my_vpc
    zone: zone01
    display_text: My example VPC
    cidr: 10.10.0.0/16
    state: stopped

- name: Ensure a VPC is present and started after creating
  ngine_io.cloudstack.cs_vpc:
    name: my_vpc
    zone: zone01
    display_text: My example VPC
    cidr: 10.10.0.0/16

- name: Ensure a VPC is absent
  ngine_io.cloudstack.cs_vpc:
    name: my_vpc
    zone: zone01
    state: absent

- name: Ensure a VPC is restarted with clean up
  ngine_io.cloudstack.cs_vpc:
    name: my_vpc
    zone: zone01
    clean_up: yes
    state: restarted

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

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

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

Авторы

René Moser (@resmo)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_vpc_module.html