VhL4ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z ddl mZddlmZmZdd lmZmZdd lmZd Zd Zd ZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'iZ(dZ)dZ*dZ+d+dZ,d Z-d!Z.d"Z/d#Z0d$Z1d%Z2d&Z3d'Z4d(Z5d)Z6e7d*k(re6yy),)absolute_importdivisionprint_functionaX --- module: redfish_powerstate short_description: Manage device power state version_added: "2.1.0" description: - This module allows to manage the different power states of the specified device. extends_documentation_fragment: - dellemc.openmanage.redfish_auth_options options: resource_id: description: - This option is the unique identifier of the device being managed. For example, U(https:///redfish/v1/Systems/). - This option is mandatory for I(base_uri) with multiple devices. - To get the device details, use the API U(https:///redfish/v1/Systems) for reset_type operation and U(https:///redfish/v1/Chassis) for oem_reset_type operation. required: false type: str reset_type: description: - This option resets the device. - C(ForceOff) turns off the device immediately. - C(ForceOn) turns on the device immediately. - C(ForceRestart) turns off the device immediately, and then restarts the server. - C(GracefulRestart) performs graceful shutdown of the device, and then restarts the device. - C(GracefulShutdown) performs a graceful shutdown of the device, and then turns off the device. - C(Nmi) sends a diagnostic interrupt to the device. This option is usually a nonmaskable interrupt (NMI) on x86 systems. - C(On) turns on the device. - C(PowerCycle) performs a power cycle on the device. - C(PushPowerButton) simulates the pressing of a physical power button on the device. - I(reset_type) is mutually exclusive with I(oem_reset_type). - When a power control operation is performed, which is not supported on the device, an error message is displayed with the list of operations that can be performed. required: false type: str choices: ["ForceOff", "ForceOn", "ForceRestart", "GracefulRestart", "GracefulShutdown", "Nmi", "On", "PowerCycle", "PushPowerButton"] oem_reset_type: description: - This parameter initiates a complete Alternate Current (AC) power cycle of the server which is equivalent to disconnecting power cables using OEM API. - I(oem_reset_type) is mutually exclusive with I(reset_type). - If the value of 'final_power_state' is not provided, the default value is 'Off'. required: false type: dict version_added: 9.5.0 requirements: - "python >= 3.9.6" author: - "Sajna Shetty(@Sajna-Shetty)" - "Lovepreet Singh (@singh-lovepreet1)" notes: - Run this module from a system that has direct access to Redfish APIs. - This module supports C(check_mode). a\ --- - name: Manage power state of the first device dellemc.openmanage.redfish_powerstate: baseuri: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" reset_type: "On" - name: Manage power state of a specified device dellemc.openmanage.redfish_powerstate: baseuri: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" reset_type: "ForceOff" resource_id: "System.Embedded.1" - name: Perform AC Power Cycle with final power state On dellemc.openmanage.redfish_powerstate: baseuri: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" oem_reset_type: dell: final_power_state: "On" reset_type: "PowerCycle" - name: Perform AC Power Cycle with final power state Off dellemc.openmanage.redfish_powerstate: baseuri: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" oem_reset_type: dell: final_power_state: "Off" reset_type: "PowerCycle" a --- msg: description: Overall status of the reset operation. returned: always type: str sample: "Successfully performed the reset type operation 'On'." error_info: type: dict description: Details of the HTTP error. returned: on http error sample: { "error": { "@Message.ExtendedInfo": [ { "Message": "Unable to complete the operation because the resource /redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset entered in not found.", "MessageArgs": [ "/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset" ], "MessageArgs@odata.count": 1, "MessageId": "IDRAC.2.1.SYS403", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "Enter the correct resource and retry the operation. For information about valid resource, see the Redfish Users Guide available on the support site.", "Severity": "Critical" }, ], "code": "Base.1.5.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information" } } N)SSLError) LooseVersion)RedfishRedfishAnsibleModule)URLError HTTPError)ConnectionErrorzChanges found to be applied.zNo Changes found to be applied.z=/redfish/v1/Managers/iDRAC.Embedded.1?$select=FirmwareVersionz'{option}' is not supported. The supported values are {supported_oem_reset_type_values}. Enter the valid values and retry the operation.zNThe target device does not support the system reset feature using Redfish API.z#Invalid device Id '{0}' is providedz7.00.60zUnable to perform the Virtual AC power-cycle operation because the firmware version is not supported. The minimum supported firmware version is '{minimum_supported_firmware_version}'.zCNo changes found to be applied because system is in power ON state.z}The vendor is not supported. The supported vendors are '{supported_vendors}'. Enter the valid vendor and retry the operation.zHSuccessfully performed the full virtual server AC power-cycle operation.zSuccessfully performed the full virtual server AC power-cycle operation. Please wait a few minutes, the server will automatically power on.zhThe target device does not support a {0} operation.The acceptable values for device reset types are {1}.z#{0}OemChassis.ExtendedResetzpThe target device does not support '{0}' operation. The valid values of final power states for device are '{1}'.zLThe vendor is not specified. Enter the valid vendor and retry the operation.z`No reset type is specified for the target device. Enter the valid value and retry the operation.c`|d}|dd}|dd}tj|||dy)N PowerStatez#ComputerSystem.Resettarget!ResetType@Redfish.AllowableValues) power_uriallowable_enums current_state)powerstate_mapupdate)system_res_data action_datarrrs y/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/redfish_powerstate.pyfetch_powerstate_detailsrsG#L1M34X>I!"9:;^_OOVcdfc|jd}|jd}tt|d}|jd}||j t dt j|j}d}||j|}||j t dd} d} d} |3|jd} |jd} |jd} tj| | || d y) Nroem_reset_typeOemTmsgskippedrrz'FinalPowerState@Redfish.AllowableValues)rrrallowable_power_state) getparamsnextiter exit_jsonTARGET_DEVICE_NOT_SUPPORTED OEM_RESET_KEYformat capitalizerr) modulesystem_id_res_data action_id_resrrcurrent_vendor oem_key_respsub_key sub_oem_keyrrallowable_final_power_states rfetch_ac_powerstate_detailsr3s &**<8M]]#34N$~.5N $$U+L8$G"">#<#<#>?GK"&&w/ 8$GIO"&OOH- %//*MN&1oo6_&`#O*E` bcrcZ|jjd}||vrf|jd|}|j}|jd}|r|r t ||yt |||y|j tdy|j tj|dy)N reset_typeGETActionsTr) r#r"invoke_request json_datarr3r&r'INVALID_DEVICE_IDr)) session_objr+ system_id_resresource_id_list resource_idr5system_id_res_respr,r-s rperform_uri_fetchr@s""<0J(((77}M/99*..y9 ();]K+F4F V   !t |dkDr0|Dcgc] }d|vs|d} }|xs| d} t||| | |y|jtd ycc}w#t$r@} | jd vr+|jttj| d | d} ~ wwxYw) Nr>z {0}{1}{2}/z{0}{1}r6Membersrz @odata.idTr)iir error_infofailed)r#r"r)root_urir8r9lenr@r&r'r codejsonload) r+r;reset_type_mapr>static_resource_id_resource system_uri system_respsystem_members system_idr=r<errs rfetch_power_uri_resourcerSs9mm'' 6 &*# *5*<*<[=Q=QSadgSgit*u '__[%9%9>J !00 C $..229= c.1A5HVs9ZeirZr + 6s s7N;KA;NM k6=BRT_ `   !AZ[I.55ZVZV_V_`nVo6qIYt4(!DsCc|j|vr9tj|dj|}|j |dyy)NrmTrp)r*INVALID_PWR_ERRORr)rsr&)final_pwr_stateallowed_final_pwr_stater+r|s ris_valid_final_pwr_stater'sI!!#+BB%,,_diiH_>`a Yt4Crc|jdd}|jjd}|j|jk7r(|j t j |dyy)Nr6z /redfish/v1/Vendor)supported_vendorsTr)r8r9r"rtr&VENDOR_NOT_SUPPORTEDr))redfish_session_objr+vendorrO system_vendors ris_valid_vendorr-si%44UNKK))--h7M .188=8Ycgh/rc|jdt}|jjdd}t |t kr,|j tjt dyy)Nr6FirmwareVersion)"minimum_supported_firmware_versionTr) r8 FIRM_VER_URIr9r"r"MINIMUM_SUPPORTED_FIRMWARE_VERSIONr&UNSUPPORTED_FIRMWARE_MSGr))r+rrespredfish_firmware_versions rcheck_firmware_versionr4so  - -e\ BD#~~112CRH,-1SS5< ) :iin 88s?{734KLQOP[\`rr#G,-DEaHSI   D  9 9 s?:sA&D66 F)?AF$$F)cdddddgdddddd}t|dd g } |jd }|jd }t|j5}|r t||n&|r t ||n|j t d dddy#1swYyxYw#t$r:}|j t|tj|dYd}~yd}~wt$r&}|j t|dYd}~yd}~wttttt t"f$r&}|j t|dYd}~yd}~wt$$r&}|j t|dYd}~yd}~wwxYw)NFstr)requiredtype) r[rYr\r]r^r_rUr`rZ)rrchoicesdict)r>r5rT)rr5) argument_specsupports_check_modemutually_exclusiver5rrrD)r unreachablerp)r r#rrrr&rr rrJrKr IOError ValueErrorr TypeErrorr OSError Exception)specsr+r5r redfish_objrRs rmainrsf$)59#(%#ef(-f=  E" <=?F4]]<0 '78 V]] # D{&{F;)+v>  _d C  D D D OSX$))C.NN 9SX488 Z9ow O4SXd33 4SXd334sY3B!6B B!BB!B!! F*0C F+D  &F2E FFF__main__)N)8 __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrJrqsslr#ansible.module_utils.compat.versionrCansible_collections.dellemc.openmanage.plugins.module_utils.redfishrr +ansible.module_utils.six.moves.urllib.errorr r ansible.module_utils.urlsr rrrrvr'r:rrrrrrrur(rVENDOR_NOT_SPECIFIEDrrrr3r@rSrjr}rrrrrrrr__name__rrrs!CB 5 n( T" H <mK5/ 4N o9%."MdR[J. Getfc2R",4 55 ib v@::D4@ zFr