oneview_ethernet_network - Управление ресурсами сети Ethernet OneView
Новая версия 2.4.
Обзор
- Предоставляет интерфейс для управления ресурсами сети Ethernet. Может создавать, обновлять или удалять.
Требования (к хосту, выполняющему модуль)
- hpOneView >= 3.1.0
- python >= 2.7.9
Параметры
| параметр | обязательный | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| config | нет | Путь к файлу конфигурации .json, содержащему конфигурацию клиента OneView. Файл конфигурации необязателен и, если используется, должен присутствовать на хосте, выполняющем команды ansible. Если путь к файлу не указан, конфигурация будет загружена из переменных среды. Ссылки на примеры файлов конфигурации или способ использования переменных среды см. в разделе «Примечания». | ||
| data | да | Список свойств сети Ethernet. | ||
| state | нет | present |
| Указывает желаемое состояние ресурса сети Ethernet. - present гарантирует, что свойства данных соответствуют OneView. - absent удалит ресурс из OneView, если он существует. - default_bandwidth_reset сбросит шаблон подключения сети к значению по умолчанию. |
| validate_etag | нет | True |
| При включенном контроле ETag запрос будет обработан только в том случае, если текущий ETag ресурса совпадает с ETag, предоставленным в данных. |
Примеры
- name: Ensure that the Ethernet Network is present using the default configuration
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: present
data:
name: 'Test Ethernet Network'
vlanId: '201'
delegate_to: localhost
- name: Update the Ethernet Network changing bandwidth and purpose
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: present
data:
name: 'Test Ethernet Network'
purpose: Management
bandwidth:
maximumBandwidth: 3000
typicalBandwidth: 2000
delegate_to: localhost
- name: Ensure that the Ethernet Network is present with name 'Renamed Ethernet Network'
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: present
data:
name: 'Test Ethernet Network'
newName: 'Renamed Ethernet Network'
delegate_to: localhost
- name: Ensure that the Ethernet Network is absent
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: absent
data:
name: 'New Ethernet Network'
delegate_to: localhost
- name: Create Ethernet networks in bulk
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: present
data:
vlanIdRange: '1-10,15,17'
purpose: General
namePrefix: TestNetwork
smartLink: false
privateNetwork: false
bandwidth:
maximumBandwidth: 10000
typicalBandwidth: 2000
delegate_to: localhost
- name: Reset to the default network connection template
oneview_ethernet_network:
config: '/etc/oneview/oneview_config.json'
state: default_bandwidth_reset
data:
name: 'Test Ethernet Network'
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| название | описание | возвращается | тип | пример |
|---|---|---|---|---|
| ethernet_network | Содержит сведения о сетях Ethernet. | При состоянии 'present'. Может быть пустым. | dict | |
| ethernet_network_bulk | Содержит сведения о сетях Ethernet, затронутых массовым вставлением. | При наличии атрибута 'vlanIdRange' в аргументе data. Может быть пустым. | dict | |
| ethernet_network_connection_template | Содержит сведения о шаблоне подключения сети Ethernet. | При состоянии 'default_bandwidth_reset'. Может быть пустым. | dict |
Примечания
Примечание
- Пример файла конфигурации для параметра config можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/blob/master/examples/oneview_config-rename.json
- Информацию о способах использования переменных среды для конфигурации см. по адресу: https://github.com/HewlettPackard/oneview-ansible#environment-variables
- Дополнительные Playbook для модулей HPE OneView Ansible можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/tree/master/examples
- Версия API OneView, используемая непосредственно, повлияет на возвращаемые и ожидаемые поля ресурсов. Информацию о настройке желаемой версии API см. по адресу: https://github.com/HewlettPackard/oneview-ansible#setting-your-oneview-version
Статус
Этот модуль помечен как бета, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Информацию о сообществе и сотрудничестве, Тестирование 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/oneview_ethernet_network_module.html