Spec-Zone.ru › Ansible

Модуль ngine_io.cloudstack.network_offering — управление сетевыми предложениями в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для работы с этим модулем требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.network_offering.

Добавлено в ngine_io.cloudstack 0.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Создание, обновление, включение, отключение и удаление сетевых предложений.

Псевдонимы: cs_network_offering

Требования

Для работы модуля на хосте, где он выполняется, необходимы следующие компоненты.

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

api_http_method

строка

Метод HTTP, используемый для обращения к конечной точке API.

Если параметр не задан, используется переменная окружения CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

строка / обязательный

Ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_KEY.

api_secret

строка / обязательный

Секретный ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_SECRET.

api_timeout

целое число

Тайм-аут HTTP в секундах.

Если параметр не задан, используется переменная окружения CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

строка / обязательный

URL API CloudStack, например https://cloud.example.com/client/api.

Если параметр не задан, используется переменная окружения CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

строка

Проверять файл сертификата центра сертификации.

Если параметр не задан, используется переменная окружения CLOUDSTACK_VERIFY.

availability

строка

Доступность сетевого предложения. Значение по умолчанию — Optional.

conserve_mode

логическое значение

Включён ли в сетевом предложении режим экономии IP-адресов.

Варианты:

  • false
  • true

details

список / элементы=словарь

Сведения о сетевом предложении в виде пар «ключ/значение».

поставщик службы указывается в качестве значения

display_text

строка

Отображаемый текст сетевого предложения.

domains

псевдонимы: domain

список / элементы=строка

добавлено в ngine_io.cloudstack 2.2.0

Список доменов, к которым относится сетевое предложение.

Для общедоступных предложений используйте public.

egress_default_policy

строка

Разрешена или запрещена исходящая передача данных по умолчанию.

Варианты:

  • "allow"
  • "deny"

for_vpc

логическое значение

Предназначено ли предложение для использования с VPC.

Варианты:

  • false
  • true

guest_ip_type

строка

Тип гостевой сети сетевого предложения.

Варианты:

  • "Shared"
  • "Isolated"

keepalive_enabled

логическое значение

Если значение равно true, в балансировщике нагрузки будет включён keepalive.

На момент написания документации это влияет только на haproxy.

Параметры mode http и httpclose не задаются в файле конфигурации haproxy.

Варианты:

  • false
  • true

max_connections

целое число

Максимальное количество одновременных подключений, поддерживаемое сетевым предложением.

name

строка / обязательный

Название сетевого предложения.

network_rate

целое число

Разрешённая скорость передачи данных в мегабитах в секунду.

persistent

логическое значение

True, если сетевое предложение поддерживает постоянные сети.

Если параметр не задан, по умолчанию используется false.

Варианты:

  • false
  • true

service_capabilities

псевдонимы: service_capability

список / элементы=строка

Требуемые возможности служб в составе сетевого предложения.

service_offering

строка

Название или идентификатор предложения службы, используемого поставщиком виртуального маршрутизатора.

service_providers

псевдонимы: service_provider

список / элементы=словарь

Сопоставление поставщиков со службами.

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

specify_ip_ranges

логическое значение

Поддерживает ли сетевое предложение указание диапазонов IP-адресов.

Если параметр не указан, API присваивает значение no.

Варианты:

  • false
  • true

specify_vlan

логическое значение

Поддерживает ли сетевое предложение VLAN.

Варианты:

  • false
  • true

state

строка

Состояние сетевого предложения.

Варианты:

  • "enabled"
  • "present" ← (по умолчанию)
  • "disabled"
  • "absent"

supported_services

псевдонимы: supported_service

список / элементы=строка

Службы, поддерживаемые сетевым предложением.

Список из одного или нескольких элементов, выбранных из списка вариантов.

Варианты:

  • "Dns"
  • "PortForwarding"
  • "Dhcp"
  • "SourceNat"
  • "UserData"
  • "Firewall"
  • "StaticNat"
  • "Vpn"
  • "Lb"
  • "NetworkACL"
  • "SecurityGroup"
  • "Connectivity"
  • "BaremetalPxeService"

