Vh."ddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl mZddlmZgd d ggd d gd ZdZedk(reyy))absolute_importdivisionprint_functionaa module: ocapi_command version_added: 6.3.0 short_description: Manages Out-Of-Band controllers using Open Composable API (OCAPI) description: - Builds OCAPI URIs locally and sends them to remote OOB controllers to perform an action. - Manages OOB controller such as Indicator LED, Reboot, Power Mode, Firmware Update. extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: category: required: true description: - Category to execute on OOB controller. type: str command: required: true description: - Command to execute on OOB controller. type: str baseuri: required: true description: - Base URI of OOB controller. type: str proxy_slot_number: description: For proxied inband requests, the slot number of the IOM. Only applies if O(baseuri) is a proxy server. type: int update_image_path: required: false description: - For O(command=FWUpload), the path on the local filesystem of the firmware update image. type: str job_name: required: false description: - For O(command=DeleteJob) command, the name of the job to delete. type: str username: required: true description: - Username for authenticating to OOB controller. type: str password: required: true description: - Password for authenticating to OOB controller. type: str timeout: description: - Timeout in seconds for URL requests to OOB controller. default: 10 type: int author: "Mike Moerk (@mikemoerk)" a' - name: Set the power state to low community.general.ocapi_command: category: Chassis command: PowerModeLow baseuri: "{{ baseuri }}" username: "{{ username }}" password: "{{ password }}" - name: Set the power state to normal community.general.ocapi_command: category: Chassis command: PowerModeNormal baseuri: "{{ baseuri }}" username: "{{ username }}" password: "{{ password }}" - name: Set chassis indicator LED to on community.general.ocapi_command: category: Chassis command: IndicatorLedOn baseuri: "{{ baseuri }}" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" - name: Set chassis indicator LED to off community.general.ocapi_command: category: Chassis command: IndicatorLedOff baseuri: "{{ baseuri }}" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" - name: Reset Enclosure community.general.ocapi_command: category: Systems command: PowerGracefulRestart baseuri: "{{ baseuri }}" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" - name: Firmware Upload community.general.ocapi_command: category: Update command: FWUpload baseuri: "iom1.wdc.com" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" update_image_path: "/path/to/firmware.tar.gz" - name: Firmware Update community.general.ocapi_command: category: Update command: FWUpdate baseuri: "iom1.wdc.com" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" - name: Firmware Activate community.general.ocapi_command: category: Update command: FWActivate baseuri: "iom1.wdc.com" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" - name: Delete Job community.general.ocapi_command: category: Jobs command: DeleteJob job_name: FirmwareUpdate baseuri: "{{ baseuri }}" proxy_slot_number: 2 username: "{{ username }}" password: "{{ password }}" a< msg: description: Message with action result or error description. returned: always type: str sample: "Action was successful" jobUri: description: URI to use to monitor status of the operation. Returned for async commands such as Firmware Update, Firmware Activate. returned: when supported type: str sample: "https://ioma.wdc.com/Storage/Devices/openflex-data24-usalp03020qb0003/Jobs/FirmwareUpdate/" operationStatusId: description: OCAPI State ID (see OCAPI documentation for possible values). returned: when supported type: int sample: 2 ) AnsibleModule) OcapiUtils) to_native)urljoin)IndicatorLedOnIndicatorLedOff PowerModeLowPowerModeNormalPowerGracefulRestart)FWUploadFWUpdate FWActivate DeleteJob)ChassisSystemsUpdateJobsci}tttdtddtdtddtdtdtdtddtdd  d }|jd }|jd }|jd|jdd}|jd}d|jdz}|jjd}t |||||}|t vr<|j td|dtt j|t |vr(|j td|dt ||dk(rI|jdr|j|}n%|jdr|j|}n|dk(r#|jdr|j|}n|dk(r{|d k(rJ|jjd!} | |j td"|j| }n|d#k(r|j}nn|d$k(ri|j}nX|d%k(rS|d&k(rN|jjd'} | |j d(t!|d)| z} |j#| }|d*d+ur|j t|d,y|d*=|jd-d} |jd.t} | | |j$sd/n|jd,d0d1}|Dcgc] }||vs| }}|D] }||||< |j&d2i|ycc}w)3NT)requiredstr)rtype)rint)rno_log )rdefault) categorycommandjob_namebaseuriproxy_slot_numberupdate_image_pathusernamepasswordtimeout) argument_specsupports_check_moderr r%r&)userpswdr'zhttps://r"r#zInvalid Category 'z'. Valid Categories = )msgzInvalid Command 'z'. Valid Commands = r IndicatorLed PowerModerPowerrrr$zMissing update_image_path.rrrrr!zMissing job_namezJobs/retFr,changedsessionzAction was successful.z"No action performed in check mode.)r1r2r,)rdictparamsgetrCATEGORY_COMMANDS_ALL fail_jsonrlistkeys startswithmanage_chassis_indicator_ledmanage_system_powerupload_firmware_imageupdate_firmware_imageactivate_firmware_imager delete_job check_mode exit_json)resultmodulerr credsr'base_urir# ocapi_utilsr$r!job_urir1r2kwargs result_key result_keyss s/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/ocapi_command.pymainrNs F 4($U3u%$U3".".4(45eR0  ! F}}Z(HmmI&G j) j) E mmI&GFMM)44H ))*=>UH.?&QK,,YYacgh}iCiCiEdF(GH I+H55YV]_tu}_~'A B9   n - ==gFF    , 44W=F Y    g & 44W=F X  j & 1 12E F  (  Y/K%L M 667HIF  " 668F  $ 88:F V  k !}}((4H  !34h((:;G ++G4F e}Yve}56 5M**Y-**Y/393D3D+&**;K 5;WjjPV>VzW W% 4J!' !3F:  4"6"Xs M<M<__main__N) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrFansible_collections.community.general.plugins.module_utils.ocapi_utilsr+ansible.module_utils.common.text.convertersr+ansible.module_utils.six.moves.urllib.parser r7rN__name__r3rMr[spA@ < |J X *5]A?X&'4 M T#n zFrZ