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: Первый возвращаемый элемент, используя нумерацию с 0. - 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 для модулей 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 словарь | При запросе, но может быть null. | Содержит все факты OneView о конфигурации окружающей среды ограждения. |
| enclosure_script строка | При запросе, но может быть null. | Содержит все факты OneView о скрипте ограждения. |
| enclosure_utilization словарь | При запросе, но может быть null. | Содержит все факты OneView об использовании ограждения. |
| enclosures словарь | Всегда, но может быть null. | Содержит все факты OneView об ограждениях. |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.8/modules/oneview_enclosure_facts_module.html