Vh7%ddlmZmZmZeZdZdZdZddl Z ddl m Z ddl m Z mZddlmZmZdd lmZmZd d d d ddZdddddZgdZdZdZdZdZdZedk(reyy))absolute_importdivisionprint_functiona --- module: ome_powerstate short_description: Performs the power management operations on OpenManage Enterprise version_added: "2.1.0" description: This module performs the supported power management operations on OpenManage Enterprise. extends_documentation_fragment: - dellemc.openmanage.ome_auth_options options: power_state: description: Desired end power state. type: str required: true choices: ['on', 'off', 'coldboot', 'warmboot', 'shutdown'] device_service_tag: description: - Targeted device service tag. - I(device_service_tag) is mutually exclusive with I(device_id). type: str device_id: description: - Targeted device id. - I(device_id) is mutually exclusive with I(device_service_tag). type: int requirements: - "python >= 3.9.6" author: "Felix Stephen (@felixs88)" notes: - Run this module from a system that has direct access to Dell OpenManage Enterprise. - This module supports C(check_mode). a) --- - name: Power state operation based on device id dellemc.openmanage.ome_powerstate: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" device_id: 11111 power_state: "off" - name: Power state operation based on device service tag dellemc.openmanage.ome_powerstate: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" device_service_tag: "KLBR111" power_state: "on" - name: Power state operation based on list of device ids dellemc.openmanage.ome_powerstate: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" device_id: "{{ item.device_id }}" power_state: "{{ item.state }}" with_items: - { "device_id": 11111, "state": "on" } - { "device_id": 22222, "state": "off" } - name: Power state operation based on list of device service tags dellemc.openmanage.ome_powerstate: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" device_service_tag: "{{ item.service_tag }}" power_state: "{{ item.state }}" with_items: - { "service_tag": "KLBR111", "state": "on" } - { "service_tag": "KLBR222", "state": "off" } a% --- msg: type: str description: "Overall power state operation job status." returned: always sample: "Power State operation job submitted successfully." job_status: type: dict description: "Power state operation job and progress details from the OME." returned: success sample: { "Builtin": false, "CreatedBy": "user", "Editable": true, "EndTime": null, "Id": 11111, "JobDescription": "DeviceAction_Task", "JobName": "DeviceAction_Task_PowerState", "JobStatus": { "Id": 1111, "Name": "New" }, "JobType": { "Id": 1, "Internal": false, "Name": "DeviceAction_Task" }, "LastRun": "2019-04-01 06:39:02.69", "LastRunStatus": { "Id": 1112, "Name": "Running" }, "NextRun": null, "Params": [ { "JobId": 11111, "Key": "powerState", "Value": "2" }, { "JobId": 11111, "Key": "operationName", "Value": "POWER_CONTROL" } ], "Schedule": "", "StartTime": null, "State": "Enabled", "Targets": [ { "Data": "", "Id": 11112, "JobId": 11111, "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "UpdatedBy": null, "Visible": true } N)SSLError)RestOMEOmeAnsibleModule)URLError HTTPError)ConnectionErrorSSLValidationError  onoffcoldbootwarmbootshutdown)rr poweringon poweringoff)rrrcldi}}|jd||}|jdk(r |j}|S)z1Spawns an update job and tracks it to completion.zJobService/JobsPOST)data)invoke_request status_code json_data)rest_objpayloadjob_uri job_detailsjob_resps u/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/ome_powerstate.pyspawn_update_jobr+sA,b[G&&vwW&EHs"(( c fdddddddddd d d t|d gt|d |d ddgd}|S)z'Build the payload for requested device.rDeviceAction_Task_PowerStateDeviceAction_TaskstartnowEnabled)IdName operationName POWER_CONTROL)KeyValue powerStateDEVICE)r3Data TargetType)r3JobNameJobDescriptionScheduleStateJobTypeParamsTargets)strint) device_id device_type valid_optionr&s r*build_power_state_payloadrJsb1-%89*_E'#l2CDFy>2*5x#HJK G Nr,cd\}}}|dD].}|dt|k(s|jdd}|d}d}n|r!|jdj| |d vr|jd ||fS) z4Get the current state and device type from response.)NNT report_listr3 PowerStateNTypeFzWUnable to complete the operation because the entered target device id '{0}' is invalid.msg)iizXUnable to complete the operation because power state supports device type 1000 and 2000.)rFget fail_jsonformat)moduleresprG current_staterHinvalid_devicedevices r*get_device_staterYs1A.M;}% $<3y> )"JJ|T:M .K"N   <rsCB  @+ Z? B eKI21"RSTBbL="&$B:: zFr,