cs_vpc — Управляет VPC на облаках на основе Apache CloudStack.
Новое в версии 2.3.
- Описание
- Требования (на хосте, на котором выполняется модуль)
- Параметры
- Примеры
- Значения возврата
- Примечания
Описание
- Создание, обновление и удаление VPC.
Требования (на хосте, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязателен | по умолчанию | выбор | примечания |
|---|---|---|---|---|
| account | нет | Аккаунт, к которому относится VPC. | ||
| api_http_method | нет | get |
| Используемый 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 |
| Состояние 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