redfish_command – Управляет контроллерами вне зоны доступа с помощью API Redfish
Новое в версии 2.7.
Описание
- Создает URI Redfish локально и отправляет их удалённым контроллерам OOB для выполнения действия.
- Управляет контроллерами OOB, например, перезагрузкой, управлением журналами.
- Управляет пользователями контроллеров OOB, например, добавлением, удалением, обновлением.
- Управляет питанием системы, например, включением, выключением, плавной и принудительной перезагрузкой.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| baseuri - / обязательно | Базовый URI контроллера OOB | |
| bootdevice - | bootdevice при настройке конфигурации загрузки | |
| category - / обязательно | Категория для выполнения на контроллере OOB | |
| command - / обязательно | Список команд для выполнения на контроллере OOB | |
| password - / обязательно | Пароль для аутентификации с контроллером OOB | |
| timeout целое число добавлено в 2.7.11 | По умолчанию: 10 | Таймаут в секундах для запросов URL к контроллеру OOB |
| user - / обязательно | Пользователь для аутентификации с контроллером OOB | |
| userid - | ID пользователя для добавления/удаления/модификации | |
| username - | Имя пользователя для добавления/удаления/модификации | |
| userpswd - | Пароль пользователя для добавления/удаления/модификации | |
| userrole - | Роль пользователя для добавления/удаления/модификации |
Примеры
- name: Restart system power gracefully
redfish_command:
category: Systems
command: PowerGracefulRestart
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
- name: Set one-time boot device to {{ bootdevice }}
redfish_command:
category: Systems
command: SetOneTimeBoot
bootdevice: "{{ bootdevice }}"
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
- name: Add and enable user
redfish_command:
category: Accounts
command: AddUser,EnableUser
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
userid: "{{ userid }}"
username: "{{ username }}"
userpswd: "{{ userpswd }}"
userrole: "{{ userrole }}"
- name: Disable and delete user
redfish_command:
category: Accounts
command: ["DisableUser", "DeleteUser"]
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
userid: "{{ userid }}"
- name: Update user password
redfish_command:
category: Accounts
command: UpdateUserPassword
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
userid: "{{ userid }}"
userpswd: "{{ userpswd }}"
- name: Clear Manager Logs with a timeout of 20 seconds
redfish_command:
category: Manager
command: ClearLogs
baseuri: "{{ baseuri }}"
user: "{{ user }}"
password: "{{ password }}"
timeout: 20
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| msg строка | всегда | Сообщение с результатом действия или описанием ошибки Пример: Действие выполнено успешно |
Статус
- Данному модулю не гарантируется обратная совместимость интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Jose Delarosa (github: jose-delarosa)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/redfish_command_module.html