Vh[dZddlmZmZmZeZdZdZdZ ddl Z ddl Z ddl m Z mZmZd\ZZdd lmZmZdd lmZej2d Zgd ZgdZedd deeeeeeeZddgZddgZ dZ!Gdde"Z#dZ$dZ%dZ&dZ'dZ(dZ)d Z*d!Z+e,d"k(re+yy#e$rd e j&cZZYwxYw)#z/Ansible module for managing nfs export on Unity)absolute_importdivisionprint_functiona ( --- module: nfs version_added: '1.1.0' short_description: Manage NFS export on Unity storage system description: - Managing NFS export on Unity storage system includes- Create new NFS export, Modify NFS export attributes, Display NFS export details, Delete NFS export. extends_documentation_fragment: - dellemc.unity.unity author: - Vivek Soni (@v-soni11) options: nfs_export_name: description: - Name of the nfs export. - Mandatory for create operation. - Specify either I(nfs_export_name) or I(nfs_export_id) (but not both) for any operation. type: str nfs_export_id: description: - ID of the nfs export. - This is a unique ID generated by Unity storage system. type: str filesystem_name: description: - Name of the filesystem for which NFS export will be created. - Either filesystem or snapshot is required for creation of the NFS. - If I(filesystem_name) is specified, then I(nas_server) is required to uniquely identify the filesystem. - If filesystem parameter is provided, then snapshot cannot be specified. type: str filesystem_id: description: - ID of the filesystem. - This is a unique ID generated by Unity storage system. type: str snapshot_name: description: - Name of the snapshot for which NFS export will be created. - Either filesystem or snapshot is required for creation of the NFS export. - If snapshot parameter is provided, then filesystem cannot be specified. type: str snapshot_id: description: - ID of the snapshot. - This is a unique ID generated by Unity storage system. type: str nas_server_name: description: - Name of the NAS server on which filesystem will be hosted. type: str nas_server_id: description: - ID of the NAS server on which filesystem will be hosted. type: str path: description: - Local path to export relative to the NAS server root. - With NFS, each export of a file_system or file_snap must have a unique local path. - Mandatory while creating NFS export. type: str description: description: - Description of the NFS export. - Optional parameter when creating a NFS export. - To modify description, pass the new value in I(description) field. - To remove description, pass the empty value in I(description) field. type: str host_state: description: - Define whether the hosts can access the NFS export. - Required when adding or removing access of hosts from the export. type: str choices: ['present-in-export', 'absent-in-export'] anonymous_uid: description: - Specifies the user ID of the anonymous account. - If not specified at the time of creation, it will be set to 4294967294. type: int anonymous_gid: description: - Specifies the group ID of the anonymous account. - If not specified at the time of creation, it will be set to 4294967294. type: int state: description: - State variable to determine whether NFS export will exist or not. required: true type: str choices: ['absent', 'present'] default_access: description: - Default access level for all hosts that can access the NFS export. - For hosts that need different access than the default, they can be configured by adding to the list. - If I(default_access) is not mentioned during creation, then NFS export will be created with C(NO_ACCESS). type: str choices: ['NO_ACCESS', 'READ_ONLY', 'READ_WRITE', 'ROOT', 'READ_ONLY_ROOT'] min_security: description: - NFS enforced security type for users accessing a NFS export. - If not specified at the time of creation, it will be set to C(SYS). type: str choices: ['SYS', 'KERBEROS', 'KERBEROS_WITH_INTEGRITY', 'KERBEROS_WITH_ENCRYPTION'] adv_host_mgmt_enabled: description: - If C(false), allows you to specify hosts without first having to register them. - Mandatory while adding access hosts. type: bool no_access_hosts: description: - Hosts with no access to the NFS export. - List of dictionaries. Each dictionary will have any of the keys from I(host_name), I(host_id), I(subnet), I(netgroup), I(domain) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(true) then the accepted keys are I(host_name), I(host_id) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(false) then the accepted keys are I(host_name), I(subnet), I(netgroup), I(domain) and I(ip_address). type: list elements: dict suboptions: host_name: description: - Name of the host. type: str host_id: description: - ID of the host. type: str ip_address: description: - IP address of the host. type: str subnet: description: - Subnet can be an 'IP address/netmask' or 'IP address/prefix length'. type: str netgroup: description: - Netgroup that is defined in NIS or the local netgroup file. type: str domain: description: - DNS domain, where all NFS clients in the domain are included in the host list. type: str read_only_hosts: description: - Hosts with read-only access to the NFS export. - List of dictionaries. Each dictionary will have any of the keys from I(host_name), I(host_id), I(subnet), I(netgroup), I(domain) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(true) then the accepted keys are I(host_name), I(host_id) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(false) then the accepted keys are I(host_name), I(subnet), I(netgroup), I(domain) and I(ip_address). type: list elements: dict suboptions: host_name: description: - Name of the host. type: str host_id: description: - ID of the host. type: str ip_address: description: - IP address of the host. type: str subnet: description: - Subnet can be an 'IP address/netmask' or 'IP address/prefix length'. type: str netgroup: description: - Netgroup that is defined in NIS or the local netgroup file. type: str domain: description: - DNS domain, where all NFS clients in the domain are included in the host list. type: str read_only_root_hosts: description: - Hosts with read-only for root user access to the NFS export. - List of dictionaries. Each dictionary will have any of the keys from I(host_name), I(host_id), I(subnet), I(netgroup), I(domain) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(true) then the accepted keys are I(host_name), I(host_id) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(false) then the accepted keys are I(host_name), I(subnet), I(netgroup), I(domain) and I(ip_address). type: list elements: dict suboptions: host_name: description: - Name of the host. type: str host_id: description: - ID of the host. type: str ip_address: description: - IP address of the host. type: str subnet: description: - Subnet can be an 'IP address/netmask' or 'IP address/prefix length'. type: str netgroup: description: - Netgroup that is defined in NIS or the local netgroup file. type: str domain: description: - DNS domain, where all NFS clients in the domain are included in the host list. type: str read_write_hosts: description: - Hosts with read and write access to the NFS export. - List of dictionaries. Each dictionary will have any of the keys from I(host_name), I(host_id), I(subnet), I(netgroup), I(domain) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(true) then the accepted keys are I(host_name), I(host_id) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(false) then the accepted keys are I(host_name), I(subnet), I(netgroup), I(domain) and I(ip_address). type: list elements: dict suboptions: host_name: description: - Name of the host. type: str host_id: description: - ID of the host. type: str ip_address: description: - IP address of the host. type: str subnet: description: - Subnet can be an 'IP address/netmask' or 'IP address/prefix length'. type: str netgroup: description: - Netgroup that is defined in NIS or the local netgroup file. type: str domain: description: - DNS domain, where all NFS clients in the domain are included in the host list. type: str read_write_root_hosts: description: - Hosts with read and write for root user access to the NFS export. - List of dictionaries. Each dictionary will have any of the keys from I(host_name), I(host_id), I(subnet), I(netgroup), I(domain) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(true) then the accepted keys are I(host_name), I(host_id) and I(ip_address). - If I(adv_host_mgmt_enabled) is C(false) then the accepted keys are I(host_name), I(subnet), I(netgroup), I(domain) and I(ip_address). type: list elements: dict suboptions: host_name: description: - Name of the host. type: str host_id: description: - ID of the host. type: str ip_address: description: - IP address of the host. type: str subnet: description: - Subnet can be an 'IP address/netmask' or 'IP address/prefix length'. type: str netgroup: description: - Netgroup that is defined in NIS or the local netgroup file. type: str domain: description: - DNS domain, where all NFS clients in the domain are included in the host list. type: str notes: - The I(check_mode) is not supported. an - name: Create nfs export from filesystem dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" path: '/' filesystem_id: "fs_377" state: "present" - name: Create nfs export from snapshot dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_snap" path: '/' snapshot_name: "ansible_fs_snap" state: "present" - name: Modify nfs export dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" nas_server_id: "nas_3" description: "" default_access: "READ_ONLY_ROOT" anonymous_gid: 4294967290 anonymous_uid: 4294967290 state: "present" - name: Add host in nfs export with adv_host_mgmt_enabled as true dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" filesystem_id: "fs_377" adv_host_mgmt_enabled: true no_access_hosts: - host_id: "Host_1" read_only_hosts: - host_id: "Host_2" read_only_root_hosts: - host_name: "host_name1" read_write_hosts: - host_name: "host_name2" read_write_root_hosts: - ip_address: "1.1.1.1" host_state: "present-in-export" state: "present" - name: Remove host in nfs export with adv_host_mgmt_enabled as true dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" filesystem_id: "fs_377" adv_host_mgmt_enabled: true no_access_hosts: - host_id: "Host_1" read_only_hosts: - host_id: "Host_2" read_only_root_hosts: - host_name: "host_name1" read_write_hosts: - host_name: "host_name2" read_write_root_hosts: - ip_address: "1.1.1.1" host_state: "absent-in-export" state: "present" - name: Add host in nfs export with adv_host_mgmt_enabled as false dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" filesystem_id: "fs_377" adv_host_mgmt_enabled: false no_access_hosts: - domain: "google.com" read_only_hosts: - netgroup: "netgroup_admin" read_only_root_hosts: - host_name: "host5" read_write_hosts: - subnet: "168.159.57.4/255.255.255.0" read_write_root_hosts: - ip_address: "10.255.2.4" host_state: "present-in-export" state: "present" - name: Remove host in nfs export with adv_host_mgmt_enabled as false dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_from_fs" filesystem_id: "fs_377" adv_host_mgmt_enabled: false no_access_hosts: - domain: "google.com" read_only_hosts: - netgroup: "netgroup_admin" read_only_root_hosts: - host_name: "host5" read_write_hosts: - subnet: "168.159.57.4/255.255.255.0" read_write_root_hosts: - ip_address: "10.255.2.4" host_state: "absent-in-export" state: "present" - name: Get nfs details dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_id: "NFSShare_291" state: "present" - name: Delete nfs export by nfs name dellemc.unity.nfs: unispherehost: "{{unispherehost}}" username: "{{username}}" password: "{{password}}" validate_certs: "{{validate_certs}}" nfs_export_name: "ansible_nfs_name" nas_server_name: "ansible_nas_name" state: "absent" a changed: description: Whether or not the resource has changed. returned: always type: bool sample: "false" nfs_share_details: description: Details of the nfs export. returned: When nfs export exists. type: dict contains: anonymous_uid: description: User ID of the anonymous account type: int anonymous_gid: description: Group ID of the anonymous account type: int default_access: description: Default access level for all hosts that can access export type: str description: description: Description about the nfs export type: str id: description: ID of the nfs export type: str min_security: description: NFS enforced security type for users accessing an export type: str name: description: Name of the nfs export type: str no_access_hosts_string: description: Hosts with no access to the nfs export type: str read_only_hosts_string: description: Hosts with read-only access to the nfs export type: str read_only_root_hosts_string: description: Hosts with read-only for root user access to the nfs export type: str read_write_hosts_string: description: Hosts with read and write access to the nfs export type: str read_write_root_hosts_string: description: Hosts with read and write for root user access to export type: str type: description: NFS export type. i.e. filesystem or snapshot type: str export_paths: description: Export paths that can be used to mount and access export type: list filesystem: description: Details of the filesystem on which nfs export is present type: dict contains: UnityFileSystem: description: filesystem details type: dict contains: id: description: ID of the filesystem type: str name: description: Name of the filesystem type: str nas_server: description: Details of the nas server type: dict contains: UnityNasServer: description: NAS server details type: dict contains: id: description: ID of the nas server type: str name: description: Name of the nas server type: str sample: { 'anonymous_gid': 4294967294, 'anonymous_uid': 4294967294, 'creation_time': '2022-03-09 15:05:34.720000+00:00', 'default_access': 'NFSShareDefaultAccessEnum.NO_ACCESS', 'description': '', 'export_option': 1, 'export_paths': [ '**.***.**.**:/dummy-share-123' ], 'filesystem': { 'UnityFileSystem': { 'id': 'fs_id_1', 'name': 'fs_name_1' } }, 'host_accesses': None, 'id': 'NFSShare_14393', 'is_read_only': None, 'min_security': 'NFSShareSecurityEnum.SYS', 'modification_time': '2022-04-25 08:12:28.179000+00:00', 'name': 'dummy-share-123', 'nfs_owner_username': None, 'no_access_hosts': None, 'no_access_hosts_string': 'host1,**.***.*.*', 'path': '/', 'read_only_hosts': None, 'read_only_hosts_string': '', 'read_only_root_access_hosts': None, 'read_only_root_hosts_string': '', 'read_write_hosts': None, 'read_write_hosts_string': '', 'read_write_root_hosts_string': '', 'role': 'NFSShareRoleEnum.PRODUCTION', 'root_access_hosts': None, 'snap': None, 'type': 'NFSTypeEnum.NFS_SHARE', 'existed': true, 'nas_server': { 'UnityNasServer': { 'id': 'nas_id_1', 'name': 'dummy_nas_server' } } } N) ip_network IPv4Network IPv6Network)TNF) AnsibleModulemissing_required_lib)utilsnfs) NO_ACCESS READ_ONLY READ_WRITEROOTREAD_ONLY_ROOT)SYSKERBEROSKERBEROS_WITH_INTEGRITYKERBEROS_WITH_ENCRYPTIONlistdict) host_namehost_id ip_addresssubnetnetgroupdomain)typerequiredelementsoptionszpresent-in-exportzabsent-in-exportpresentabsentz Ansible/1.7.1ceZdZdZdZdZdZdZdZdZ dZ d Z d$d Z d Z d ZdZd%dZdZdZdZdZdZdZdZd&dZdZdZdZdZdZdZdZdZ d Z!d!Z"d"Z#d#Z$y )'NFSz Class with nfs export operationscdtj|_|jjt ddgddggdddgg}ddgg} t |jd|||_tj|j ts*|j jtdt tj|j jt|_|jj |_d |_|j jd s|j jd rd |_n9|j jds|j jdrd|_dddddd|_ddi|_t*j-dy )z. Define all parameters required by this module nfs_export_id nas_server_idnas_server_name) filesystem_idfilesystem_name snapshot_id snapshot_namenfs_export_nameF) argument_specsupports_check_modemutually_exclusiverequired_one_of ipaddress)msg exceptionNr+r*Tr-r,no_access_hosts_stringread_only_hosts_stringread_only_root_hosts_stringread_write_hosts_stringread_write_root_hosts_string)no_access_hostsread_only_hostsread_only_root_hostsread_write_hostsread_write_root_hostsrRO_ROOTz0Got the unity instance for provisioning on Unity)r $get_unity_management_host_parameters module_paramsupdateget_nfs_parametersr moduleensure_required_libs HAS_IPADDRESS fail_jsonr IP_ADDRESS_IMP_ERRget_unity_unisphere_connectionparamsapplication_typeunity_clicliis_given_nfs_for_fshost_param_mappingdefault_accessLOGinfo)selfr1r2s e/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/unity/plugins/modules/nfs.py__init__z NFS.__init__hs#GGI !!"4"67.@.0AB?.0AB D ,->?@-#,,%1+-  ""4;;/ KK ! !&:;&G,> " @99$++:L:L:JL ::??#' ;;  / 0 ;;  o .'+D $ [[   0 ""=1',D $ 87$A 9%C #  0; CDctjd}|jdrct|jd}|dvrEd|jdz}tj ||j j||jdrh|jd}t|}|dk(rG|j|s6d|z}tj ||j j||jd re|jd }|jd }t|d k7r4d }tj ||j j|y y y )zk Validate host access data :param host_dict: Host access data :return None zG(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)r)z.IP4/IP6: %s given in host_name instead of namer4rrz%s is not a valid FQDNr/zMSubnet should be in format 'IP address/netmask' or 'IP address/prefix length'N) recompilegetget_ip_versionrSerrorrErHmatchsplitlen)rU host_dictfqdn_patversionr4 ip_or_fqdnr subnet_infos rVvalidate_host_access_datazNFS.validate_host_access_datas> ::AB == %$Y]];%?@G&  ) k :; # %%#%. == &"|4J$Z0G!|HNN:$>.; # %%#%. == "]]8,F ,,s+K;1$e # %%#%.% #rXct|j}hd}hd}||z }||z }|jjdrD|tk7r7d|z}tj ||jj |y|jjdsE|tk7r7d|z}tj ||jj |yyy)zv Validate adv_host_mgmt_enabled check :param host_dict: Host access data :return None >rrr>rrrrradv_host_mgmt_enabledzHIf 'adv_host_mgmt_enabled' is true then host access should only have %sr\zIIf 'adv_host_mgmt_enabled' is false then host access should only have %sN)setkeysrErKrSrcrH)rUrghost_dict_keys_setadv_host_mgmt_enabled_true_setadv_host_mgmt_enabled_false_setadv_host_mgmt_enabled_true_diff adv_host_mgmt_enabled_false_diffr4s rV$validate_adv_host_mgmt_enabled_checkz(NFS.validate_adv_host_mgmt_enabled_checks !!12)O&*e'*E{{!!%($++2D2D 3"%)[[%7%7+&-04&5[^cc # %%#%.##E*!%!3!3E!:>I2;//2C I$!QqA II I==iH229=> >!Js 4 D/ ?D/ c"gd}|D]}|jj|st|jj|jdk(sQd|z}tj ||jj |y)zA Validate module attributes :return None )r.r'r+r*r(r-r,pathrz"Please provide valid value for: %sr\N)rErKrfstriprSrcrH)rU param_listrzr4s rVvalidate_module_attributeszNFS.validate_module_attributess{ >   /E{{!!%(4;;%%e,2245::UB # %%#%.  /rXc|jjdr/|jjds|jjds|jjdre|jjdsL|jjds3d}tj||jj ||jjdse|jjdsL|jjd s3d }tj||jj ||j |j y ) z Validate input parameters r.r-r,r+r(r)zLPlease provide nas server id or name along with filesystem name and nfs namer\r*z9Please provide either nas server id/name or filesystem idN)rErKrSrcrHrr}rUr4s rVvalidate_inputzNFS.validate_inputs ;;  / 0KK&&7KK&&}5##$56[[''8[[''(9:5 # %%#%.[[''8[[''(9:++O<& # %%#%. '') ..0rXc|jjdr|jjdS|jjdS)z Provide nfs_export_id or nfs_export_name user given value :return: value provided by user in nfs_export_id/nfs_export_name :rtype: str r'r.)rErK)rUs rVget_nfs_id_or_namezNFS.get_nfs_id_or_name sA ;;  o .;;%%o6 6{{!!"344rXctjd|jjds|jjdsy|jjdr|jjdn|jjd} |jj |jjd|jjd}r?|js3d }tj||jj|tjd |S#t j$rI}dt|z}tj||jj|Yd}~d}~wt j$rn}|jdk(rd |d t|}nd |d t|}tj||jj|Yd}~.d}~wt$rM}d |d t|}tj||jj|Yd}~d}~wwxYw)zb Get nas server object :return: nas server object :rtype: UnityNasServer zGetting nas server detailsr(r)N_idnamez$Given nas server not found error: %sr\zFailed to get nas server: + due to incorrect username/password error:  error: z+Please check nas details it does not existszGot nas server details)rSrTrErKrMget_nas_serverr UnityResourceNotFoundErrorstrrcrHHTTPClientError http_status Exceptionexisted)rU id_or_namenaser4s rVget_nas_from_given_inputzNFS.get_nas_from_given_inputs -.{{!!/2 ""#45 KK   /[[''859[[5G5G 6  +**++KK&&7[[''(9:,s1v%NOC HHSX $$ I}}#7A3q6K$BLADQI// N!+!%!3!3O!Dc!fNC E=G=@VEC EsOGJ& J&BJ&J&&N)9/K--N)2L::N)+N N) N$$N)cB tjd|j|jtjdy#t$rI}dt |z}tj ||jj|Yd}~yd}~wwxYw)zt Delete nfs share :param nfs: NFS share obj :type nfs: UnityNfsShare :return: None zDeleting nfs share: %szDeleted nfs sharez%Failed to delete nfs share, error: %sr\N) rSrTrdeleterrrcrErH)rUnfs_objrr4s rVdelete_nfs_sharezNFS.delete_nfs_sharesw + HH-t/F/F/H I NN  HH( ) +9CFBC IIcN KK ! !c ! * * +sA A B?BBc4|jjdr|jjd}nf|jjdr|jjd}n3d}tj||jj | |jjdr|j s3d}tj||jj |tj d|jj|jjd|j }nb|jjdrItj d|jj|jjd }r$|jrtj d|Sdz}tj||jj |y #tj$rL}d d t|}tj||jj |Yd }~d }~wtj$rL}|jd k(rdt|z}ndt|z}tj|Yd }~d }~wt$rM}ddt|}tj||jj |Yd }~hd }~wwxYw)z] Get filesystem obj :return: filesystem obj :rtype: UnityFileSystem r*r+z4Please provide filesystem ID/name, to get filesystemr\z,NAS Server is required to get the filesystemzGetting filesystem by name: %s)rrzGetting filesystem by ID: %srz Filesystem:  not found error: NrzEFailed to get filesystem due to incorrect username/password error: %sz"Failed to get filesystem error: %szFailed to get filesystem: rzGot the filesystem: %szFilesystem: %s does not exists)rErKrSrcrHrrTrMget_filesystemr rrrrrr)rUrr4err_msgrrs rVrzNFS.get_filesystemsg ;;  o .++OJHC IIcN KK ! !c ! * +{{!!"34||LGIIg&KK))g)69:F22++,=>#||3-##O47D22 **?;3=( fnn HH-z :M2Z?C IIcN KK ! !c ! *1// +CF$C IIcN KK ! !c ! * *$$ }}#469!f=;SVC IIcNN +CF$C IIcN KK ! !c ! * *  +s4DHLAI!!L7AJ>> L ALLcD|jjdr|jjd}nf|jjdr|jjd}n3d}tj||jj |tj d |rL|j j|jjd|jjd}n3d}tj||jj |r$|jrtj d||Sd|z}tj||jj |y #tj$rL}d|d t|}tj||jj |Yd }~d }~wtj$rL}|jd k(rd t|z}nd t|z}tj|Yd }~d }~wt$rM}d|d t|}tj||jj |Yd }~hd }~wwxYw)zS Get snapshot obj :return: Snapshot obj :rtype: UnitySnap r,r-z0Please provide snapshot ID/name, to get snapshotr\zGetting snapshot: %srz;Failed to get the snapshot. Please provide snapshot detailszFailed to get snapshot: rNrzCFailed to get snapshot due to incorrect username/password error: %sz Failed to get snapshot error: %sz!Successfully got the snapshot: %szSnapshot: %s does not exists)rErKrSrcrHrTrMget_snapr rrrrrr)rUrr4rrs rV get_snapshotzNFS.get_snapshots ;;  m ,++M:J [[   0++O  # %%#%.& (( HH8* EO0:=C IIcN KK ! !c ! *1// + d}d}|r|}|jj|}nA|r|}|jj|}n |r|}|jj|}|r.|jr"tj d|j |Sd|d}tj ||jj|y#t$rC}d d |}tj ||jj|Yd}~yd}~wwxYw) z Get host object :param host_id: ID of the host :param host_name: Name of the host :param ip_address: Network address of the host :return: Host object :rtype: object Nrr)addresszSuccessfully got host: %szHost : z does not existsr\zFailed to get host z , error: ) rMget_hostrrSrTrrcrErHr)rUrrrhost_objhostr4rs rV get_host_objzNFS.get_host_objs +HD::..7.; ::..I.>!::..z.BH,,4hmmDv%56 # %%#%. +'vYqc:C IIcN KK ! !c ! * * +sBC7C D9DDc|jdr.|j|jdjdzS|jdr|jddzS|jdr|jddzS|jdr|jddzS|jdrd|jdzdzS|jd rd |jd zdzSy ) z} Form host access string :host_dict Host access type info :return Host access data in string rr,rrrrz*.r@N)rarrrUrgs rVget_host_access_string_valuez NFS.get_host_access_string_value;s == #$$immI.F$HMMPSS S ]]; '=="# # ]]< (== #$ $ ]]8 $==  ]]8 $)--  ]]: &!" "'rXc0|jdr!|j|jdS|jdr!|j|jdS|jdr!|j|jdSy)z Form host access value using host object :host_dict Host access type info :return Host object rrr)rr)rN)rarrs rVget_host_obj_valuezNFS.get_host_obj_valueSs == #$$Y]]9-E$F F ]]; '$$y}}[/I$J J ]]< ($$ l0K$L L)rXczi}t|jjD]b}|jj|sg||<|jj|D]%}||j |j |'dd|vr|jd|d<d|vr|jd|d<|S)z Form host access for advance management :return: Formatted Host access type info :rtype: dict r=read_only_root_access_hostsr?root_access_hosts)rrQrprErKappendrpop)rU result_hostrzrgs rVformat_host_dict_for_adv_mgmtz!NFS.format_host_dict_for_adv_mgmt`s  $116689 RE{{!!%(%' E"!%!3!3E!:RI&--d.E.Ei.PQR R "[ 09DI_9`K5 6 "k 1/:?V/WK+ ,rXci}t|jjD][}|jj|sd||<|jj|D]}||xx|j |z cc< ]|ik7r3|j Dcic]\}}|j||dd}}}|Scc}}w)z Form host access for non advance management option :return: Formatted Host access type info :rtype: dict N)rrQrprErKrry)rUrrzrgr{r|s rV!format_host_dict_for_non_adv_mgmtz%NFS.format_host_dict_for_non_adv_mgmtss  $116689 WE{{!!%(%' E"!%!3!3E!:WI&$*K*KI*VV&W W " KVJ[J[J]^$!Q42215q"v=^K^_sB>ctjdi}|jjdr;|jjds|j }|S|j }|S)a+ Traverse all given hosts params and provides with host dict, which has respective host str param name with its value required by SDK :return: dict with key named as respective host str param name & value required by SDK :rtype: dict zGetting host parametersrxrn)rSrTrErKrr)rUrs rVget_host_dict_from_pbzNFS.get_host_dict_from_pbsg *+ ;;  l +;;%%&=>"DDF #@@B rXci}tjd|j}|r|j|d}|D]8}|jj ||jj |||<:|jj dru|jj dt jjvrBtjdt j|jj d|d<|jj dr|j|d<tjd||S)z Provide all the advance parameters named as required by SDK :return: all given advanced parameters :rtype: dict z#Getting all given advance parameter description anonymous_uid anonymous_gid min_securityz5Getting min_security object from NFSShareSecurityEnumrRz&Successfully got advance parameter: %s) rSrTrrCrErKr NFSShareSecurityEnum __members__get_default_access)rUrzrgfieldsfields rVget_adv_param_from_pbzNFS.get_adv_param_from_pbs"  67..0  LL #B 9E{{!!%(4#{{11%8e  9 ;;  n -$++2D2D3 #(#=#=#I#I3J HHL M$)$>$> "">2%4E. ! ;;  . /&*&=&=&?E" # 95A rXctjd|jj|jj d|jj d} t j|S#t$rK}d|dt|}tj||jj|Yd}~yd}~wwxYw)NzB B 'A(C IIcN KK ! !# & &  's!A44 C=ACCc|jj}t|jt|zr)|r |r |ddk7rd|d<d|vr|j d|d<|S)a Correct payload keys as required by SDK :param payload: Payload used for create/modify operation :type payload: dict :param nfs_details: NFS details :type nfs_details: dict :return: Payload required by SDK :rtype: dict export_optionr:root_access_hosts_string)rQvaluesrorpr)rUpayload nfs_detailsouput_host_params rVcorrect_payload_as_per_sdkzNFS.correct_payload_as_per_sdksv 2299; w||~ %5!6 6;;3OST3T+,(-87>kk27423rXc|jjd}|jjd}|r|s3d}tj||jj ||j }d|vr)|j d|d<tjd|j|}tjd| tjjd|j||j|d |}tjd ||S#tj$rM}tjt||jj t|Yd }~y d }~wt $rL}d |d t|}tj||jj |Yd }~y d }~wwxYw)zq Create nfs share from given filesystem :return: nfs_share object :rtype: UnityNfsShare r.r,Please provide name and path both for creater\rR share_accesszPParam name: 'share_access' is used instead of 'default_access' in SDK so changedz1Creating nfs share from filesystem with param: %s)rOrfsr"Successfully created nfs share: %sNFailed to create nfs share: r)rErKrSrcrHrrrTrr UnityNfsSharecreaterOrUnityNfsShareNameExistedErrorrrrUrrr4rzrrs rV create_nfs_share_from_filesystemz$NFS.create_nfs_share_from_filesystems{{!!"34{{!!&)4@C IIcN KK ! !c ! ***, u $$)II.>$?E. ! HH: ;//6 DeL +))00MHH4DKKdMFKMG HH97 CN22 . IIc!f  KK ! !c!f ! - - +@Dc!fMC IIcN KK ! !c ! * * +s'ADG2AE:: GAG  GcP|jjd}|jjd}|r|s3d}tj||jj ||j }|j |}tjd| tjjd |j||j|d|}tjd||S#tj$rM}tjt||jj t|Yd}~yd}~wt$rL}d |d t|}tj||jj |Yd}~yd}~wwxYw) zo Create nfs share from given snapshot :return: nfs_share object :rtype: UnityNfsShare r.rrr\z+Creating nfs share from snap with param: %s)rOrrrrNrrr)rErKrSrcrHrrrTr rcreate_from_snaprOrrrrrs rVcreate_nfs_share_from_snapshotz"NFS.create_nfs_share_from_snapshotsP{{!!"34{{!!&)4@C IIcN KK ! !c ! ***,//6 >F +))::QHH4dmm$QJOQG HH97 CN22 . IIc!f  KK ! !c!f ! - - +@Dc!fMC IIcN KK ! !c ! * * +s'"AC22F%AE  F%AF  F%c|jr|jS|jdur|jSd}tj ||j j |y)z{ Create nfs share from either filesystem/snapshot :return: nfs_share object :rtype: UnityNfsShare FzEPlease provide filesystem or filesystem snapshot to create NFS exportr\N)rPrrrSrcrErHrs rVcreate_nfs_sharezNFS.create_nfs_share!s^  # #88: :  % % .668 8YC IIcN KK ! !c ! *rXc|stjdgSg} |jdD]e}t|}|dk(rdj |}t |d}n#|dk(rdj |}t |d}|j|g |S#t$rM}d|d t|}tj||jj| Yd }~|Sd }~wwxYw) a7 Convert host_str which have comma separated hosts to host_list with ip4/ip6 host obj if IP4/IP6 like string found :param host_str: hosts str separated by comma :return: hosts list, which may contains IP4/IP6 object if given in host_str :rytpe: list zEmpty host_str givenrrZ{0}Fstrictr[z!Error while converting host_str: z to list error: r\N) rSdebugrerbformatrrrrrrcrErH)rUhost_str host_listhrirr4s rVconvert_host_str_to_listzNFS.convert_host_str_to_list2s II, -I  +^^C( $(+a< a(A#Ae4A\ a(A#Ae4A  # $  +#a&"C IIcN KK ! !c ! * *  +sA9B C/"AC**C/ci}|D]}tjd|||}|r!|stjd||||<A|dDcgc]}|j|dd}}|stjdtd|D}|Dcgc]}|j|vs|} }| stjd | j || ||<|Scc}wcc}w) a: Compares & adds up new hosts with the existing ones and provide the final consolidated hosts for advance host management :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be added :type new_host_dict: dict :return: consolidated hosts params details which contains newly added hosts along with the existing ones :rtype: dict zChecking for param: %sMExisting nfs host key: %s is empty, so lets add new host given value as it is UnityHostList UnityHostrrNothing to add as no host givenc34K|]}|jywNr).0rs rV z,NFS.add_host_dict_for_adv..psJ4twwJs+All host given to be added is already added)rSrrrorextend) rUexisting_host_dict new_host_dictmodify_host_dicthost_access_keynew_host_obj_listexisting_host_obj_list existing_setnew_host actual_to_adds rVadd_host_dict_for_advzNFS.add_host_dict_for_advQs21 >O II. @ -o >  );O)L ikz{4E 1ASSb@cds@t&v*<'+&7&7@RS^@_`d@e&7&f&v "&v% ;<J3IJJL6Gk(8;;^jKjXkMk  GH  !7 80= _ -5 >8 %&vlsC+C03C0ci}|D]}tjd|||}|j|}||}|j|}|stjd]|r|stjd||||<}tt |t |z } | stjd| j |dj d| D||<|S)a> Compares & adds up new hosts with the existing ones and provide the final consolidated hosts for non advance host management :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be added :type new_host_dict: dict :return: consolidated hosts params details which contains newly added hosts along with the existing ones :rtype: dict zChecking add host for param: %srrrrc32K|]}t|ywr rr r|s rVr z0NFS.add_host_dict_for_non_adv..s8WAQ8W)rSrrrrorjoin) rUrrrrexisting_host_strexisting_host_list new_host_str new_host_listrs rVadd_host_dict_for_non_advzNFS.add_host_dict_for_non_adv}s1 XO II7 I 2? C !%!>!>!"# )9L 99M! ;<%7 ikz{4@ 1 ]!3c:L6M!MNM  GH  !3 4 148W8W0W _ -A XB rXci}|D]Q}tjd||stjd5||dDcgc]}|j|dd}}||}|gk(rtjd|Dcgc]}|j}}t |t t |kDr9d|d |} tj | |jj| |D cgc]} | j} } tt |t | z} | s/|D cgc]} | j|vs| }} |||<T|Scc}wcc}wcc} wcc} w) a Compares & remove new hosts from the existing ones and provide the remaining hosts for advance host management :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be removed :type new_host_dict: dict :return: existing hosts params details from which given new hosts are removed :rtype: dict zChecking host for param: %s4Existing list is already empty, so nothing to removerrrr"Nothing to remove as no host givenDuplicate host given:  in host param: r\) rSrrrrfrorcrErHr)rUrrrrrrrunique_new_host_listr4runique_existing_host_listactual_to_remove existing_hostfinal_host_lists rVremove_host_dict_for_advzNFS.remove_host_dict_for_advs1 @O II3_ E%o6 PQASSb@cds@t&v*<'+&7&7@RS^@_`d@e&7&f&v "&v -o >  B& >?@Q#RHHKK#R #R$%C0D,E(FF./C.DDTUdTef # %%#%.=S(TT(T %(T#C(<$=)A+%+ , #BXJ\i\l\luI]I}JOJ0? _ -; @> 1&v$S )U JsE E!;E&8E+ E+cri}|D].}tjd|||}|j|}||}|j|}|stjd^t|tt |kDr9d|d|} tj | |j j| |r|stjdtt |t |z} | stt |t | z } djd| D||<1|S) a Compares & remove new hosts from the existing ones and provide the remaining hosts for non advance host management :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be removed :type new_host_dict: dict :return: existing hosts params details from which given new hosts are removed :rtype: dict z"Checking remove host for param: %sr'r(r)r\r&rc32K|]}t|ywr rrs rVr z3NFS.remove_host_dict_for_non_adv..s8YAQ8Yr) rSrrrfrorcrErHrr) rUrrrrr r!r"r#r4r,r.s rVremove_host_dict_for_non_advz NFS.remove_host_dict_for_non_advsD1$ ZO II:O L 2? C !%!>!>!"# )9L 99M! >?=!CM(:$;;!?4 # %%#%.%7 PQ#C $6":$%$ % #"3'9#:S >"$"#O 148Y8Y0Y _ -I$ ZL rXc|jjdr|j||}|S|j||}|S)a Compares & adds up new hosts with the existing ones and provide the final consolidated hosts :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be added :type new_host_dict: dict :return: consolidated hosts params details which contains newly added hosts along with the existing ones :rtype: dict rn)rErKrr$rUrrrs rVadd_hostz NFS.add_hostsP ;;  5 6#99:Lm\   $==>PR_` rXc|jjdr|j||}|S|j||}|S)a Compares & remove new hosts from the existing ones and provide the remaining hosts :param existing_host_dict: All hosts params details which are associated with existing nfs which to be modified :type existing_host_dict: dict :param new_host_dict: All hosts param details which are to be removed :type new_host_dict: dict :return: existing hosts params details from which given new hosts are removed :rtype: dict rn)rErKr/r2r4s rV remove_hostzNFS.remove_host(sQ ;;  5 6#<<=OQ^_   $@@ASUbc rXci}tjd|j}d}|D]X}|jj||jj|||k7s=|jj|||<Z|jjdr]|jjd|j j k7r-tj|jjd|d<|jjdr$|j}||jk7r||d<|j}|r] t|rM|jjds4d}tj||jj|nWt|rL|jjdr3d }tj||jj|tjd |D cic]} | ||  } } |jjd t$d k(r(tjd|j' |} n'tjd|j) |} | r|j+| |stjdd|fS|j-||} |j.di|} | j1d|j5|j6fScc} w#t $rJ} d t#| z}tj||jj|Yd} ~ Fd} ~ wwxYw#t2$rI} dt#| z}tj||jj|Yd} ~ d} ~ wwxYw)a3 Modify given nfs share :param nfs_obj: NFS share obj :type nfs_obj: UnityNfsShare :return: tuple(bool, nfs_obj) - bool: indicates whether nfs_obj is modified or not - nfs_obj: same nfs_obj if not modified else modified nfs_obj :rtype: tuple zModifying nfs sharerNrrRrnz|Modification of nfs host is restricted using adv_host_mgmt_enabled as false since nfs already have host added using host objr\z}Modification of nfs host is restricted using adv_host_mgmt_enabled as true since nfs already have host added without host objz$Extracting same given param from nfsz0Failed to extract key-value from current nfs: %srxrzGetting host to be addedzGetting host to be removedzdExisting nfs attribute value is same as given input, so returning same nfs object - idempotency caseFzFailed to modify nfs error: %sTr r)rSrT_get_propertiesrErKrrr rrrRris_nfs_have_host_with_host_objrcrH!is_nfs_have_host_with_host_stringrrHOST_STATE_LISTr5r7rCrmodify raise_if_errrrr)rUr modify_paramrrrrRrr4r{rrrresps rVmodify_nfs_sharezNFS.modify_nfs_share<s^  &'--/ B @E{{!!%(4KK&&u-U1CC&*kk&8&8&? U# @ ;;  n -$++2D2D3 #*#7#7#<#<3=+0+E+E "">2,4L ( ;;  . /!446N!7!771? -.224  /1+>t{{GYGYZqGrCCIIcNKK))c)26{C HZHZ[rHsECIIcNKK))c)2?@AN%OAaQ&7%O"%O{{!!,/?13EE34#'==1C]#S 56#'#3#34F #V ##$45 HHG H'> !66 +'  +!7>>1L1D     T''7::'666G&P /H!f # %%#%..  /: +2SV;C IIcN KK ! !c ! * * +sCCL L#L"M3L M0&?M++M03 O$/ 105-^W'r+ 5+n2+h!+F"0 M&($: ',$+L+B+">* X/ b- ^5 n ( (O7b1(rXr%ctjd|j}tjd|jj|ddd<d|ddvr|jj |ddd<tjd|jjd}|jj j|d d<||d<t|rStjd |jj |d d d<|jj|d d d<tjd |S)z Provide nfs share attributes for display :param nfs: NFS share obj :type nfs: UnityNfsShare :return: nfs_share_details :rtype: dict z/Getting nfs share details from nfs share objectzUpdating filesystem detailsrUnityFileSystemrrzUpdating nas server detailsrUnityNasServerzUpdating snap detailsr UnitySnapz&Successfully updated nfs share details) rSrTr9rrrris_nfs_obj_for_snapr)rrE nas_detailss rVrGrGsIHH >?//1HH *+l#$56v> $\23DEE    ! ! ,'(9:4@HH *+$$446|DK%%** !&)&1l#7# ()7>||&!+.t49@9J9J&!+.v6HH 56 rXc<d}|D]}|j|syy)z Check whether nfs host is already added using host obj :param nfs_details: nfs details :return: True if nfs have host already added with host obj else False :rtype: bool )r;r<rr>rTFrarhost_obj_paramshost_obj_params rVr:r:s.,O* ??> * rXc<d}|D]}|j|syy)z Check whether nfs host is already added using host by string method :param nfs_details: nfs details :return: True if nfs have host already added with host string method else False :rtype: bool )r6r7r8r9r:TFrVrWs rVr;r;s.O* ??> * rXcv dj|}t|d}|jS#t$rYywxYw)NrFrr)rrri ValueError)valips rVrbrb s=mmC  E *zz s ), 88cT|jtjjk(ryy)z Check whether the nfs_obj if for filesystem :param nfs_obj: NFS share object :return: True if nfs_obj is of filesystem type :rtype: bool TF)rr NFSTypeEnum NFS_SHARErs rVis_nfs_obj_for_fsrcs"||u((222 rXcT|jtjjk(ryy)z Check whether the nfs_obj if for snapshot :param nfs_obj: NFS share object :return: True if nfs_obj is of snapshot type :rtype: bool TF)rr r` NFS_SNAPSHOTrbs rVrSrSs"||u((555 rXc btd!idtdddtdddtdddtdddtddd tddd tddd tddd tddd dtdddtddtdtddtdtddddtdtdtdtdtdtddtdtdddtddd td dt S)"z@ Provides parameters required for the NFS share module on Unity r.Fr)rrr'r*r+r,r-r(r)rT)rrno_logrrR)rrchoicesrrnboolN)rrdefaultr;r<r=r>r?rxrintrrCr)rDEFAULT_ACCESS_LISTMIN_SECURITY_LIST HOST_DICTr<rFrrXrVrDrD*sr  e%8 E6 E6 e%8   %e4   E6  E6 e%8 5uT : %e4 U$79 5u"35 #EM  "! ""# $'% &#' (() *UOL+ ,E6- .E6/ 0DujA1 rXc8t}|jy)zZ Create UnityNFS object and perform action on it based on user input from playbookN)r%rJ)objs rVmainrqIs %C  "rX__main__)-rN __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNr_ tracebackr3rrrrGrI ImportError format_excansible.module_utils.basicr r Cansible_collections.dellemc.unity.plugins.module_utils.storage.dellr get_loggerrSrlrmrrnr<rFrLobjectr%rGr:r;rbrcrSrDrqrKrrXrVrsI 6@@ f P O b B F>>(2%M%Keu)1 fuv&*f)-%)V'+v%)V - . '(:; " "Y(&Y(x"!H  (  ># zFK(F(-/Cy/C/C/E%M%FsCC"!C"