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

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/oneview_ethernet_network_module.html