oneview_ethernet_network - Управление ресурсами сети Ethernet OneView

Новая версия 2.4.

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

Описание

Предоставляет интерфейс для управления ресурсами сети Ethernet. Может создавать, обновлять или удалять.

Требования

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

hpOneView >= 3.1.0
python >= 2.7.9

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
config		Путь к файлу конфигурации .json, содержащему настройки клиента OneView. Файл конфигурации является необязательным и при использовании должен быть доступен на хосте, на котором выполняются команды ansible. Если путь к файлу не указан, конфигурация будет загружена из переменных среды. Для ссылок на примеры файлов конфигурации или способов использования переменных среды см. раздел Примечания.
data обязательно		Список свойств сети Ethernet.
state	Варианты: present ← absent default_bandwidth_reset	Указывает желаемое состояние ресурса сети Ethernet. - `present` обеспечит соответствие свойств данных OneView. - `absent` удалит ресурс из OneView, если он существует. - `default_bandwidth_reset` сбросит шаблон подключения сети к значениям по умолчанию.
validate_etag bool	Варианты: no yes ←	При включенной валидации ETag запрос будет обработано только в том случае, если текущий ETag ресурса соответствует значению ETag, предоставленному в данных.

Примечания

Примечание

Пример файла конфигурации для параметра 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

Примеры

- 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 dict	При состоянии 'present'. Может быть null.	Содержит данные о сетях Ethernet.
ethernet_network_bulk dict	При наличии атрибута 'vlanIdRange' в аргументе data. Может быть null.	Содержит данные о сетях Ethernet, затронутых массовым добавлением.
ethernet_network_connection_template dict	При состоянии 'default_bandwidth_reset'. Может быть null.	Содержит данные о шаблоне подключения сети Ethernet.

Статус

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

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

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

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

Автор

Felipe Bulsoni (@fgbulsoni)
Thiago Miotto (@tmiotto)
Adriane Cardozo (@adriane-cardozo)

Подсказка

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

© 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/oneview_ethernet_network_module.html