community.general.oneview_ethernet_network_info – Получение информации об одной или нескольких сетевых картах Ethernet OneView

Примечание

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

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

Для использования в playbook укажите: community.general.oneview_ethernet_network_info.

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

Описание

Получение информации об одной или нескольких сетевых картах Ethernet из OneView.
Этот модуль назывался oneview_ethernet_network_facts до Ansible 2.9, возвращая ansible_facts. Обратите внимание, что модуль community.general.oneview_ethernet_network_info больше не возвращает ansible_facts!

Требования

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

hpOneView >= 2.0.1
python >= 2.7.9

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
config path		Путь к конфигурационному файлу .json, содержащему конфигурацию клиента OneView. Файл конфигурации необязателен и должен быть на хосте, выполняющем команды ansible. Если путь к файлу не указан, конфигурация будет загружена из переменных среды. Для получения ссылок на примеры конфигурационных файлов или способов использования переменных среды, см. раздел Примечания.
name string		Имя сетевой карты Ethernet.
options string		Список с параметрами для сбора дополнительной информации о сетевой карте Ethernet и связанных ресурсах. Допустимые значения: `associatedProfiles` и `associatedUplinkGroups`.
params dictionary		Список параметров для ограничения, фильтрации и сортировки списка ресурсов. Допустимые параметры: - `start`: первый элемент для возврата, используя индексацию с нуля. - `count`: количество возвращаемых ресурсов. - `filter`: общая строка фильтра/запроса для сужения списка возвращаемых элементов. - `sort`: порядок сортировки возвращаемых данных.

Примечания

Примечание

Пример конфигурационного файла для параметра config можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/blob/master/examples/oneview_config-rename.json
Инструкции по использованию переменных среды для конфигурации можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible#environment-variables
Дополнительные playbook для модулей Ansible HPE OneView можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/tree/master/examples
Версия OneView API, используемая напрямую, повлияет на возвращаемые и ожидаемые поля в ресурсах. Сведения о настройке желаемой версии API можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible#setting-your-oneview-version

Примеры

- name: Gather information about all Ethernet Networks
  community.general.oneview_ethernet_network_info:
    config: /etc/oneview/oneview_config.json
  delegate_to: localhost
  register: result

- ansible.builtin.debug:
    msg: "{{ result.ethernet_networks }}"

- name: Gather paginated and filtered information about Ethernet Networks
  community.general.oneview_ethernet_network_info:
    config: /etc/oneview/oneview_config.json
    params:
      start: 1
      count: 3
      sort: 'name:descending'
      filter: 'purpose=General'
  delegate_to: localhost
  register: result

- ansible.builtin.debug:
    msg: "{{ result.ethernet_networks }}"

- name: Gather information about an Ethernet Network by name
  community.general.oneview_ethernet_network_info:
    config: /etc/oneview/oneview_config.json
    name: Ethernet network name
  delegate_to: localhost
  register: result

- ansible.builtin.debug:
    msg: "{{ result.ethernet_networks }}"

- name: Gather information about an Ethernet Network by name with options
  community.general.oneview_ethernet_network_info:
    config: /etc/oneview/oneview_config.json
    name: eth1
    options:
      - associatedProfiles
      - associatedUplinkGroups
  delegate_to: localhost
  register: result

- ansible.builtin.debug:
    msg: "{{ result.enet_associated_profiles }}"
- ansible.builtin.debug:
    msg: "{{ result.enet_associated_uplink_groups }}"

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
enet_associated_profiles dictionary	При запросе, но может быть пустым.	Содержит всю информацию OneView о профилях, использующих сетевую карту Ethernet.
enet_associated_uplink_groups dictionary	При запросе, но может быть пустым.	Содержит всю информацию OneView о группах Uplink, использующих сетевую карту Ethernet.
ethernet_networks dictionary	Всегда, но может быть пустым.	Содержит всю информацию OneView о сетевых картах 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_info_module.html