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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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