модуль ngine_io.cloudstack.cs_vpc – Управление VPC на облаках на основе Apache CloudStack.
Примечание
Этот модуль является частью коллекции ngine_io.cloudstack (версия 2.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.
Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_vpc.
Добавлена в ngine_io.cloudstack 0.1.0
Описание
- Создание, обновление и удаление VPC.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
Параметр | Комментарии |
|---|---|
account строка | Аккаунт, к которому относится VPC. |
api_http_method строка | Метод HTTP, используемый для запроса к API-точке. Если не указано, рассматривается переменная среды Варианты:
|
api_key строка / обязательно | API-ключ CloudStack API. Если не указано, рассматривается переменная среды |
api_secret строка / обязательно | Секретный ключ CloudStack API. Если не указано, рассматривается переменная среды |
api_timeout целое число | Таймаут HTTP в секундах. Если не указано, рассматривается переменная среды По умолчанию: |
api_url строка / обязательно | URL CloudStack API, например: https://cloud.example.com/client/api. Если не указано, рассматривается переменная среды |
api_verify_ssl_cert строка | Проверка сертификата CA. Если не указано, рассматривается переменная среды |
cidr строка | CIDR VPC, например 10.1.0.0/16. Все CIDR-сети гостевых сетей VPC должны находиться в пределах этого CIDR. Требуется при state=present. |
clean_up логическое значение | Переразвертывать роутер VPC при state=restarted или нет. Варианты:
|
display_text строка | Отображаемый текст VPC. Если не задано, для создания используется name. |
domain строка | Домен, к которому относится VPC. |
name строка / обязательно | Имя VPC. |
network_domain строка | Сеть домена для VPC. Все сети внутри VPC будут принадлежать этому домену. Рассматривается только при создании VPC, изменить нельзя. |
poll_async логическое значение | Проверять асинхронные задачи до завершения. Варианты:
|
project строка | Название проекта, к которому относится VPC. |
state строка | Состояние VPC. Состояние Состояние Варианты:
|
tags aliases: tag список / элементы=словарь | Список тегов. Теги представляют собой список словарей с ключами key и value. Для удаления всех тегов установите пустой список, например: tags: []. |
validate_certs логическое значение добавлено в ngine_io.cloudstack 2.4.0 | Если Если не указано, рассматривается переменная среды Это следует использовать только на сайтах под личным контролем с использованием самозаверенных сертификатов. Варианты:
|
vpc_offering строка | Имя предложения VPC. Если не задано, используется предложение VPC по умолчанию. |
zone строка / обязательно | Название зоны. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве CloudStack Cloud.
- Этот модуль поддерживает режим проверки.
Примеры
- 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 string | Учетная запись, с которой связан VPC. Возвращается: успех Пример: |
cidr string | CIDR VPC. Возвращается: успех Пример: |
display_text string | Отображаемый текст VPC. Возвращается: успех Пример: |
distributed_vpc_router boolean | Использует ли VPC распределенный маршрутизатор или нет. Возвращается: успех Пример: |
domain string | Домен, с которым связан VPC. Возвращается: успех Пример: |
id string | UUID VPC. Возвращается: успех Пример: |
name string | Название VPC. Возвращается: успех Пример: |
network_domain string | Домен сети VPC. Возвращается: успех Пример: |
project string | Название проекта, с которым связан VPC. Возвращается: успех Пример: |
redundant_vpc_router boolean | Есть ли у VPC избыточные маршрутизаторы или нет. Возвращается: успех Пример: |
region_level_vpc boolean | Является ли VPC региональным или нет. Возвращается: успех Пример: |
restart_required boolean | Требуется ли перезагрузка маршрутизатора VPC или нет. Возвращается: успех Пример: |
state string | Состояние VPC. Возвращается: успех Пример: |
tags list / elements=string | Список тегов ресурсов, связанных с VPC. Возвращается: успех Пример: |
zone string | Название зоны, в которой находится VPC. Возвращается: успех Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_vpc_module.html