tags

псевдонимы: tag

список / элементы=строка

добавлено в ngine_io.cloudstack 2.2.0

Список тегов. Теги представляют собой список строк.

Чтобы удалить все теги, задайте пустой список, например tags: [].

traffic_type

строка

Тип трафика для сетевого предложения.

По умолчанию: "Guest"

validate_certs

логическое значение

добавлено в ngine_io.cloudstack 2.4.0

Если задано значение false, SSL-сертификаты не будут проверяться.

Если параметр не задан, используется переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на контролируемых вами ресурсах с самоподписанными сертификатами.

Варианты:

  • false
  • true ← (по умолчанию)

zones

псевдонимы: zone

список / элементы=строка

добавлено в ngine_io.cloudstack 2.2.0

Список зон, к которым относится сетевое предложение.

Для предложения, действующего во всех зонах, используйте all.

Примечания

Примечание

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

Примеры

- name: Create a network offering and enable it
  ngine_io.cloudstack.network_offering:
    name: my_network_offering
    display_text: network offering description
    state: enabled
    guest_ip_type: Isolated
    supported_services:
      - Dns
      - PortForwarding
      - Dhcp
      - SourceNat
      - UserData
      - Firewall
      - StaticNat
      - Vpn
      - Lb
      - NetworkACL
      - SecurityGroup
      - Connectivity
      - BaremetalPxeService
    service_providers:
      - { service: 'dns', provider: 'virtualrouter' }
      - { service: 'dhcp', provider: 'virtualrouter' }

- name: Remove a network offering
  ngine_io.cloudstack.network_offering:
    name: my_network_offering
    state: absent

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

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

Ключ

Описание

availability

string

Доступность сетевого предложения.

Возвращается: success

Пример: "Optional"

display_text

string

Отображаемый текст сетевого предложения.

Возвращается: success

Пример: "My network offering"

domains

list / elements=string

добавлено в ngine_io.cloudstack 2.2.0

Список доменов, связанных с сетевым предложением.

Возвращается: success

Пример: ["public"]

egress_default_policy

string

Политика исходящего трафика по умолчанию.

Возвращается: success

Пример: "allow"

for_vpc

boolean

Предназначено ли это предложение для использования с VPC.

Возвращается: success

Пример: false

guest_ip_type

string

Тип гостевой сети для сетевого предложения.

Возвращается: success

Пример: "Isolated"

id

string

UUID сетевого предложения.

Возвращается: success

Пример: "a6f7a5fc-43f8-11e5-a151-feff819cdc9f"

is_default

boolean

Является ли сетевое предложение предложением по умолчанию.

Возвращается: success

Пример: false

is_persistent

boolean

Поддерживаются ли постоянные сети.

Возвращается: success

Пример: false

max_connections

integer

Максимальное количество одновременных подключений, обрабатываемых балансировщиком нагрузки (LB).

Возвращается: success

Пример: 300

name

string

Название сетевого предложения.

Возвращается: success

Пример: "MyCustomNetworkOffering"

network_rate

integer

Скорость передачи сетевого трафика в Мбит/с.

Возвращается: success

Пример: 200

service_offering_id

string

ID сервисного предложения.

Возвращается: success

Пример: "c5f7a5fc-43f8-11e5-a151-feff819cdc9f"

state

string

Состояние сетевого предложения.

Возвращается: success

Пример: "Enabled"

tags

list / elements=string

добавлено в ngine_io.cloudstack 2.2.0

Список тегов, связанных с сетевым предложением.

Возвращается: success

Пример: ["tag1", "tag2"]

traffic_type

string

Тип трафика.

Возвращается: success

Пример: "Guest"

zones

list / elements=string

добавлено в ngine_io.cloudstack 2.2.0

Список зон, связанных с сетевым предложением.

Возвращается: success

Пример: ["all"]

Авторы

  • David Passante (@dpassante)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API