dellemc.openmanage.idrac_session module – Manage iDRAC sessions

Note

This module is part of the dellemc.openmanage collection (version 9.2.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

auth_token

string

Authentication token.

auth_token is required when state is absent.

ca_path

path

The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation.

hostname

string

IP address or hostname of the iDRAC.

password

string

Password of the iDRAC.

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

string

Username of the iDRAC.

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)

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
    state: present

- name: Delete a session
  dellemc.openmanage.idrac_session:
    hostname: 198.162.0.1
    state: absent
    auth_token: aed4aa802b748d2f3b31deec00a6b28a
    session_is: 2

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)