oneview_enclosure_facts - Получение фактов об одном или нескольких блоках
Новая версия с 2.5.
Обзор
- Получение фактов об одном или нескольких блоках из OneView.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- hpOneView >= 2.0.1
- python >= 2.7.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| config | Путь к файлу конфигурации .json, содержащему конфигурацию клиента OneView. Файл конфигурации необязателен и должен присутствовать на хосте, на котором выполняются команды Ansible. Если путь к файлу не указан, конфигурация загружается из переменных среды. Для ссылок на примеры файлов конфигурации или инструкций по использованию переменных среды см. раздел "Примечания". | |
| name | Имя блока. | |
| options | Список параметров для сбора дополнительных фактов о блоке и связанных ресурсах. Допустимые значения параметров: script, environmentalConfiguration, и utilization. Для параметра utilization, можно указать конкретные параметры. | |
| params | Список параметров для ограничения, фильтрации и сортировки списка ресурсов. Допустимые значения параметров: - 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
- Дополнительные книги Playbooks для модулей 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: Gather facts about all Enclosures
oneview_enclosure_facts:
hostname: 172.16.101.48
username: administrator
password: my_password
api_version: 500
no_log: true
delegate_to: localhost
- debug: var=enclosures
- name: Gather paginated, filtered and sorted facts about Enclosures
oneview_enclosure_facts:
params:
start: 0
count: 3
sort: name:descending
filter: status=OK
hostname: 172.16.101.48
username: administrator
password: my_password
api_version: 500
no_log: true
delegate_to: localhost
- debug: var=enclosures
- name: Gather facts about an Enclosure by name
oneview_enclosure_facts:
name: Enclosure-Name
hostname: 172.16.101.48
username: administrator
password: my_password
api_version: 500
no_log: true
delegate_to: localhost
- debug: var=enclosures
- name: Gather facts about an Enclosure by name with options
oneview_enclosure_facts:
name: Test-Enclosure
options:
- script # optional
- environmentalConfiguration # optional
- utilization # optional
hostname: 172.16.101.48
username: administrator
password: my_password
api_version: 500
no_log: true
delegate_to: localhost
- debug: var=enclosures
- debug: var=enclosure_script
- debug: var=enclosure_environmental_configuration
- debug: var=enclosure_utilization
- name: "Gather facts about an Enclosure with temperature data at a resolution of one sample per day, between two
specified dates"
oneview_enclosure_facts:
name: Test-Enclosure
options:
- utilization: # optional
fields: AmbientTemperature
filter:
- startDate=2016-07-01T14:29:42.000Z
- endDate=2017-07-01T03:29:42.000Z
view: day
refresh: false
hostname: 172.16.101.48
username: administrator
password: my_password
api_version: 500
no_log: true
delegate_to: localhost
- debug: var=enclosures
- debug: var=enclosure_utilization
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| enclosure_environmental_configuration словарь | При запросе, но может быть пустым. | Содержит все факты OneView о конфигурации окружения блока. |
| enclosure_script строка | При запросе, но может быть пустым. | Содержит все факты OneView о скрипте блока. |
| enclosure_utilization словарь | При запросе, но может быть пустым. | Содержит все факты OneView об использовании блока. |
| enclosures словарь | Всегда, но может быть пустым. | Содержит все факты OneView о блоках. |
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Более подробная информация о поддержке модулей доступна по адресу здесь.
Список других модулей, поддерживаемых сообществом Ansible, находится здесь.
Автор
- 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.6/modules/oneview_enclosure_facts_module.html