redfish_command – Управляет контроллерами вне зоны сети с помощью API Redfish
Новое в версии 2.7.
Описание
- Создает URI Redfish локально и отправляет их удаленным контроллерам OOB для выполнения действия.
- Управляет контроллером OOB, например, перезагрузкой, управлением журналами.
- Управляет пользователями контроллера OOB, например, добавлением, удалением, обновлением.
- Управляет питанием системы, например, включением, выключением, плавной и принудительной перезагрузкой.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| baseuri - / обязательно | Основной URI контроллера OOB | |
| bootdevice - | bootdevice при настройке конфигурации загрузки | |
| category - / обязательно | Категория для выполнения на контроллере OOB | |
| command - / обязательно | Список команд для выполнения на контроллере OOB | |
| id - добавлен в 2.8 | Идентификатор пользователя для добавления/удаления/модификации | |
| new_password - добавлен в 2.8 | Пароль пользователя для добавления/удаления/модификации | |
| new_username - добавлен в 2.8 | Имя пользователя для добавления/удаления/модификации | |
| password - / обязательно | Пароль для аутентификации с контроллером OOB | |
| roleid - добавлен в 2.8 | Роль пользователя для добавления/удаления/модификации | |
| timeout целое число добавлен в 2.8 | По умолчанию: 10 | Тайм-аут в секундах для запросов URL к контроллеру OOB |
| username - / обязательно добавлен в 2.8 | Пользователь для аутентификации с контроллером OOB |
Примеры
- name: Restart system power gracefully
redfish_command:
category: Systems
command: PowerGracefulRestart
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
- name: Set one-time boot device to {{ bootdevice }}
redfish_command:
category: Systems
command: SetOneTimeBoot
bootdevice: "{{ bootdevice }}"
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
- name: Set chassis indicator LED to blink
redfish_command:
category: Chassis
command: IndicatorLedBlink
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
- name: Add and enable user
redfish_command:
category: Accounts
command: AddUser,EnableUser
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
id: "{{ id }}"
new_username: "{{ new_username }}"
new_password: "{{ new_password }}"
roleid: "{{ roleid }}"
- name: Disable and delete user
redfish_command:
category: Accounts
command: ["DisableUser", "DeleteUser"]
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
id: "{{ id }}"
- name: Update user password
redfish_command:
category: Accounts
command: UpdateUserPassword
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
id: "{{ id }}"
new_password: "{{ new_password }}"
- name: Clear Manager Logs with a timeout of 20 seconds
redfish_command:
category: Manager
command: ClearLogs
baseuri: "{{ baseuri }}"
username: "{{ username }}"
password: "{{ password }}"
timeout: 20
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| msg строка | всегда | Сообщение с результатом действия или описанием ошибки Пример: Действие выполнено успешно |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Jose Delarosa (@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.8/modules/redfish_command_module.html