Rename all of the modules

This is separate from the previous patch - it's just the results
of running the script so we can review the two a little independently.
We should probably squash them.

Change-Id: I838f15cf4a32455a5be20033c8ddc27db6ca15c0

plugins/modules/server_volume.py

@@ -0,0 +1,147 @@
+#!/usr/bin/python
+# coding: utf-8 -*-
+
+# Copyright (c) 2014 Hewlett-Packard Development Company, L.P.
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+
+ANSIBLE_METADATA = {'metadata_version': '1.1',
+                    'status': ['preview'],
+                    'supported_by': 'community'}
+
+
+DOCUMENTATION = '''
+---
+module: server_volume
+short_description: Attach/Detach Volumes from OpenStack VM's
+author: "Monty Taylor (@emonty)"
+description:
+   - Attach or Detach volumes from OpenStack VM's
+options:
+   state:
+     description:
+       - Should the resource be present or absent.
+     choices: [present, absent]
+     default: present
+     required: false
+     type: str
+   server:
+     description:
+       - Name or ID of server you want to attach a volume to
+     required: true
+     type: str
+   volume:
+     description:
+      - Name or id of volume you want to attach to a server
+     required: true
+     type: str
+   device:
+     description:
+      - Device you want to attach. Defaults to auto finding a device name.
+     type: str
+requirements:
+    - "python >= 3.6"
+    - "openstacksdk"
+
+extends_documentation_fragment:
+- openstack.cloud.openstack
+'''
+
+EXAMPLES = '''
+# Attaches a volume to a compute host
+- name: attach a volume
+  hosts: localhost
+  tasks:
+  - name: attach volume to host
+    openstack.cloud.server_volume:
+      state: present
+      cloud: mordred
+      server: Mysql-server
+      volume: mysql-data
+      device: /dev/vdb
+'''
+
+from ansible.module_utils.basic import AnsibleModule
+from ansible_collections.openstack.cloud.plugins.module_utils.openstack import (openstack_full_argument_spec,
+                                                                                openstack_module_kwargs,
+                                                                                openstack_cloud_from_module)
+
+
+def _system_state_change(state, device):
+    """Check if system state would change."""
+    if state == 'present':
+        if device:
+            return False
+        return True
+    if state == 'absent':
+        if device:
+            return True
+        return False
+    return False
+
+
+def main():
+    argument_spec = openstack_full_argument_spec(
+        server=dict(required=True),
+        volume=dict(required=True),
+        device=dict(default=None),  # None == auto choose device name
+        state=dict(default='present', choices=['absent', 'present']),
+    )
+
+    module_kwargs = openstack_module_kwargs()
+    module = AnsibleModule(argument_spec,
+                           supports_check_mode=True,
+                           **module_kwargs)
+
+    state = module.params['state']
+    wait = module.params['wait']
+    timeout = module.params['timeout']
+
+    sdk, cloud = openstack_cloud_from_module(module)
+    try:
+        server = cloud.get_server(module.params['server'])
+        volume = cloud.get_volume(module.params['volume'])
+
+        if not volume:
+            module.fail_json(msg='volume %s is not found' % module.params['volume'])
+
+        dev = cloud.get_volume_attach_device(volume, server.id)
+
+        if module.check_mode:
+            module.exit_json(changed=_system_state_change(state, dev))
+
+        if state == 'present':
+            changed = False
+            if not dev:
+                changed = True
+                cloud.attach_volume(server, volume, module.params['device'],
+                                    wait=wait, timeout=timeout)
+
+            server = cloud.get_server(module.params['server'])  # refresh
+            volume = cloud.get_volume(module.params['volume'])  # refresh
+            hostvars = cloud.get_openstack_vars(server)
+
+            module.exit_json(
+                changed=changed,
+                id=volume['id'],
+                attachments=volume['attachments'],
+                openstack=hostvars
+            )
+
+        elif state == 'absent':
+            if not dev:
+                # Volume is not attached to this server
+                module.exit_json(changed=False)
+
+            cloud.detach_volume(server, volume, wait=wait, timeout=timeout)
+            module.exit_json(
+                changed=True,
+                result='Detached volume from server'
+            )
+
+    except (sdk.exceptions.OpenStackCloudException, sdk.exceptions.ResourceTimeout) as e:
+        module.fail_json(msg=str(e))
+
+
+if __name__ == '__main__':
+    main()