oneview_enclosure_info – Получение информации об одном или нескольких шкафах

Новая версия 2.5.

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

Обзор

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

Псевдонимы: oneview_enclosure_facts

Требования

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

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
Дополнительные сценарии выполнения для модулей 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 information about all Enclosures
  oneview_enclosure_info:
    hostname: 172.16.101.48
    username: administrator
    password: my_password
    api_version: 500
  no_log: true
  delegate_to: localhost
  register: result
- debug:
    msg: "{{ result.enclosures }}"

- name: Gather paginated, filtered and sorted information about Enclosures
  oneview_enclosure_info:
    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
  register: result
- debug:
    msg: "{{ result.enclosures }}"

- name: Gather information about an Enclosure by name
  oneview_enclosure_info:
    name: Enclosure-Name
    hostname: 172.16.101.48
    username: administrator
    password: my_password
    api_version: 500
  no_log: true
  delegate_to: localhost
  register: result
- debug:
    msg: "{{ result.enclosures }}"

- name: Gather information about an Enclosure by name with options
  oneview_enclosure_info:
    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
  register: result
- debug:
    msg: "{{ result.enclosures }}"
- debug:
    msg: "{{ result.enclosure_script }}"
- debug:
    msg: "{{ result.enclosure_environmental_configuration }}"
- debug:
    msg: "{{ result.enclosure_utilization }}"

- name: "Gather information about an Enclosure with temperature data at a resolution of one sample per day, between two
         specified dates"
  oneview_enclosure_info:
    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
  register: result
- debug:
    msg: "{{ result.enclosures }}"
- debug:
    msg: "{{ result.enclosure_utilization }}"

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

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

Ключ	Возвращаемое значение	Описание
enclosure_environmental_configuration словарь	При запросе, но может быть пустым.	Содержит всю информацию OneView об конфигурации среды шкафа.
enclosure_script строка	При запросе, но может быть пустым.	Содержит всю информацию OneView о скрипте шкафа.
enclosure_utilization словарь	При запросе, но может быть пустым.	Содержит всю информацию OneView об использовании шкафа.
enclosures словарь	Всегда, но может быть пустым.	Содержит всю информацию 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.9/modules/oneview_enclosure_info_module.html