cs_vpc_offering - Управляет предложениями VPC в облаках на основе Apache CloudStack.

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

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

Обзор

Создание, обновление, включение, выключение и удаление предложений CloudStack VPC.

Требования

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

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_http_method	Варианты: get post	HTTP-метод, используемый для запроса к API-точке входа. Если не указан, используется переменная среды `CLOUDSTACK_METHOD`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — `get`, если не указано.
api_key		Ключ API CloudStack API. Если не указан, используется переменная среды `CLOUDSTACK_KEY`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
api_region	Значение по умолчанию: "cloudstack"	Имя раздела в файле конфигурации ini `cloustack.ini`. Если не указан, используется переменная среды `CLOUDSTACK_REGION`.
api_secret		Секретный ключ CloudStack API. Если не указан, используется переменная среды `CLOUDSTACK_SECRET`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
api_timeout		Таймаут HTTP в секундах. Если не указан, используется переменная среды `CLOUDSTACK_TIMEOUT`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию — 10 секунд, если не указано.
api_url		URL CloudStack API, например https://cloud.example.com/client/api. Если не указан, используется переменная среды `CLOUDSTACK_ENDPOINT`. В качестве последней опции значение берется из файла конфигурации ini, см. также примечания.
display_text		Текст для отображения предложений VPC.
name обязательно		Имя предложения VPC.
poll_async	Значение по умолчанию: "да"	Проверяет асинхронные задания, пока не будут завершены.
service_capabilities		Желаемые возможности предоставления услуг в рамках предложения VPC. псевдонимы: service_capability
service_offering		Имя или ID предложения услуг для устройства маршрутизатора VPC.
service_providers		Сопоставление поставщиков услуг. Если не указано, поставщик услуги будет сопоставлен с поставщиком по умолчанию на физической сети. псевдонимы: service_provider
state	Варианты: enabled present ← disabled absent	Состояние предложения VPC.
supported_services		Поддерживаемые услуги предложения VPC. псевдонимы: supported_service

Примечания

Примечание

Если учетные данные не предоставляются в качестве аргументов api_url, api_key, api_secret, Ansible использует метод конфигурации библиотеки cs. Конфигурация считывается из нескольких мест в следующем порядке. 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.
Этот модуль поддерживает режим проверки.

Примеры

# Create a vpc offering and enable it
- local_action:
    module: cs_vpc_offering
    name: "my_vpc_offering"
    display_text: "vpc offering description"
    state: enabled
    supported_services: [ Dns, Dhcp ]
    service_providers:
      - {service: 'dns', provider: 'virtualrouter'}
      - {service: 'dhcp', provider: 'virtualrouter'}

# Remove a vpc offering
- local_action:
    module: cs_vpc_offering
    name: "my_vpc_offering"
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
display_text строка	успех	Текст для отображения предложения VPC. Пример: Моё предложение VPC
distributed логическое	успех	Указывает, поддерживает ли предложение VPC распределенный маршрутизатор для однохопового переадресации.
id строка	успех	UUID предложения VPC. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
is_default логическое	успех	Является ли предложение VPC предложением по умолчанию или нет.
name строка	успех	Имя предложения VPC. Пример: MyCustomVPCOffering
region_level логическое	успех	Указывает, может ли предложение поддерживать VPC на уровне региона.
service_offering_id строка	успех	ID предложения услуг. Пример: c5f7a5fc-43f8-11e5-a151-feff819cdc9f
state строка	успех	Состояние предложения VPC. Пример: Включено

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

David Passante (@dpassante)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cs_vpc_offering_module.html