modules: fix examples to use FQCN (#644)

* modules: fix examples to use FQCN

* fix

* fix

* fix

plugins/modules/storage/emc/emc_vnx_sg_member.py

@@ -48,7 +48,7 @@ author:
 
 EXAMPLES = '''
 - name: Add lun to storage group
-  emc_vnx_sg_member:
+  community.general.emc_vnx_sg_member:
     name: sg01
     sp_address: sp1a.fqdn
     sp_user: sysadmin
@@ -57,7 +57,7 @@ EXAMPLES = '''
     state: present
 
 - name: Remove lun from storage group
-  emc_vnx_sg_member:
+  community.general.emc_vnx_sg_member:
     name: sg01
     sp_address: sp1a.fqdn
     sp_user: sysadmin

plugins/modules/storage/glusterfs/gluster_heal_info.py

@@ -35,7 +35,7 @@ requirements:
 
 EXAMPLES = '''
 - name: Gather self-heal facts about all gluster hosts in the cluster
-  gluster_heal_info:
+  community.general.gluster_heal_info:
     name: test_volume
     status_filter: self-heal
   register: self_heal_status
@@ -43,7 +43,7 @@ EXAMPLES = '''
     var: self_heal_status
 
 - name: Gather rebalance facts about all gluster hosts in the cluster
-  gluster_heal_info:
+  community.general.gluster_heal_info:
     name: test_volume
     status_filter: rebalance
   register: rebalance_status

plugins/modules/storage/glusterfs/gluster_peer.py

@@ -48,20 +48,20 @@ notes:
 
 EXAMPLES = '''
 - name: Create a trusted storage pool
-  gluster_peer:
+  community.general.gluster_peer:
         state: present
         nodes:
              - 10.0.1.5
              - 10.0.1.10
 
 - name: Delete a node from the trusted storage pool
-  gluster_peer:
+  community.general.gluster_peer:
          state: absent
          nodes:
               - 10.0.1.10
 
 - name: Delete a node from the trusted storage pool by force
-  gluster_peer:
+  community.general.gluster_peer:
          state: absent
          nodes:
               - 10.0.0.1

plugins/modules/storage/glusterfs/gluster_volume.py

@@ -87,7 +87,7 @@ author:
 
 EXAMPLES = """
 - name: Create gluster volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: test1
     bricks: /bricks/brick1/g1
@@ -98,14 +98,14 @@ EXAMPLES = """
   run_once: true
 
 - name: Tune
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: test1
     options:
       performance.cache-size: 256MB
 
 - name: Set multiple options on GlusterFS volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: test1
     options:
@@ -115,29 +115,29 @@ EXAMPLES = """
       }
 
 - name: Start gluster volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: started
     name: test1
 
 - name: Limit usage
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: test1
     directory: /foo
     quota: 20.0MB
 
 - name: Stop gluster volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: stopped
     name: test1
 
 - name: Remove gluster volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: absent
     name: test1
 
 - name: Create gluster volume with multiple bricks
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: test2
     bricks: /bricks/brick1/g2,/bricks/brick2/g2
@@ -147,7 +147,7 @@ EXAMPLES = """
   run_once: true
 
 - name: Remove the bricks from gluster volume
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: testvol
     bricks: /bricks/brick1/b1,/bricks/brick2/b2
@@ -157,7 +157,7 @@ EXAMPLES = """
   run_once: true
 
 - name: Reduce cluster configuration
-  gluster_volume:
+  community.general.gluster_volume:
     state: present
     name: testvol
     bricks: /bricks/brick3/b1,/bricks/brick4/b2

plugins/modules/storage/hpe3par/ss_3par_cpg.py

@@ -93,7 +93,7 @@ extends_documentation_fragment:
 
 EXAMPLES = r'''
 - name: Create CPG sample_cpg
-  ss_3par_cpg:
+  community.general.ss_3par_cpg:
     storage_system_ip: 10.10.10.1
     storage_system_username: username
     storage_system_password: password
@@ -110,7 +110,7 @@ EXAMPLES = r'''
     secure: no
 
 - name: Delete CPG sample_cpg
-  ss_3par_cpg:
+  community.general.ss_3par_cpg:
     storage_system_ip: 10.10.10.1
     storage_system_username: username
     storage_system_password: password

plugins/modules/storage/ibm/ibm_sa_domain.py

@@ -80,7 +80,7 @@ author:
 
 EXAMPLES = '''
 - name: Define new domain.
-  ibm_sa_domain:
+  community.general.ibm_sa_domain:
     domain: domain_name
     size: domain_size
     state: present
@@ -89,7 +89,7 @@ EXAMPLES = '''
     endpoints: hostdev-system
 
 - name: Delete domain.
-  ibm_sa_domain:
+  community.general.ibm_sa_domain:
     domain: domain_name
     state: absent
     username: admin

plugins/modules/storage/ibm/ibm_sa_host.py

@@ -59,7 +59,7 @@ author:
 
 EXAMPLES = '''
 - name: Define new host.
-  ibm_sa_host:
+  community.general.ibm_sa_host:
     host: host_name
     state: present
     username: admin
@@ -67,7 +67,7 @@ EXAMPLES = '''
     endpoints: hostdev-system
 
 - name: Delete host.
-  ibm_sa_host:
+  community.general.ibm_sa_host:
     host: host_name
     state: absent
     username: admin

plugins/modules/storage/ibm/ibm_sa_host_ports.py

@@ -52,7 +52,7 @@ author:
 
 EXAMPLES = '''
 - name: Add ports for host.
-  ibm_sa_host_ports:
+  community.general.ibm_sa_host_ports:
     host: test_host
     iscsi_name: iqn.1994-05.com***
     username: admin
@@ -61,7 +61,7 @@ EXAMPLES = '''
     state: present
 
 - name: Remove ports for host.
-  ibm_sa_host_ports:
+  community.general.ibm_sa_host_ports:
     host: test_host
     iscsi_name: iqn.1994-05.com***
     username: admin

plugins/modules/storage/ibm/ibm_sa_pool.py

@@ -55,7 +55,7 @@ author:
 
 EXAMPLES = '''
 - name: Create new pool.
-  ibm_sa_pool:
+  community.general.ibm_sa_pool:
     name: pool_name
     size: 300
     state: present
@@ -64,7 +64,7 @@ EXAMPLES = '''
     endpoints: hostdev-system
 
 - name: Delete pool.
-  ibm_sa_pool:
+  community.general.ibm_sa_pool:
     name: pool_name
     state: absent
     username: admin

plugins/modules/storage/ibm/ibm_sa_vol.py

@@ -47,7 +47,7 @@ author:
 
 EXAMPLES = '''
 - name: Create a new volume.
-  ibm_sa_vol:
+  community.general.ibm_sa_vol:
     vol: volume_name
     pool: pool_name
     size: 17
@@ -57,7 +57,7 @@ EXAMPLES = '''
     endpoints: hostdev-system
 
 - name: Delete an existing volume.
-  ibm_sa_vol:
+  community.general.ibm_sa_vol:
     vol: volume_name
     state: absent
     username: admin

plugins/modules/storage/ibm/ibm_sa_vol_map.py

@@ -58,7 +58,7 @@ author:
 
 EXAMPLES = '''
 - name: Map volume to host.
-  ibm_sa_vol_map:
+  community.general.ibm_sa_vol_map:
     vol: volume_name
     lun: 1
     host: host_name
@@ -68,7 +68,7 @@ EXAMPLES = '''
     state: present
 
 - name: Map volume to cluster.
-  ibm_sa_vol_map:
+  community.general.ibm_sa_vol_map:
     vol: volume_name
     lun: 1
     cluster: cluster_name
@@ -78,7 +78,7 @@ EXAMPLES = '''
     state: present
 
 - name: Unmap volume.
-  ibm_sa_vol_map:
+  community.general.ibm_sa_vol_map:
     host: host_name
     username: admin
     password: secret

plugins/modules/storage/netapp/na_cdot_aggregate.py

@@ -50,7 +50,7 @@ options:
 
 EXAMPLES = """
 - name: Manage Aggregates
-  na_cdot_aggregate:
+  community.general.na_cdot_aggregate:
     state: present
     name: ansibleAggr
     disk_count: 1
@@ -59,7 +59,7 @@ EXAMPLES = """
     password: "{{ netapp_password }}"
 
 - name: Manage Aggregates
-  na_cdot_aggregate:
+  community.general.na_cdot_aggregate:
     state: present
     name: ansibleAggr
     hostname: "{{ netapp_hostname }}"

plugins/modules/storage/netapp/na_cdot_license.py

@@ -96,7 +96,7 @@ options:
 
 EXAMPLES = """
 - name: Add licenses
-  na_cdot_license:
+  community.general.na_cdot_license:
     hostname: "{{ netapp_hostname }}"
     username: "{{ netapp_username }}"
     password: "{{ netapp_password }}"
@@ -110,7 +110,7 @@ EXAMPLES = """
       flexclone: #################
 
 - name: Remove licenses
-  na_cdot_license:
+  community.general.na_cdot_license:
     hostname: "{{ netapp_hostname }}"
     username: "{{ netapp_username }}"
     password: "{{ netapp_password }}"

plugins/modules/storage/netapp/na_cdot_lun.py

@@ -81,7 +81,7 @@ options:
 
 EXAMPLES = """
 - name: Create LUN
-  na_cdot_lun:
+  community.general.na_cdot_lun:
     state: present
     name: ansibleLUN
     flexvol_name: ansibleVolume
@@ -93,7 +93,7 @@ EXAMPLES = """
     password: "{{ netapp_password }}"
 
 - name: Resize Lun
-  na_cdot_lun:
+  community.general.na_cdot_lun:
     state: present
     name: ansibleLUN
     force_resize: True

plugins/modules/storage/netapp/na_cdot_qtree.py

@@ -51,7 +51,7 @@ options:
 
 EXAMPLES = """
 - name: Create QTree
-  na_cdot_qtree:
+  community.general.na_cdot_qtree:
     state: present
     name: ansibleQTree
     flexvol_name: ansibleVolume
@@ -61,7 +61,7 @@ EXAMPLES = """
     password: "{{ netapp_password }}"
 
 - name: Rename QTree
-  na_cdot_qtree:
+  community.general.na_cdot_qtree:
     state: present
     name: ansibleQTree
     flexvol_name: ansibleVolume

plugins/modules/storage/netapp/na_cdot_svm.py

@@ -63,7 +63,7 @@ options:
 EXAMPLES = """
 
     - name: Create SVM
-      na_cdot_svm:
+      community.general.na_cdot_svm:
         state: present
         name: ansibleVServer
         root_volume: vol1

plugins/modules/storage/netapp/na_cdot_user.py

@@ -82,7 +82,7 @@ options:
 EXAMPLES = """
 
     - name: Create User
-      na_cdot_user:
+      community.general.na_cdot_user:
         state: present
         name: SampleUser
         application: ssh

plugins/modules/storage/netapp/na_cdot_user_role.py

@@ -59,7 +59,7 @@ options:
 EXAMPLES = """
 
     - name: Create User Role
-      na_cdot_user_role:
+      community.general.na_cdot_user_role:
         state: present
         name: ansibleRole
         command_directory_name: DEFAULT

plugins/modules/storage/netapp/na_cdot_volume.py

@@ -91,7 +91,7 @@ options:
 EXAMPLES = """
 
     - name: Create FlexVol
-      na_cdot_volume:
+      community.general.na_cdot_volume:
         state: present
         name: ansibleVolume
         infinite: False
@@ -107,7 +107,7 @@ EXAMPLES = """
         snapshot_policy: daily
 
     - name: Make FlexVol offline
-      na_cdot_volume:
+      community.general.na_cdot_volume:
         state: present
         name: ansibleVolume
         infinite: False

plugins/modules/storage/netapp/na_ontap_gather_facts.py

@@ -49,7 +49,7 @@ options:
 
 EXAMPLES = '''
 - name: Get NetApp info (Password Authentication)
-  na_ontap_gather_facts:
+  community.general.na_ontap_gather_facts:
     state: info
     hostname: "na-vsim"
     username: "admin"
@@ -57,14 +57,14 @@ EXAMPLES = '''
 - debug:
     var: ontap_facts
 - name: Limit Fact Gathering to Aggregate Information
-  na_ontap_gather_facts:
+  community.general.na_ontap_gather_facts:
     state: info
     hostname: "na-vsim"
     username: "admin"
     password: "admins_password"
     gather_subset: "aggregate_info"
 - name: Limit Fact Gathering to Volume and Lun Information
-  na_ontap_gather_facts:
+  community.general.na_ontap_gather_facts:
     state: info
     hostname: "na-vsim"
     username: "admin"
@@ -73,7 +73,7 @@ EXAMPLES = '''
       - volume_info
       - lun_info
 - name: Gather all facts except for volume and lun information
-  na_ontap_gather_facts:
+  community.general.na_ontap_gather_facts:
     state: info
     hostname: "na-vsim"
     username: "admin"

plugins/modules/storage/netapp/sf_account_manager.py

@@ -67,7 +67,7 @@ options:
 
 EXAMPLES = """
 - name: Create Account
-  sf_account_manager:
+  community.general.sf_account_manager:
     hostname: "{{ solidfire_hostname }}"
     username: "{{ solidfire_username }}"
     password: "{{ solidfire_password }}"
@@ -75,7 +75,7 @@ EXAMPLES = """
     name: TenantA
 
 - name: Modify Account
-  sf_account_manager:
+  community.general.sf_account_manager:
     hostname: "{{ solidfire_hostname }}"
     username: "{{ solidfire_username }}"
     password: "{{ solidfire_password }}"
@@ -84,7 +84,7 @@ EXAMPLES = """
     new_name: TenantA-Renamed
 
 - name: Delete Account
-  sf_account_manager:
+  community.general.sf_account_manager:
     hostname: "{{ solidfire_hostname }}"
     username: "{{ solidfire_username }}"
     password: "{{ solidfire_password }}"

plugins/modules/storage/netapp/sf_check_connections.py

@@ -45,7 +45,7 @@ options:
 
 EXAMPLES = """
    - name: Check connections to MVIP and SVIP
-     sf_check_connections:
+     community.general.sf_check_connections:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"

plugins/modules/storage/netapp/sf_snapshot_schedule_manager.py

@@ -93,7 +93,7 @@ options:
 
 EXAMPLES = """
    - name: Create Snapshot schedule
-     sf_snapshot_schedule_manager:
+     community.general.sf_snapshot_schedule_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -104,7 +104,7 @@ EXAMPLES = """
        volumes: 7
 
    - name: Update Snapshot schedule
-     sf_snapshot_schedule_manager:
+     community.general.sf_snapshot_schedule_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -114,7 +114,7 @@ EXAMPLES = """
        snapshot_name: AnsibleSnapshots
 
    - name: Delete Snapshot schedule
-     sf_snapshot_schedule_manager:
+     community.general.sf_snapshot_schedule_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"

plugins/modules/storage/netapp/sf_volume_access_group_manager.py

@@ -62,7 +62,7 @@ options:
 
 EXAMPLES = """
    - name: Create Volume Access Group
-     sf_volume_access_group_manager:
+     community.general.sf_volume_access_group_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -71,7 +71,7 @@ EXAMPLES = """
        volumes: [7,8]
 
    - name: Modify Volume Access Group
-     sf_volume_access_group_manager:
+     community.general.sf_volume_access_group_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -81,7 +81,7 @@ EXAMPLES = """
        attributes: {"volumes": [1,2,3], "virtual_network_id": 12345}
 
    - name: Delete Volume Access Group
-     sf_volume_access_group_manager:
+     community.general.sf_volume_access_group_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"

plugins/modules/storage/netapp/sf_volume_manager.py

@@ -83,7 +83,7 @@ options:
 
 EXAMPLES = """
    - name: Create Volume
-     sf_volume_manager:
+     community.general.sf_volume_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -96,7 +96,7 @@ EXAMPLES = """
        size_unit: gb
 
    - name: Update Volume
-     sf_volume_manager:
+     community.general.sf_volume_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"
@@ -106,7 +106,7 @@ EXAMPLES = """
        access: readWrite
 
    - name: Delete Volume
-     sf_volume_manager:
+     community.general.sf_volume_manager:
        hostname: "{{ solidfire_hostname }}"
        username: "{{ solidfire_username }}"
        password: "{{ solidfire_password }}"

plugins/modules/storage/purestorage/purefa_facts.py

@@ -40,12 +40,12 @@ extends_documentation_fragment:
 
 EXAMPLES = r'''
 - name: Collect default set of facts
-  purefa_facts:
+  community.general.purefa_facts:
     fa_url: 10.10.10.2
     api_token: e31060a7-21fc-e277-6240-25983c6c4592
 
 - name: Collect configuration and capacity facts
-  purefa_facts:
+  community.general.purefa_facts:
     gather_subset:
       - config
       - capacity
@@ -53,7 +53,7 @@ EXAMPLES = r'''
     api_token: e31060a7-21fc-e277-6240-25983c6c4592
 
 - name: Collect all facts
-  purefa_facts:
+  community.general.purefa_facts:
     gather_subset:
       - all
     fa_url: 10.10.10.2

plugins/modules/storage/purestorage/purefb_facts.py

@@ -40,12 +40,12 @@ extends_documentation_fragment:
 
 EXAMPLES = r'''
 - name: Collect default set of facts
-  purefb_facts:
+  community.general.purefb_facts:
     fb_url: 10.10.10.2
     api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
 
 - name: Collect configuration and capacity facts
-  purefb_facts:
+  community.general.purefb_facts:
     gather_subset:
       - config
       - capacity
@@ -53,7 +53,7 @@ EXAMPLES = r'''
     api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
 
 - name: Collect all facts
-  purefb_facts:
+  community.general.purefb_facts:
     gather_subset:
       - all
     fb_url: 10.10.10.2

plugins/modules/storage/vexata/vexata_eg.py

@@ -50,7 +50,7 @@ extends_documentation_fragment:
 
 EXAMPLES = r'''
 - name: Create export group named db_export.
-  vexata_eg:
+  community.general.vexata_eg:
     name: db_export
     vg: dbvols
     ig: dbhosts
@@ -61,7 +61,7 @@ EXAMPLES = r'''
     password: secret
 
 - name: Delete export group named db_export
-  vexata_eg:
+  community.general.vexata_eg:
     name: db_export
     state: absent
     array: vx100_ultra.test.com

plugins/modules/storage/vexata/vexata_volume.py

@@ -39,7 +39,7 @@ extends_documentation_fragment:
 
 EXAMPLES = r'''
 - name: Create new 2 TiB volume named foo
-  vexata_volume:
+  community.general.vexata_volume:
     name: foo
     size: 2T
     state: present
@@ -48,7 +48,7 @@ EXAMPLES = r'''
     password: secret
 
 - name: Expand volume named foo to 4 TiB
-  vexata_volume:
+  community.general.vexata_volume:
     name: foo
     size: 4T
     state: present
@@ -57,7 +57,7 @@ EXAMPLES = r'''
     password: secret
 
 - name: Delete volume named foo
-  vexata_volume:
+  community.general.vexata_volume:
     name: foo
     state: absent
     array: vx100_ultra.test.com

plugins/modules/storage/zfs/zfs.py

@@ -39,39 +39,39 @@ author:
 
 EXAMPLES = '''
 - name: Create a new file system called myfs in pool rpool with the setuid property turned off
-  zfs:
+  community.general.zfs:
     name: rpool/myfs
     state: present
     extra_zfs_properties:
       setuid: off
 
 - name: Create a new volume called myvol in pool rpool.
-  zfs:
+  community.general.zfs:
     name: rpool/myvol
     state: present
     extra_zfs_properties:
       volsize: 10M
 
 - name: Create a snapshot of rpool/myfs file system.
-  zfs:
+  community.general.zfs:
     name: rpool/myfs@mysnapshot
     state: present
 
 - name: Create a new file system called myfs2 with snapdir enabled
-  zfs:
+  community.general.zfs:
     name: rpool/myfs2
     state: present
     extra_zfs_properties:
       snapdir: enabled
 
 - name: Create a new file system by cloning a snapshot
-  zfs:
+  community.general.zfs:
     name: rpool/cloned_fs
     state: present
     origin: rpool/myfs@mysnapshot
 
 - name: Destroy a filesystem
-  zfs:
+  community.general.zfs:
     name: rpool/myfs
     state: absent
 '''

plugins/modules/storage/zfs/zfs_delegate_admin.py

@@ -70,27 +70,27 @@ author:
 
 EXAMPLES = r'''
 - name: Grant `zfs allow` and `unallow` permission to the `adm` user with the default local+descendents scope
-  zfs_delegate_admin:
+  community.general.zfs_delegate_admin:
     name: rpool/myfs
     users: adm
     permissions: allow,unallow
 
 - name: Grant `zfs send` to everyone, plus the group `backup`
-  zfs_delegate_admin:
+  community.general.zfs_delegate_admin:
     name: rpool/myvol
     groups: backup
     everyone: yes
     permissions: send
 
 - name: Grant `zfs send,receive` to users `foo` and `bar` with local scope only
-  zfs_delegate_admin:
+  community.general.zfs_delegate_admin:
     name: rpool/myfs
     users: foo,bar
     permissions: send,receive
     local: yes
 
 - name: Revoke all permissions from everyone (permissions specifically assigned to users and groups remain)
-  zfs_delegate_admin:
+  community.general.zfs_delegate_admin:
     name: rpool/myfs
     everyone: yes
     state: absent

plugins/modules/storage/zfs/zfs_facts.py

@@ -52,11 +52,11 @@ options:
 
 EXAMPLES = '''
 - name: Gather facts about ZFS dataset rpool/export/home
-  zfs_facts:
+  community.general.zfs_facts:
     dataset: rpool/export/home
 
 - name: Report space usage on ZFS filesystems under data/home
-  zfs_facts:
+  community.general.zfs_facts:
     name: data/home
     recurse: yes
     type: filesystem

plugins/modules/storage/zfs/zpool_facts.py

@@ -39,10 +39,10 @@ options:
 
 EXAMPLES = '''
 - name: Gather facts about ZFS pool rpool
-  zpool_facts: pool=rpool
+  community.general.zpool_facts: pool=rpool
 
 - name: Gather space usage about all imported ZFS pools
-  zpool_facts: properties='free,size'
+  community.general.zpool_facts: properties='free,size'
 
 - name: Print gathered information
   debug: