oneview_ethernet_network_facts - Получение фактов о одной или нескольких сетях Ethernet OneView
Новое в версии 2.4.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Получение фактов об одной или нескольких сетях Ethernet из OneView.
Требования (к хосту, на котором выполняется модуль)
- hpOneView >= 2.0.1
- python >= 2.7.9
Параметры
| параметр | обязателен | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| config | нет | Путь к файлу конфигурации .json, содержащему конфигурацию клиента OneView. Файл конфигурации необязателен, и при его использовании он должен быть присутствовать на хосте, на котором выполняются команды ansible. Если путь к файлу не указан, конфигурация будет загружена из переменных среды. Для ссылок на примеры файлов конфигурации или инструкции по использованию переменных среды, см. раздел «Примечания». | ||
| name | нет | Имя сети Ethernet. | ||
| options | нет | Список параметров для сбора дополнительных фактов о сети Ethernet и связанных ресурсах. Разрешенные параметры: associatedProfiles и associatedUplinkGroups. | ||
| params | нет | Список параметров для ограничения, фильтрации и сортировки списка ресурсов. Разрешенные параметры: - start: Первый элемент для возврата, используя индексацию с нуля. - count: Количество ресурсов для возврата. - filter: Общая строка фильтра/запроса для сужения списка возвращаемых элементов. - sort: Порядок сортировки возвращаемых данных. |
Примеры
- name: Gather facts about all Ethernet Networks
oneview_ethernet_network_facts:
config: /etc/oneview/oneview_config.json
delegate_to: localhost
- debug: var=ethernet_networks
- name: Gather paginated and filtered facts about Ethernet Networks
oneview_ethernet_network_facts:
config: /etc/oneview/oneview_config.json
params:
start: 1
count: 3
sort: 'name:descending'
filter: 'purpose=General'
delegate_to: localhost
- debug: var=ethernet_networks
- name: Gather facts about an Ethernet Network by name
oneview_ethernet_network_facts:
config: /etc/oneview/oneview_config.json
name: Ethernet network name
delegate_to: localhost
- debug: var=ethernet_networks
- name: Gather facts about an Ethernet Network by name with options
oneview_ethernet_network_facts:
config: /etc/oneview/oneview_config.json
name: eth1
options:
- associatedProfiles
- associatedUplinkGroups
delegate_to: localhost
- debug: var=enet_associated_profiles
- debug: var=enet_associated_uplink_groups
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| enet_associated_profiles | Содержит все факты OneView о профилях, использующих сеть Ethernet. | При запросе, но может быть пустым. | dict | |
| enet_associated_uplink_groups | Содержит все факты OneView о наборах Uplink, использующих сеть Ethernet. | При запросе, но может быть пустым. | dict | |
| ethernet_networks | Содержит все факты OneView о сетях Ethernet. | Всегда, но может быть пустым. | dict |
Примечания
Примечание
- Пример файла конфигурации для параметра 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
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вам это интересно, ознакомьтесь со статьей Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/oneview_ethernet_network_facts_module.html