cs_traffic_type – Управляет типами трафика в физических сетях CloudStack
Новая в версии 2.8.
Краткое описание
- Добавление, удаление и обновление типов трафика, связанных с физическими сетями CloudStack.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.6.10
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| Метод HTTP, используемый для запроса к API-точке. Если не указано, используется переменная среды CLOUDSTACK_METHOD. В качестве последней опции значение берется из файла конфигурации ini, см. также раздел примечаний. Значение по умолчанию get , если не указано. |
| api_key строка | Ключ API CloudStack API. Если не указано, используется переменная среды CLOUDSTACK_KEY. В качестве последней опции значение берется из файла конфигурации ini, см. также раздел примечаний. | |
| api_region строка | Значение по умолчанию: "cloudstack" | Имя раздела в файле конфигурации 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, см. также раздел примечаний. | |
| hyperv_networklabel строка | Имя метки сети физического устройства, выделенного для этого трафика на хосте HyperV. | |
| isolation_method строка |
| Используйте, если физическая сеть имеет несколько типов изоляции, а тип трафика – общедоступный. |
| kvm_networklabel строка | Имя метки сети физического устройства, выделенного для этого трафика на хосте KVM. | |
| ovm3_networklabel строка | Имя сети физического устройства, выделенного для этого трафика на хосте OVM3. | |
| physical_network строка / обязательный | имя физической сети | |
| poll_async булево |
| Ожидать завершения асинхронных заданий. |
| state строка |
| Состояние типа трафика |
| traffic_type строка / обязательный |
| Тип трафика, который нужно добавить в физическую сеть. |
| vlan строка | Идентификатор VLAN, который будет использоваться для управления трафиком хостом VMware. | |
| vmware_networklabel строка | Имя метки сети физического устройства, выделенного для этого трафика на хосте VMware. | |
| xen_networklabel строка | Имя метки сети физического устройства, выделенного для этого трафика на хосте XenServer. | |
| zone строка | Имя зоны с физической сетью. Будет использована зона по умолчанию, если эта строка пустая. |
Примечания
Примечание
- Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены аргументамиapi_url,api_key,api_secret. Конфигурация считывается из нескольких источников в следующем порядке. Переменные средыCLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменная средыCLOUDSTACK_TIMEOUT, указывающая на файл.ini. Файлcloudstack.iniв текущей рабочей директории. Файл.cloudstack.iniв домашней директории пользователя. Допускается указание нескольких учетных данных и точек входа с использованием разделов ini в файлеcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, раздел по умолчанию -cloudstack. Дополнительная информация: https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: add a traffic type
cs_traffic_type:
physical_network: public-network
traffic_type: Guest
zone: test-zone
delegate_to: localhost
- name: update traffic type
cs_traffic_type:
physical_network: public-network
traffic_type: Guest
kvm_networklabel: cloudbr0
zone: test-zone
delegate_to: localhost
- name: remove traffic type
cs_traffic_type:
physical_network: public-network
traffic_type: Public
state: absent
zone: test-zone
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| hyperv_networklabel строка | успех | Метка имени сети физического устройства, выделенного для этого трафика на хосте HyperV Пример: HyperV Internal Switch |
| id строка | успех | Идентификатор поставщика сети Пример: 659c1840-9374-440d-a412-55ca360c9d3c |
| kvm_networklabel строка | успех | Метка имени сети физического устройства, выделенного для этого трафика на хосте KVM Пример: cloudbr0 |
| ovm3_networklabel строка | успех | Имя сети физического устройства, выделенного для этого трафика на хосте OVM3 Пример: cloudbr0 |
| physical_network строка | успех | Физическая сеть, к которой это относится Пример: 28ed70b7-9a1f-41bf-94c3-53a9f22da8b6 |
| traffic_type строка | успех | Тип трафика, добавленный в физическую сеть Пример: Public |
| vmware_networklabel строка | успех | Метка имени сети физического устройства, выделенного для этого трафика на хосте VMware Пример: Management Network |
| xen_networklabel строка | успех | Метка имени сети физического устройства, выделенного для этого трафика на хосте XenServer Пример: xenbr0 |
| zone строка | успех | Имя зоны, в которой находится физическая сеть. Пример: ch-gva-2 |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Patryk Cichy (@PatTheSilent)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/cs_traffic_type_module.html