dellemc.openmanage.idrac_session module – Manage iDRAC sessions

Note

This module is part of the dellemc.openmanage collection (version 9.9.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install dellemc.openmanage. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: dellemc.openmanage.idrac_session.

New in dellemc.openmanage 9.2.0

Synopsis 

This module allows the creation and deletion of sessions on iDRAC.

Requirements 

The below requirements are needed on the host that executes this module.

python >= 3.9.6

Parameters 

Parameter	Comments
ca_path path	The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.
hostname aliases: idrac_ip string	IP address or hostname of the iDRAC.
password aliases: idrac_password string	Password of the iDRAC. If the password is not provided, then the environment variable `IDRAC_PASSWORD` is used. password is required when state is `present`.
port integer	Port of the iDRAC. Default: `443`
session_id integer	Session ID of the iDRAC. session_id is required when state is `absent`.
state string	The state of the session in an iDRAC. `present` creates a session. `absent` deletes a session. Module will always report changes found to be applied when state is `present`. Choices: `"present"` ← (default) `"absent"`
timeout integer	The https socket level timeout in seconds. Default: `30`
username aliases: idrac_user string	Username of the iDRAC. If the username is not provided, then the environment variable `IDRAC_USERNAME` is used. username is required when state is `present`.
validate_certs boolean	If `false`, the SSL certificates will not be validated. Configure `false` only on personally controlled sites where self-signed certificates are used. Choices: `false` `true` ← (default)
x_auth_token aliases: auth_token string	Authentication token. x_auth_token is required when state is `absent`.

Notes 

Note

Run this module from a system that has direct access to Dell iDRAC.
This module supports IPv4 and IPv6 addresses.
This module supports check_mode.
This module will always report changes found to be applied when state is present.

Examples 

---
- name: Create a session
  dellemc.openmanage.idrac_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.idrac_session:
    hostname: 198.162.0.1
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    x_auth_token: aed4aa802b748d2f3b31deec00a6b28a
    session_id: 2

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

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

    - name: Call idrac_user_info module
      dellemc.openmanage.idrac_user_info:
        idrac_ip: 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.idrac_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 }}"

Return Values 

Common return values are documented here, the following are the fields unique to this module:

Key	Description
error_info dictionary	Details of the HTTP Error. Returned: On HTTP error Sample: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the operation because an invalid username and/or password is entered, and therefore authentication failed.", "MessageArgs": [], "MessageId": "IDRAC.2.9.SYS415", "RelatedProperties": [], "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	Status of the session operation. Returned: always Sample: `"The session has been created successfully."`
session_data dictionary	The session details. Returned: For session creation operation Sample: {"@Message.ExtendedInfo": [{"Message": "The resource has been created successfully.", "MessageArgs": [], "MessageId": "Base.1.12.Created", "RelatedProperties": [], "Resolution": "None.", "Severity": "OK"}, {"Message": "A new resource is successfully created.", "MessageArgs": [], "MessageId": "IDRAC.2.9.SYS414", "RelatedProperties": [], "Resolution": "No response action is required.", "Severity": "Informational"}], "ClientOriginIPAddress": "100.96.37.58", "CreatedTime": "2024-04-05T01:14:01-05:00", "Description": "User Session", "Id": "74", "Name": "User Session", "Password": null, "SessionType": "Redfish", "UserName": "root"}
x_auth_token string	Authentication token. Returned: For session creation operation Sample: `"d15f17f01cd627c30173b1582642497d"`

Authors

Rajshekar P(@rajshekarp87)
Kritika Bhateja (@Kritika-Bhateja-03)

dellemc.openmanage.idrac_session module – Manage iDRAC sessions

Synopsis

Requirements

Parameters

Notes

Examples

Return Values