community.general.oneview_ethernet_network – Управление ресурсами сети Ethernet OneView

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.oneview_ethernet_network.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Предоставляет интерфейс для управления ресурсами сети 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 логическое	Варианты: 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
Дополнительные книги задач для модулей 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
  community.general.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
  community.general.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'
  community.general.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
  community.general.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
  community.general.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
  community.general.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.

Авторы

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.10/collections/community/general/oneview_ethernet_network_module.html