Vh?ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z ddl mZmZddlmZdd lmZmZd Zd Zd Zd ZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*d Z+d!Z,d"Z-d#Z.d$Z/d%Z0e1d&k(re0yy)')absolute_importdivisionprint_functiona --- module: ome_groups short_description: Manages static device groups on OpenManage Enterprise description: This module allows to create, modify, and delete static device groups on OpenManage Enterprise. version_added: "3.5.0" author: - Jagadeesh N V(@jagadeeshnv) extends_documentation_fragment: - dellemc.openmanage.oment_auth_options options: state: type: str description: - C(present) allows to create or modify a device group. - C(absent) allows to delete a device group. choices: [present, absent] default: present name: type: list elements: str description: - Name of the device group to be created, modified, or deleted. - If I(state) is absent, multiple names can be provided. - This option is case insensitive. - This option is mutually exclusive with I(group_id). group_id: type: list elements: int description: - ID of the device group to be created, modified, or deleted. - If I(state) is absent, multiple IDs can be provided. - This option is mutually exclusive with I(name). new_name: type: str description: - New name for the existing device group. - This is applicable only when I(state) is C(present). description: type: str description: - Description for the device group. - This is applicable only when I(state) is C(present). parent_group_name: type: str default: "Static Groups" description: - Name of the parent device group under which the device group to be created or modified. - This is applicable only when I(state) is C(present). - C(NOTE) If device group with such a name does not exist, device group with I(parent_group_name) is created. - This option is case insensitive. - This option is mutually exclusive with I(parent_group_id). parent_group_id: type: int description: - ID of the parent device group under which the device group to be created or modified. - This is applicable only when I(state) is C(present). - This option is mutually exclusive with I(parent_group_name). requirements: - "python >= 3.9.6" notes: - This module manages only static device groups on Dell OpenManage Enterprise. - If a device group with the name I(parent_group_name) does not exist, a new device group with the same name is created. - Make sure the entered parent group is not the descendant of the provided group. - Run this module from a system that has direct access to Dell OpenManage Enterprise. - This module supports C(check_mode). aF --- - name: Create a new device group dellemc.openmanage.ome_groups: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" name: "group 1" description: "Group 1 description" parent_group_name: "group parent 1" - name: Modify a device group using the group ID dellemc.openmanage.ome_groups: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" group_id: 1234 description: "Group description updated" parent_group_name: "group parent 2" - name: Delete a device group using the device group name dellemc.openmanage.ome_groups: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" state: absent name: "group 1" - name: Delete multiple device groups using the group IDs dellemc.openmanage.ome_groups: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" state: absent group_id: - 1234 - 5678 a --- msg: type: str description: Overall status of the device group operation. returned: always sample: "Successfully deleted the device group(s)." group_status: description: Details of the device group operation status. returned: success type: dict sample: { "Description": "my group description", "Id": 12123, "MembershipTypeId": 12, "Name": "group 1", "ParentId": 12345, "TypeId": 3000, "IdOwner": 30, "CreatedBy": "admin", "CreationTime": "2021-01-01 10:10:10.100", "DefinitionDescription": "UserDefined", "DefinitionId": 400, "GlobalStatus": 5000, "HasAttributes": false, "UpdatedBy": "", "UpdatedTime": "2021-01-01 11:11:10.100", "Visible": true } group_ids: type: list elements: int description: List of the deleted device group IDs. returned: when I(state) is C(absent) sample: [1234, 5678] invalid_groups: type: list elements: str description: List of the invalid device group IDs or names. returned: when I(state) is C(absent) sample: [1234, 5678] error_info: description: Details of the HTTP Error. returned: on HTTP error type: dict sample: { "error": { "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information.", "@Message.ExtendedInfo": [ { "MessageId": "CGRP9013", "RelatedProperties": [], "Message": "Unable to update group 12345 with the provided parent 54321 because a group/parent relationship already exists.", "MessageArgs": [ "12345", "54321" ], "Severity": "Warning", "Resolution": "Make sure the entered parent ID does not create a bidirectional relationship and retry the operation." } ] } } N)SSLError)URLError HTTPError)ConnectionError)RestOMEOmeAnsibleModulezGroupService/Groupsz+GroupService/Actions/GroupService.{op}Groupz;Provide only one unique device group when state is present.z3A device group with the provided ID does not exist.z:A parent device group with the provided ID does not exist.zQThe provided parent device group is not a valid user-defined static device group.z2Provide valid static device group(s) for deletion.z3Provide valid static device group for modification.z=Unable to create a parent device group with the name {pname}.z$Successfully {op}d the device group.z8Provided parent and the device group cannot be the same.z[Unable to rename the group because a group with the provided name '{gname}' already exists.z)Successfully deleted the device group(s).zNo changes found to be applied.zChanges found to be applied.z Static Groupsc i}i}i}|jt}|jjddk(rct |jdDcgc]>}t ||j |vrt ||j |f@c}}n|jjd} | rd} nd} |jjd} d} |jdD]~}t ||j |vr|}| d z} t || j t | j k(r|}| d z} |dtk(r|}| d z} | d k(s~n|||fScc}w) Nstateabsentvalueparent_group_idIdNameparent_group_namer)get_all_items_with_pagination GROUP_URIparamsgetdictstrlower STATIC_ROOT) modulerest_obj group_arg group_setparent static_root group_dict group_respgpargpkeycounts q/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/ome_groups.pyget_valid_groupsr,s} FKJ77 BJ }}!X-:>>RYCZFa!!I,/5579D ) -335q9FG }}  !23 DD==$$%89D( A1Y< &&(I5  1T7|!!#s4y'88 yK'  z  v{ **-FsAE3c&|ddk(r |ddk(ryy)NTypeIdi MembershipTypeId TF)grps r+is_valid_static_groupr3s! 8}%7!8B!> c |}i}d|d<|jjd|d<|d|d<|jdtj d d |i }t |j S#t$r|dcYSwxYw) Nr0r/rrrParentIdPOSTCreateop GroupModeldata)rrinvoke_requestOP_URIformatint json_data Exception)r rr$prtpayloadprt_resps r+ create_parentrGs !&("# --++,?@!$i **66==H=3MUacjTk*l8%%&& !4  !sA-A00BBc|jjd}|rJ|s|jt|dtk7r!t |s|jt |dS|r2|dtk7r!t |s|jt |dS|jryt|||}tjt|S)Nrmsgrrr) rr fail_jsonNONEXIST_PARENT_IDrr3INVALID_PARENT check_moderGtimesleep SETTLING_TIME)r rr#r$ parent_idprtids r+ get_parent_idrTs !!"34I   !3  4 &>[ ((0  ^ 4d| f~,,V4$$$8$<   %h D =) r4ci} |jdtddj|i}|jj d}|r|d}|S#t $ri}Y|SwxYw)NGETz$filterz Name eq '{0}') query_paramrr)r>rr@rBrrC)r namer2respr&s r+get_ome_group_by_namerZ(sw C&&uiiQ`QgQghlQmEn&o^^''0 Q-C J  JsA A A A ci} |jdtdj|z}|j}|S#t$ri}Y|SwxYw)NrVz({0}))r>rr@rBrC)r idr2rYs r+get_ome_group_by_idr]4sW C&&ui'..:L.LMnn J  Js4: A A c|jdtj|d|i}t|j}t j t t||}|j|}|jdtj|j|y#t$r ||d<|}YIwxYw)Nr7r9r;r<rT)changedrJ group_status)r>r?r@rArBrOrPrQr]strip_substr_dictrC exit_jsonCREATE_SUCCESSr)rr rE operationr&cidr2groups r+exit_group_operationrg>s(()1LT`biSj(kJ j"" #CJJ}!(C0**3/ T~'<'< @Q'<'Rafg  sB..CCci}d|d<|j}|jdd|d<|jdj|djk(r|jtt ||||}||d<|jd r|jd |d <|j r|jd t t|||d y)Nr0r/rXrrrrIr6 description DescriptionTr_rJr8) rrrrKGROUP_PARENT_SAMErTrNrb CHANGES_FOUNDrg)r rr#r$rEmparamsrRs r+ create_grouproKsG"$G mmGkk&)!,GFO{{&'--/76?3H3H3JJ./h DI#GJ{{=!!(]!;  =97H=r4c t|s|jt|}d}tdDcgc]}||j |fc}}|j j d} | rF| |dk7r>t || } | r&|jtj| | |d<|dz }|j j d} | r| |d k7r | |d <|dz }t||||} | |d k(r|jt| |d k7r | |d <|dz }|dk(r(|j|} |jt| |jr|jd tt!|||dycc}w)NrIr)rrjr/r6rnew_namer)gnamerrirjrr6)rJr`TrkUpdate)r3rKINVALID_GROUPS_MODIFYrrrrZGROUP_NAME_EXISTSr@rTrlrarbNO_CHANGES_MSGrNrmrg)r rvalid_group_dictr#r$r2diffkrErqdup_grpdescrRgss r+ modify_groupr}[s !1 223 C D-jkQ OklG}}  ,H wv &+Hh?G  %6%=%=H%=%M N&GFO AID ==  ] +D 7=) )%)GM " AIDh DIGDM!./GJ'''    qy  ' ' ,^"= =97H=3lsE?cg}g}|D]^}|jt|j}|s.t|r|j |dN|j |`|r|j t ||jr|jdt||jdtjdd|i |jdt|y) Nr)rJinvalid_groupsT)r_rJ group_idsr7Deleter9GroupIdsr<)rrrr3appendrKINVALID_GROUPS_DELETErNrbrmr>r?r@DELETE_SUCCESS)r rr"r% deletablesinvalidsr'r2s r+ delete_groupsr|sJH #nnSV\\^, $S)!!#d)," #28L =JO FFMMXM$>jR\E]^ T~Lr4c dddddddddgddddiddidtd ddid }t|gd gd d gd gd} |jjdr.d}t d|jjdD}n-d}t d|jjdD}t |dk7r(|jddk(r|j tt|jd5}t||||\}}}|jddk(r'|rt|||||jtn;|rt|||||n|dk(r|j tt||||dddy#1swYyxYw#t $r9}|j t#|t%j&|Yd}~yd}~wt($r&}|jt#|dYd}~yd}~wt*t,t.t0t2t4t6t8t:f $r%}|j t#|Yd}~yd}~wwxYw)Nlistr)typeelementsrApresentr)rchoicesdefaultr)rr)rXgroup_idrrirqrr)rr)rqrirrT)rXr)rrT) argument_spec required_ifmutually_exclusiverequired_one_ofsupports_check_moderXrc3<K|]}|jywN)r.0vs r+ zmain..sI!AGGIIsrc3NK|]}t|jywr)rrrs r+rzmain..sRqCFLLNRs#%rrrrI) req_session)rJ error_info)rJ unreachable)rr rrsetlenrKMULTIPLE_GROUPS_MSGr r,rrbrvr}NONEXIST_GROUP_IDrorrjsonloadrIOError ValueErrorr TypeErrorr AttributeError IndexErrorKeyErrorOSError) specsrr!r"r rwr#r$errs r+mainrsBU3#7Y,AiXUO&+ D"E? E k  !"J ..  F' ==  V $IIv}}/@/@/HIIIIRFMM4E4Ej4QRRI y>Q 6==#9Y#F   !4  5 V]] 5 D4DVXW`bk4l 1 fk}}W%1#!(FI?OP  ^ 4# 63CV[Y$&$$):$;Xvv{C D D D BSX$))C.AA 9SX488 Z9o~Wackmt u'SX&&'sOCF>BFFFFF I#/G I#H5I9II__main__)2 __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrOsslr+ansible.module_utils.six.moves.urllib.errorrransible.module_utils.urlsr ?ansible_collections.dellemc.openmanage.plugins.module_utils.omer r rr?rrrLrMrrtPARENT_CREATION_FAILEDrcrlrurrvrmrrQr,r3rGrTrZr]rgror}rr__name__r1r4r+rsCB B H) VB H K5e ! 6SIQdLMX7Nq<2.   +> !2  h > >BM$1'h zFr4