Модуль dellemc.openmanage.ome_session — управление сеансами OpenManage Enterprise и OpenManage Enterprise Modular

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_session.

Добавлено в dellemc.openmanage 9.3.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет создавать и удалять сеансы в OpenManage Enterprise и OpenManage Enterprise Modular.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path path	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.
hostname string	IP-адрес или имя хоста OpenManage Enterprise.
password string	Пароль OpenManage Enterprise. Если пароль не указан, используется переменная среды `OME_PASSWORD`. password является обязательным, если state имеет значение `present`.
port integer	Порт OpenManage Enterprise. По умолчанию: `443`
session_id string	Идентификатор сеанса OpenManage Enterprise. session_id является обязательным, если state имеет значение `absent`.
state string	Состояние сеанса в OpenManage Enterprise. `present` создает сеанс. `absent` удаляет сеанс. Если значение state равно `present`, модуль всегда сообщает об обнаруженных изменениях, которые необходимо применить. Возможные значения: `"present"` ← (по умолчанию) `"absent"`
timeout integer	Тайм-аут на уровне сокета HTTPS в секундах. По умолчанию: `30`
username string	Имя пользователя OpenManage Enterprise. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. username является обязательным, если state имеет значение `present`.
validate_certs boolean	Если задано значение `false`, SSL-сертификаты не проверяются. Настраивайте `false` только на сайтах под личным управлением, где используются самоподписанные сертификаты. Возможные значения: `false` `true` ← (по умолчанию)
x_auth_token псевдонимы: auth_token string	Токен аутентификации. x_auth_token является обязательным, если state имеет значение `absent`.

Примечания

Примечание

Запускайте этот модуль в системе, имеющей прямой доступ к Dell OpenManage Enterprise.
Этот модуль поддерживает адреса IPv4 и IPv6.
Этот модуль поддерживает check_mode.
Если значение state равно present, модуль всегда сообщает об обнаруженных изменениях, которые необходимо применить.

Примеры

---
- name: Create a session
  dellemc.openmanage.ome_session:
    hostname: 198.162.0.1
    username: username
    password: password
    ca_path: "/path/to/ca_cert.pem"
    state: present

- name: Delete a session
  dellemc.openmanage.ome_session:
    hostname: 198.162.0.1
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    x_auth_token: aed4aa802b748d2f3b31deec00a6b28a
    session_id: 4b48e9ab-809e-4087-b7c4-201a16e0143d

- name: Create a session and execute other modules
  block:
    - name: Create a session
      dellemc.openmanage.ome_session:
        hostname: 198.162.0.1
        username: username
        password: password
        ca_path: "/path/to/ca_cert.pem"
        state: present
        register: authData

    - name: Call ome_user_info module
      dellemc.openmanage.ome_user_info:
        hostname: 198.162.0.1
        ca_path: "/path/to/ca_cert.pem"
        x_auth_token: "{{ authData.x_auth_token }}"

    - name: Call ome_network_vlan_info module
      dellemc.openmanage.ome_network_vlan_info:
        hostname: 198.162.0.1
        ca_path: "/path/to/ca_cert.pem"
        x_auth_token: "{{ authData.x_auth_token }}"
  always:
    - name: Destroy a session
      dellemc.openmanage.ome_session:
        hostname: 198.162.0.1
        ca_path: "/path/to/ca_cert.pem"
        state: absent
        x_auth_token: "{{ authData.x_auth_token }}"
        session_id: "{{ authData.session_data.Id }}"

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

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

Ключ	Описание
error_info dictionary	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the operation because an invalid username and/or password is entered, and therefore authentication failed.", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "IDRAC.2.7.SYS415", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "Enter valid user name and password and retry the operation.", "Severity": "Warning"}], "code": "Base.1.12.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information"}}
msg string	Состояние операции с сеансом. Возвращается: всегда Пример: `"The session has been created successfully."`
session_data dictionary	Сведения о сеансе. Возвращается: при создании сеанса Пример: `{"Description": "admin", "DirectoryGroup": [], "Id": "d5c28d8e-1084-4055-9c01-e1051cfee2dd", "IpAddress": "100.198.162.0", "LastAccessedTimeStamp": "2023-07-03 07:22:43.683", "Name": "API", "Password": null, "Roles": ["BACKUP_ADMINISTRATOR"], "StartTimeStamp": "2023-07-03 07:22:43.683", "UserId": 10078, "UserName": "admin"}`
x_auth_token string	Токен аутентификации. Возвращается: при создании сеанса Пример: `"d15f17f01cd627c30173b1582642497d"`

Авторы

Kritika Bhateja (@Kritika-Bhateja-03)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/openmanage/ome_session_module.html