Vh ddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z ddl mZmZddlmZmZdd lmZmZdd lmZd Zd Zd ZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,d Z-d!Z.d"Z/d#Z0e1d$k(re0yy)%)absolute_importdivisionprint_functiona --- module: ome_profile short_description: Create, modify, delete, assign, unassign and migrate a profile on OpenManage Enterprise version_added: "3.1.0" description: "This module allows to create, modify, delete, assign, unassign, and migrate a profile on OpenManage Enterprise." extends_documentation_fragment: - dellemc.openmanage.ome_auth_options options: command: description: - C(create) creates new profiles. - "C(modify) modifies an existing profile. Only I(name), I(description), I(boot_to_network_iso), and I(attributes) can be modified." - C(delete) deletes an existing profile. - C(assign) Deploys an existing profile on a target device and returns a task ID. - C(unassign) unassigns a profile from a specified target and returns a task ID. - C(migrate) migrates an existing profile and returns a task ID. choices: [create, modify, delete, assign, unassign, migrate] default: create type: str name_prefix: description: - The name provided when creating a profile is used a prefix followed by the number assigned to it by OpenManage Enterprise. - This is applicable only for a create operation. - This option is mutually exclusive with I(name). type: str default: Profile name: description: - Name of the profile. - This is applicable for modify, delete, assign, unassign, and migrate operations. - This option is mutually exclusive with I(name_prefix) and I(number_of_profiles). type: str new_name: description: - New name of the profile. - Applicable when I(command) is C(modify). type: str number_of_profiles: description: - Provide the number of profiles to be created. - This is applicable when I(name_prefix) is used with C(create). - This option is mutually exclusive with I(name). - Openmanage Enterprise can create a maximum of 100 profiles. type: int default: 1 template_name: description: - Name of the template for creating the profile(s). - This is applicable when I(command) is C(create). - This option is mutually exclusive with I(template_id). type: str template_id: description: - ID of the template. - This is applicable when I(command) is C(create). - This option is mutually exclusive with I(template_name). type: int device_id: description: - ID of the target device. - This is applicable when I(command) is C(assign) and C(migrate). - This option is mutually exclusive with I(device_service_tag). type: int device_service_tag: description: - Identifier of the target device. - This is typically 7 to 8 characters in length. - Applicable when I(command) is C(assign), and C(migrate). - This option is mutually exclusive with I(device_id). - If the device does not exist when I(command) is C(assign) then the profile is auto-deployed. type: str description: description: Description of the profile. type: str boot_to_network_iso: description: - Details of the Share iso. - Applicable when I(command) is C(create), C(assign), and C(modify). type: dict suboptions: boot_to_network: description: Enable or disable a network share. type: bool required: true share_type: description: Type of network share. type: str choices: [NFS, CIFS] share_ip: description: IP address of the network share. type: str share_user: description: User name when I(share_type) is C(CIFS). type: str share_password: description: User password when I(share_type) is C(CIFS). type: str workgroup: description: User workgroup when I(share_type) is C(CIFS). type: str iso_path: description: Specify the full ISO path including the share name. type: str iso_timeout: description: Set the number of hours that the network ISO file will remain mapped to the target device(s). type: int choices: [1, 2, 4, 8, 16] default: 4 filters: description: - Filters the profiles based on selected criteria. - This is applicable when I(command) is C(delete) or C(unassign). - This supports suboption I(ProfileIds) which takes a list of profile IDs. - This also supports OData filter expressions with the suboption I(Filters). - See OpenManage Enterprise REST API guide for the filtering options available. - I(WARNING) When this option is used in case of C(unassign), task ID is not returned for any of the profiles affected. type: dict force: description: - Provides the option to force the migration of a profile even if the source device cannot be contacted. - This option is applicable when I(command) is C(migrate). type: bool default: false attributes: description: Attributes for C(modify) and C(assign). type: dict suboptions: Attributes: description: - List of attributes to be modified, when I(command) is C(modify). - List of attributes to be overridden when I(command) is C(assign). - "Use the I(Id) If the attribute Id is available. If not, use the comma separated I (DisplayName). For more details about using the I(DisplayName), see the example provided." type: list elements: dict Options: description: - Provides the different shut down options. - This is applicable when I(command) is C(assign). type: dict Schedule: description: - Schedule for profile deployment. - This is applicable when I(command) is C(assign). type: dict requirements: - "python >= 3.9.6" author: "Jagadeesh N V (@jagadeeshnv)" notes: - Run this module from a system that has direct access to Dell OpenManage Enterprise. - This module supports C(check_mode). - C(assign) operation on a already assigned profile will not redeploy. a3 --- - name: Create two profiles from a template dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" template_name: "template 1" name_prefix: "omam_profile" number_of_profiles: 2 - name: Create profile with NFS share dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: create template_name: "template 1" name_prefix: "omam_profile" number_of_profiles: 1 boot_to_network_iso: boot_to_network: true share_type: NFS share_ip: "192.168.0.1" iso_path: "path/to/my_iso.iso" iso_timeout: 8 - name: Create profile with CIFS share dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: create template_name: "template 1" name_prefix: "omam_profile" number_of_profiles: 1 boot_to_network_iso: boot_to_network: true share_type: CIFS share_ip: "192.168.0.2" share_user: "username" share_password: "password" workgroup: "workgroup" iso_path: "\\path\\to\\my_iso.iso" iso_timeout: 8 - name: Modify profile name with NFS share and attributes dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: modify name: "Profile 00001" new_name: "modified profile" description: "new description" boot_to_network_iso: boot_to_network: true share_type: NFS share_ip: "192.168.0.3" iso_path: "path/to/my_iso.iso" iso_timeout: 8 attributes: Attributes: - Id: 4506 Value: "server attr 1" IsIgnored: false - Id: 4507 Value: "server attr 2" IsIgnored: false # Enter the comma separated string as appearing in the Detailed view on GUI # System -> Server Topology -> ServerTopology 1 Aisle Name - DisplayName: 'System, Server Topology, ServerTopology 1 Aisle Name' Value: Aisle 5 IsIgnored: false - name: Delete a profile using profile name dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "delete" name: "Profile 00001" - name: Delete profiles using filters dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "delete" filters: SelectAll: true Filters: =contains(ProfileName,'Profile 00002') - name: Delete profiles using profile list filter dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "delete" filters: ProfileIds: - 17123 - 16124 - name: Assign a profile to target along with network share dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: assign name: "Profile 00001" device_id: 12456 boot_to_network_iso: boot_to_network: true share_type: NFS share_ip: "192.168.0.1" iso_path: "path/to/my_iso.iso" iso_timeout: 8 attributes: Attributes: - Id: 4506 Value: "server attr 1" IsIgnored: true Options: ShutdownType: 0 TimeToWaitBeforeShutdown: 300 EndHostPowerState: 1 StrictCheckingVlan: true Schedule: RunNow: true RunLater: false - name: Unassign a profile using profile name dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "unassign" name: "Profile 00003" - name: Unassign profiles using filters dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "unassign" filters: SelectAll: true Filters: =contains(ProfileName,'Profile 00003') - name: Unassign profiles using profile list filter dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "unassign" filters: ProfileIds: - 17123 - 16123 - name: Migrate a profile dellemc.openmanage.ome_profile: hostname: "192.168.0.1" username: "username" password: "password" ca_path: "/path/to/ca_cert.pem" command: "migrate" name: "Profile 00001" device_id: 12456 a --- msg: description: Overall status of the profile operation. returned: always type: str sample: "Successfully created 2 profile(s)." profile_ids: description: IDs of the profiles created. returned: when I(command) is C(create) type: list sample: [1234, 5678] job_id: description: - Task ID created when I(command) is C(assign), C(migrate) or C(unassign). - C(assign) and C(unassign) operations do not trigger a task if a profile is auto-deployed. returned: when I(command) is C(assign), C(migrate) or C(unassign) type: int sample: 14123 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": "GEN1234", "RelatedProperties": [], "Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "Severity": "Critical", "Resolution": "Retry the operation. If the issue persists, contact your system administrator." } ] } } N)SSLError)RestOMEOmeAnsibleModule)URLError HTTPError)ConnectionErrorSSLValidationError)recursive_diffzProfileService/ProfileszTemplateService/TemplateszDeviceService/DeviceszJobService/Jobs({job_id})z.ProfileService/Actions/ProfileService.{action}z6ProfileService/Profiles({profile_id})/AttributeDetailsz)Profile with the name '{name}' not found.zChanges found to be applied.zNo changes found to be applied.,c|jjd}ddj|i}d}|s0|jjd}ddj|i}d}|jdt| }|j rV|j jd r;|j jd g}|D]}|j||k(s|cS|jd j|| y) N template_id$filter Id eq {0}Id template_namez Name eq '{0}'NameGET query_paramvaluez"Template with {0} '{1}' not found.msg)paramsgetformatinvoke_request TEMPLATE_VIEWsuccess json_data fail_jsonmodulerest_objidrsrchresptlistxtypes r/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/openmanage/plugins/modules/ome_profile.pyget_template_detailsr-s   = )Bk0045K D ]]   / /"8"8"<=   " "5-[ " QD ||**73""7B/ Eyy"$   =DDT2NOc|jjd}ddj|i}d}|s0|jjd}ddj|i}d}|jdt| }|j rV|j jd r;|j jd g}|D]}|j||k(s|cSd j||S) N device_idrrrdevice_service_tagzIdentifier eq '{0}' Identifierrrrz Target with {0} '{1}' not found.)rrrr DEVICE_VIEWr!r"r$s r,get_target_detailsr4s   ; 'Bk0045K D ]]  3 4 "7">">r"BC   " "5+; " OD ||**73""7B/ Eyy"$   . 4 4T2 >>r.c|jd}d}ddj|i}|jdt|}|jj dD]}|d|k(s |}|S|S) z/Get profile id based on requested profile name.nameNrzProfileName eq '{0}'rrr ProfileName)rrr PROFILE_VIEWr"r)r&r% profile_nameprofiler profile_reqeachs r, get_profiler=s==(LG4;;LIJK))%;)WK%%))'2  , .G  N  Nr.cF|jjd}i}|rddi}|jdrd|d<|jd}||d<i}|jd}||d <||d <|jd |d <|jd |d<|jd|d<||d<t|jdjj dr|jd|d<n|j d|jd|d<|S)Nboot_to_network_iso BootToNetworkFboot_to_networkT share_type ShareTypeshare_ip IpAddress ShareName share_userUsershare_passwordPassword workgroup WorkGroup ShareDetailiso_pathz.isoIsoPathz'ISO path does not have extension '.iso'r iso_timeout IsoTimeout)rrstrlowerendswithr#)r% boot_iso_dict iso_payloadrB share_detailsh_ips r,get_network_iso_payloadrYs8MM%%&;|j"r|jt$d|jd tj ||}|dd} |d k(rL t||}t'j(d|jd r|jd | d!<d"| d#<|jd%i| y#t$rd}YwxYw#t$rd$| d#<Y5wxYw)&Nr6rr6rTargetId ProfileStatez*The profile is assigned to the target {0}.zThe profile is assigned to a different target. Use the migrate command or unassign the profile and then proceed with assigning the profile to the target. AssignProfilez*Successfully applied the assign operation.POST!GetInvalidTargetsForAssignProfileactiondata3The target device is invalid for the given profile.r]OptionsScheduler0AssignProfileForAutoDeployz>Successfully applied the assign operation for auto-deployment.r1r2ru TargetNamez~The profile is assigned to a different target. Unassign the profile and then proceed with assigning the profile to the target.r]NetworkBootToIso attributesTrchangedDeploymentTaskIdjob_idz8Successfully triggered the job for the assign operation.rzGSuccessfully applied the assign operation. Failed to fetch job details.)rrr=r#PROFILE_NOT_FOUNDrr4r`dict exit_jsonrPROFILE_ACTIONrar"r rYr check_mode CHANGES_MSGtimesleep)r%r&mparampayloadproftargetrrr) ad_opts_listrUad_optsoptres_dictres_profs r,assign_profiler+s: ]]FG zz&8V,  JGDM   !2!9!9vzz&?Q!9!R  S  1F&$$Tl   1 $J6$</  %Q%X%XY_`dYe%f g  &w x : **6>3H3HPs3H3t15tDz0B+DDd|tDNN33  %Z [= ::k "     (-N & +? @   1 $L!W\%::  %Q%X%XY`amYn%o p  &w x$~ +F3M&3"#jj&G, w{{3' VXwT C";;s+GCL,[$7  " "6>+@+@+@+OV] " ^Dt,H   h"8V4H JJqM||./%-\\2D%E""\F x K D F hgHUO hs&AK?A K/ K,+K,/L?Lc|j}i}|jdri}t||}|r|ddk(r|jd|drm |j dt j |d}|j}|jd }|jd d k(r|jd |dg|d<n5|jtj |jd|jdr|jd}|jr|jtdd}|j dtj d}|dd} t||} tjd| jdr| jd| d<d| d<|jdi| y#t$rd }Y wxYw#t$rd| d<Y5wxYw)Nr6rrz"Profile is in an unassigned state.rrr)r LastRunStatusrRunningzCProfile deployment task is in progress. Wait for the job to finish.z;Unable to fetch job details. Applied the unassign operationr ProfileIdsrfiltersTrzBSuccessfully applied the unassign operation. No job was triggered.rUnassignProfilesrrrz8Successfully triggered a job for the unassign operation.rzYSuccessfully triggered a job for the unassign operation. Failed to fetch the job details.r)rrr=rrJOB_URIrr"r#r rrrrrr) r%r&rrrr)job_dict job_statusrrrs r,unassign_profilerls ]]F D zz&8V, N#q(  %I J&'X#225'..PTUgPh.:ijD#~~H!)o!>J!~~f-:((-r(s&*$ZLGL !   !2!9!9vzz&?Q!9!R  S zz)**Y' [$7 NC  " "6>+@+@HZ+@+[bi " jDt,Hvx0 1 <<* +!).@!AHX XHUOF x )!XWCX$ vuvs&A,G0A G  GG G10G1c|j}i}t||}|d|d<|jd|d<|d|d<|jdr|d|d<t|}|r||d <|jr|j t d |jd t| }|j}|j djt|d |y)Nr TemplateId name_prefix NamePrefixnumber_of_profilesNumberOfProfilesToCreate description DescriptionrTrrrz$Successfully created {0} profile(s).)rr profile_ids) rr-rrYrrrrr8r"rlen)r%r&rrtemplaterUr)profile_id_lists r,create_profilers ]]FG#FH5H$TNGL"JJ}5GL*01E*FG &' zz- !' !6 +F3M&3"# [$7  " "6Profile has to be in an unassigned state for it to be deleted.rTrDELETErrz!Successfully deleted the profile.rrrDeleterrz,Successfully completed the delete operation.) rrr=r#rrrrr8rrr)r%r&rrrs r,delete_profilers5 ]]F zz&8V, N#a'  %e f    [$ ?  # #HlW^^DQUJ=W.W X   !Dd  S   !2!9!9vzz&?Q!9!R  S zz)**Y'      d  ;(=(=X(=(NU\]KUYZ r.c&|j}i}|jd|d<t||}t|ts|j ||d|d<t ||}|rO|d|dk(r|jt |jdtjdd|di }|dt|jvr|j d |d d k(r|d|d <|jr|jt d|jdtjd| }d}|dd} t#j$dt ||} | jdr| jd|d<d|d<|jdi|y|j dy|j t&j|jdy#t$rd}YwxYw#t$rd|d<Y~wxYw)Nforce ForceMigraterrrrrrrrrr ProfileIdTrMigrateProfilez+Successfully applied the migrate operation.rrrz9Successfully triggered the job for the migrate operation.rzHSuccessfully applied the migrate operation. Failed to fetch job details.z@Profile needs to be in a deployed state for a migrate operation.r6rr)rrr4r`rr#r=rrrrrrar"r rrrrr) r%r&rrrrr)rrrs r,migrate_profilers! ]]FG$jj1GN  1F fd #V$ ,GJ x (D $<4 + +     0 **6>3H3HPs3H3t15tDz0B+DDd|tDNN33  %Z [  1 $#':GK     [$ ?**6>3H3HP`3H3aho*pD?C"t4H m 1 &x8<< 23)16H)IHX&&aHUO F   (x (   !c  d.556::f;M5NO+ D  m"l ms& AG-A G?- G<;G<?HHc|jjd}|dk(r t|||dk(r t|||dk(r t |||dk(r t |||dk(r t |||dk(r t||yy)Ncommandcreatemodifydeleteassignunassignmigrate)rrrrrrrr)r%r&rs r,profile_operationr smm *G(vx((vx((vx((vx(**))r.cddddddgiddiddiddd ddiddid d gd d d}dddddiddid}dgdddddddiddidd dddidd idd iddiddid|ddgdgddddgggdddid|dd ddd!}t|d"dd#d$gdgd"d%d&ggd"d%gd'dgd"d(d&ggd"d(d)d*gdgd"d+d&d,gdgd"d-d&d,gdgd"d.d&ggd"d.d)d*gdgg d&d/gd&d0gd&d,gd)d*gd#d$ggd1} t|jd25}t||dddy#1swYyxYw#t$r9}|j t |tj|3Yd}~yd}~wt$r&}|jt |d4Yd}~yd}~wtttttt t"f$r%}|j t |5Yd}~yd}~wwxYw)6NTbool)requiredtypechoicesNFSCIFSrrR)rno_logintr)rur)rdefaultr)rArBrDrGrIrKrNrPrar)relementsrr)rrrrrr)rrProfile)rrrurA)rBrDrNrBrGrI)roptions required_if)rrF)rrr6rrrrr0r1rr?rrrrrrrr6)rrrr?rr0r1rrrrrr) argument_specrmutually_exclusivesupports_check_mode) req_session)r error_info)r unreachabler)rrrrr r#rRjsonloadr rIOError ValueError TypeErrorrr r OSError)network_iso_spec assign_specspecsr%r&errs r,mainr s8d$e%16LJZ;[$\0" # F#%+>"F3' E, ?M"BD I 6( + "bdh i 6( + ;0D"Et L  VY$7 > 69"5t <  F8 ,  K1E#F M  ] # ) * Y  . / m , . !'"F(' V]] 5 0 fh / 0 0 0 BSX$))C.AA 9SX488 ZHoGY[b c'SX&&'sN D" C8/D8D=DD F> /E F> E..+F>F99F>__main__)2 __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNrrsslr?ansible_collections.dellemc.openmanage.plugins.module_utils.omerr+ansible.module_utils.six.moves.urllib.errorr r ansible.module_utils.urlsr r 0ansible.module_utils.common.dict_transformationsr r8r r3rrrvrrrrbr-r4r=rYrcrnrrrrrrrrr __name__rr.r,rsCB Z xu n' R eKIK( + % %AM?, 2 P"?" 4 9 #&R>!B$!N@(#)L[*&PR * ?'D zFr.