Vh%7 dZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z ddlmZdd lmZe j$d ZGd d e Zd ZGddZGddZGddZGddZGddZdZedk(reyy)zM Ansible module for managing Fault Sets on Dell Technologies (Dell) PowerFlex)absolute_importdivisionprint_functiona3 module: fault_set version_added: '2.2.0' short_description: Manage Fault Sets on Dell PowerFlex description: - Managing fault sets on PowerFlex storage system includes creating, getting details, renaming and deleting a fault set. author: - Carlos Tronco (@ctronco) - Trisha Datta (@trisha-dell) extends_documentation_fragment: - dellemc.powerflex.powerflex options: fault_set_name: description: - Name of the Fault Set. - Mutually exclusive with I(fault_set_id). type: str fault_set_id: description: - ID of the Fault Set. - Mutually exclusive with I(fault_set_name). type: str protection_domain_name: description: - Name of protection domain. - Mutually exclusive with I(protection_domain_id). type: str protection_domain_id: description: - ID of the protection domain. - Mutually exclusive with I(protection_domain_name). type: str fault_set_new_name: description: - New name of the fault set. type: str state: description: - State of the Fault Set. choices: ['present', 'absent'] default: 'present' type: str notes: - The I(check_mode) is supported. - When I(fault_set_name) is provided, I(protection_domain_name) or I(protection_domain_id) must be provided. ar - name: Create Fault Set on Protection Domain dellemc.powerflex.fault_set: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" fault_set_name: "{{ fault_set_name }}" protection_domain_name: "{{ pd_name }}" state: present - name: Rename Fault Set dellemc.powerflex.fault_set: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" fault_set_name: "{{ fault_set_name }}" fault_set_new_name: "{{ fault_set_new_name }}" state: present - name: Get details of a Fault Set dellemc.powerflex.fault_set: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" fault_set_id: "{{ fault_set_id }}" state: present - name: Delete Fault Set dellemc.powerflex.fault_set: hostname: "{{ hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: "{{ validate_certs }}" fault_set_id: "{{ fault_set_id }}" state: absent aC changed: description: Whether or not the resource has changed. returned: always type: bool sample: 'false' fault_set_details: description: Details of fault set. returned: always type: dict contains: protectionDomainId: description: Unique identifier of the protection domain. type: str protectionDomainName: description: Name of the protection domain. type: str name: description: Name of the fault set. type: str id: description: Unique identifier of the fault set. type: str SDS: description: List of SDS associated to the fault set. type: list elements: dict links: description: Fault set links. type: list contains: href: description: Fault Set instance URL. type: str rel: description: Relationship of fault set with different entities. type: str sample: { "protectionDomainId": "da721a8300000000", "protectionDomainName": "sample-pd", "name": "fs_001", "id": "eb44b70500000000", "links": [] } )utils) PowerFlexBase) Configuration) AnsibleModule fault_setc\eZdZdZfdZ d dZ d dZdZd dZdZ dZ d Z d Z xZ S)PowerFlexFaultSetzClass with FaultSet operationscddgddgg}ddgg}td||d}t| t|t di|_y ) z-Define all parameters required by this modulefault_set_name fault_set_idprotection_domain_nameprotection_domain_idT) argument_specsupports_check_modemutually_exclusiverequired_one_ofF)changedfault_set_detailsN)"get_powerflex_fault_set_parameterssuper__init__r dictresult)selfrransible_module_params __class__s o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/powerflex/plugins/modules/fault_set.pyrzPowerFlexFaultSet.__init__sk~ . %'= > -n=>@A#'"4. !  (=>   cdt|j|jj||S)zRGet the details of a protection domain in a given PowerFlex storage system)rr)rpowerflex_connmoduleget_protection_domain)rrrs r r%z'PowerFlexFaultSet.get_protection_domains6 T00$++>TT#9PdUf fr!cbt|j|jj|S)z`Get the details of SDS associated to given fault set in a given PowerFlex storage systemr)rr#r$get_associated_sds)rrs r r(z$PowerFlexFaultSet.get_associated_sdss1 T00$++>QQ%R' 'r!c |jjsDd|d|}tj||jj j |||j||S#t$rL}d|dt|}tj||jj|Yd}~yd}~wwxYw) a( Create Fault Set :param fault_set_name: Name of the fault set :type fault_set_name: str :param protection_domain_id: ID of the protection domain :type protection_domain_id: str :return: Boolean indicating if create operation is successful zCreating fault set with name: z on protection domain with id: )namerrrzCreate fault set z operation failed with error msgN) r$ check_modeLOGinfor#r create get_fault_set Exceptionstrerror fail_json)rrrr-e error_msgs r create_fault_setz"PowerFlexFaultSet.create_fault_sets 1;;))77GH55I4JL ##--44'>R5%%-%9&; ; 1,^,<=''*1vh0I IIi KK ! !i ! 0 0  1sA,A// C8AB??Ccft|j|jj|||S)aGet fault set details :param fault_set_name: Name of the fault set :param fault_set_id: Id of the fault set :param protection_domain_id: ID of the protection domain :return: Fault set details :rtype: dict )rrr)rr#r$r2)rrrrs r r2zPowerFlexFaultSet.get_fault_sets8T00$++>LL) [oMq qr!c&|d |d|dk7ryy)z0To get the details of the fields to be modified.fault_set_new_namer*TF)rrfault_set_paramss r is_rename_requiredz$PowerFlexFaultSet.is_rename_requireds* 0 1 = !56:KF:SSr!cL |jjs'|jjj |||j |S#t $rI}dt|}tj||jj|Yd}~yd}~wwxYw)z'Perform rename operation on a fault set)rr*r'z3Failed to rename the fault set instance with error r,N) r$r.r#r renamer2r3r4r/r5r6)rrnew_namer7r-s r rename_fault_setz"PowerFlexFaultSet.rename_fault_sets +;;))##--44!-!5#%%)&+ + +!!$Q*C IIcN KK ! !c ! * *  +sAA B#?BB#c |jjsTtjd||jj j |tjdy|j|S#t$rL}d|dt|}tj||jj|Yd}~yd}~wwxYw)zDelete the Fault SetzRemoving Fault Set r,zreturning NoneNr'z failed with error ) r$r.r/r0r#r deleter2r3r4r5r6)rrr7errormsgs r delete_fault_setz"PowerFlexFaultSet.delete_fault_sets 0;;))2<.AB##--44\B)*%%)&+ + 0,\N:McRSfXVH IIh  KK ! !h ! / / 0sA)A>,A>> CACCcV|d|dg}|D]U}|t|jdk(s#d}tj||jj |W|d@|d:|d4d}tj||jj |yyyy) Nrr<rzLProvide valid value for name for the creation/modification of the fault set.r,rrzHProvide protection_domain_id/protection_domain_name with fault_set_name.)lenstripr/r5r$r6)rr>paramsparamr8s r validate_parametersz%PowerFlexFaultSet.validate_parameterss"#346FG[6\] 5E S%71%<F  )$ %%)%4  5 , - 9 !78@EUVnEoEwbI IIi KK ! !i ! 0Fx@ :r!)NN)N)NNN)__name__ __module__ __qualname____doc__rr%r(r9r2r?rCrGrM __classcell__)rs@r r r sA( .AEf '16 q+" 0 1r!r c tttttttdddgS)zXThis method provide parameter required for the Ansible Fault Set module on PowerFlexpresentabsent)defaultchoices)rrrrr<state)rr=r!r rr-s9 vV#v!V69y(.CD  r!ceZdZdZy)FaultSetExitHandlerc ||jd<|rM|j|dd|jdd<|j|d|jdd<|jjd i|jy) NrprotectionDomainId)rr*protectionDomainNameidr'SDSr=)rr%r(r$ exit_json)r fault_set_objrs r handlezFaultSetExitHandler.handle;s4E 01 33):;O)P4RRXZ  !4 56L M00!24!81:  !4 5e < ' &&>)=)=>r!NrNrOrPrbr=r!r rZrZ:s ?r!rZceZdZdZy)FaultSetDeleteHandlerc|ddk(r%|r#|j|d}d|jd<tj||y)NrXrUr^Tr)rGrrZrb)rrar>rs r rbzFaultSetDeleteHandler.handleHsN G $ 05F - > >?PQU?V W .2M  +$$]4EFr!Nrcr=r!r rereGsGr!receZdZdZy)FaultSetRenameHandlerc|ddk(r>|r<|j||}|r(|j|d|d}d|jd<tj |||y)NrXrTr^r<)rrBTr)r?rCrrerb)rrar>rr?s r rbzFaultSetRenameHandler.handleQs{ G $ 16G!.!A!ABSUe!f !$1$B$BPabfPgL\]qLr%C%t!26 $$Y/&&}6FHYZr!Nrcr=r!r rhrhPs[r!rhceZdZdZy)FaultSetCreateHandlerc|ddk(r'|s%|j|d|}d|jd<tj|||y)NrXrTrr+Tr)r9rrhrb)rrar>rpd_ids r rbzFaultSetCreateHandler.handle]s\ G $ 1:K - > >N^_oNpTY!?![ .2M  +&&}6FHYZr!Nrcr=r!r rkrk\s[r!rkceZdZdZy)FaultSetHandlerc|j|d}|ds|dr|j|d|dd}|j|d|d|}tj ||||y) N)r>rr)rrr^rr)rrr)rMr%r2rkrb)rrar>rmrs r rbzFaultSetHandler.handlegs));K)L 2 37GH`7a!77%56L%M'78P'Q8SSWYE*77EUVdEeGWXhGiMR8T &&}6FHY[`ar!Nrcr=r!r rorofs br!roctt}tj||jjy)zf Create PowerFlex fault set object and perform action on it based on user input from playbook.N)r rorbr$rK)objs r mainrsts)  CS#**"3"34r!__main__N)rQ __future__rrrtype __metaclass__ DOCUMENTATIONEXAMPLESRETURNGansible_collections.dellemc.powerflex.plugins.module_utils.storage.dellr`ansible_collections.dellemc.powerflex.plugins.module_utils.storage.dell.libraries.powerflex_baser_ansible_collections.dellemc.powerflex.plugins.module_utils.storage.dell.libraries.configurationransible.module_utils.basicr get_loggerr/r rrZrerhrkrorsrNr=r!r rs T@@ / d' R/ d4e{#D1 D1N  ? ?GG [ [[[ b b5 zFr!