Модуль dellemc.openmanage.redfish_event_subscription – Управление подписками Redfish
Примечание
Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Вам потребуются дополнительные требования для использования этого модуля, см. Требования для получения подробной информации.
Для использования в playbook укажите: dellemc.openmanage.redfish_event_subscription.
Новое в dellemc.openmanage 4.1.0
Краткое описание
- Этот модуль позволяет добавлять или удалять подписки на события Redfish.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 3.9.6
Параметры
Параметр | Комментарии |
|---|---|
baseuri строка / обязательно | IP-адрес целевого внешнего контроллера. Например - <ipaddress>:<port>. |
ca_path путь добавлено в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, который будет использоваться для проверки. |
destination строка / обязательно | URI HTTPS места назначения для отправки событий. Требуется HTTPS. |
event_format_type строка | Указывает тип формата события, на которое необходимо подписаться.
Варианты:
|
event_type строка | Указывает тип события, на которое необходимо подписаться.
Варианты:
|
password строка | Пароль целевого внешнего контроллера. Если пароль не указан, используется переменная среды Пример: export IDRAC_PASSWORD=password |
state строка |
Варианты:
|
timeout целое число добавлено в dellemc.openmanage 5.0.0 | Тайм-аут на уровне сокета в секундах. По умолчанию: |
username строка | Имя пользователя целевого внешнего контроллера. Если имя пользователя не указано, используется переменная среды Пример: export IDRAC_USERNAME=username |
validate_certs логическое добавлено в dellemc.openmanage 5.0.0 | Если Настраивайте До версии коллекции Варианты:
|
x_auth_token строка добавлено в dellemc.openmanage 9.3.0 | Токен аутентификации. Если x_auth_token не указан, используется переменная среды Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token |
Примечания
Примечание
-
event_type должен быть
MetricReport, а event_format_type должен бытьMetricReportдля подписки на метрики. -
event_type должен быть
Alert, а event_format_type должен бытьEventдля подписки на события. - Изменение подписки не поддерживается.
- Контекст всегда установлен в RedfishEvent.
- Этот модуль поддерживает
check_mode.
Примеры
---
- name: Add Redfish metric subscription
redfish_event_subscription:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
destination: "https://192.168.1.100:8188"
event_type: MetricReport
event_format_type: MetricReport
state: present
- name: Add Redfish alert subscription
redfish_event_subscription:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
destination: "https://server01.example.com:8188"
event_type: Alert
event_format_type: Event
state: present
- name: Delete Redfish subscription with a specified destination
redfish_event_subscription:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
destination: "https://server01.example.com:8188"
state: absent
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
error_info словарь | Подробности ошибки HTTP. Возвращается: при ошибке HTTP Пример: |
msg строка | Общий статус задачи. Возвращается: всегда Пример: |
status словарь | Возвращает созданный объект подписки. Возвращается: при успешном добавлении подписки Пример: |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/redfish_event_subscription_module.html