ansible / ansible.builtin / v2.9.26 / module / na_ontap_cifs NetApp ONTAP Manage cifs-share | "added in version" 2.6 of ansible.builtin" Authors: NetApp Ansible Team (@carchi8py) <ng-ansibleteam@netapp.com> preview | supported by certifiedansible.builtin.na_ontap_cifs (v2.9.26) — module
pip
Install with pip install ansible==2.9.26
Create or destroy or modify(path) cifs-share on ONTAP
- name: Create CIFS share na_ontap_cifs: state: present share_name: cifsShareName path: / vserver: vserverName share_properties: browsable,oplocks symlink_properties: read_only,enable hostname: "{{ netapp_hostname }}" username: "{{ netapp_username }}" password: "{{ netapp_password }}"
- name: Delete CIFS share na_ontap_cifs: state: absent share_name: cifsShareName vserver: vserverName hostname: "{{ netapp_hostname }}" username: "{{ netapp_username }}" password: "{{ netapp_password }}"
- name: Modify path CIFS share na_ontap_cifs: state: present share_name: pb_test vserver: vserverName path: / share_properties: show_previous_versions symlink_properties: disable vscan_fileop_profile: no_scan hostname: "{{ netapp_hostname }}" username: "{{ netapp_username }}" password: "{{ netapp_password }}"
path: description: The file system path that is shared through this CIFS share. The path is the full, user visible path relative to the vserver root, and it might be crossing junction mount points. The path is in UTF8 and uses forward slash as directory separator required: false https: default: false description: - Enable and disable https. - Ignored when using REST as only https is supported. - Ignored when using SSL certificate authentication as it requires SSL. type: bool state: choices: - present - absent default: present description: - Whether the specified CIFS share should exist or not. required: false ontapi: description: - The ontap api version to use type: int vserver: description: - Vserver containing the CIFS share. required: true hostname: description: - The hostname or IP address of the ONTAP instance. required: true type: str password: aliases: - pass description: - Password for the specified user. type: str use_rest: choices: - Never - Always - Auto default: Auto description: - REST API if supported by the target system for all the resources and attributes the module requires. Otherwise will revert to ZAPI. - Always -- will always use the REST API - Never -- will always use the ZAPI - Auto -- will try to use the REST Api type: str username: aliases: - user description: - This can be a Cluster-scoped or SVM-scoped account, depending on whether a Cluster-level or SVM-level API is required. - For more information, please read the documentation U(https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/). - Two authentication methods are supported - 1. basic authentication, using username and password, - 2. SSL certificate authentication, using a ssl client cert file, and optionally a private key file. - To use a certificate, the certificate must have been installed in the ONTAP cluster, and cert authentication must have been enabled. type: str http_port: description: - Override the default port (80 or 443) with this port type: int share_name: description: The name of the CIFS share. The CIFS share name is a UTF-8 string with the following characters being illegal; control characters from 0x00 to 0x1F, both inclusive, 0x22 (double quotes) required: true key_filepath: description: - path to SSL client key file. type: str version_added: 20.6.0 version_added_collection: netapp.ontap cert_filepath: description: - path to SSL client cert file (.pem). - not supported with python 2.6. type: str version_added: 20.6.0 version_added_collection: netapp.ontap feature_flags: description: - Enable or disable a new feature. - This can be used to enable an experimental feature or disable a new feature that breaks backward compatibility. - Supported keys and values are subject to change without notice. Unknown keys are ignored. type: dict version_added: 20.5.0 version_added_collection: netapp.ontap validate_certs: default: true description: - If set to C(no), the SSL certificates will not be validated. - This should only set to C(False) used on personally controlled sites using self-signed certificates. type: bool share_properties: description: - The list of properties for the CIFS share required: false version_added: '2.8' version_added_collection: ansible.builtin symlink_properties: description: - The list of symlink properties for this CIFS share required: false version_added: '2.8' version_added_collection: ansible.builtin vscan_fileop_profile: choices: - no_scan - standard - strict - writes_only description: - Profile_set of file_ops to which vscan on access scanning is applicable. required: false version_added: '2.9' version_added_collection: ansible.builtin