na_elementsw_volume_clone – NetApp Element Software Create Volume Clone¶
New in version 2.7.
Requirements¶
The below requirements are needed on the host that executes this module.
- The modules were developed with SolidFire 10.1
- solidfire-sdk-python (1.1.0.92) or greater. Install using ‘pip install solidfire-sdk-python’
Parameters¶
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| access 
                    -
                                                                 | 
 | Access allowed for the volume. If unspecified, the access settings of the clone will be the same as the source. readOnly - Only read operations are allowed. readWrite - Reads and writes are allowed. locked - No reads or writes are allowed. replicationTarget - Identify a volume as the target volume for a paired set of volumes. If the volume is not paired, the access status is locked. | 
| account_id 
                    -
                                             / required                     | Account ID for the owner of this cloned volume. id may be a numeric identifier or an account name. | |
| attributes 
                    -
                                                                 | A YAML dictionary of attributes that you would like to apply on this cloned volume. | |
| hostname 
                    -
                                             / required                     | The hostname or IP address of the SolidFire cluster. | |
| name 
                    -
                                             / required                     | The name of the clone. | |
| password 
                    -
                                             / required                     | Password for the specified user. aliases: pass | |
| size 
                    -
                                                                 | The size of the cloned volume in (size_unit). | |
| size_unit 
                    -
                                                                 | 
 | The unit used to interpret the size parameter. | 
| src_snapshot_id 
                    -
                                                                 | The id of the snapshot to clone. id may be a numeric identifier or a snapshot name. | |
| src_volume_id 
                    -
                                             / required                     | The id of the src volume to clone. id may be a numeric identifier or a volume name. | |
| username 
                    -
                                             / required                     | Please ensure that the user has the adequate permissions. For more information, please read the official documentation https://mysupport.netapp.com/documentation/docweb/index.html?productID=62636&language=en-US. aliases: user | 
Notes¶
Note
- The modules prefixed with na\_elementsw are built to support the SolidFire storage platform.
Examples¶
- name: Clone Volume
  na_elementsw_volume_clone:
    hostname: "{{ elementsw_hostname }}"
    username: "{{ elementsw_username }}"
    password: "{{ elementsw_password }}"
    name: CloneAnsibleVol
    src_volume_id: 123
    src_snapshot_id: 41
    account_id: 3
    size: 1
    size_unit: gb
    access: readWrite
    attributes: {"virtual_network_id": 12345}
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | 
|---|---|---|
| msg 
                  string
                                       | success | Success message | 
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by an Ansible Partner. [certified]
Authors¶
- NetApp Ansible Team (@carchi8py) <ng-ansibleteam@netapp.com>
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
