VhS#ddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z ddlmZGd d e Zd Zed k(rey y ))absolute_importdivisionprint_functionu --- module: volume short_description: Manages volumes on the cloudscale.ch IaaS service. description: - Create, attach/detach, update, delete and revert volumes on the cloudscale.ch IaaS service. notes: - To create a new volume at least the I(name) and I(size_gb) options are required. - A volume can be created and attached to a server in the same task. author: - Gaudenz Steinlin (@gaudenz) - René Moser (@resmo) - Denis Krienbühl (@href) version_added: "1.0.0" options: state: description: - State of the volume. default: present choices: [ present, absent ] type: str name: description: - Name of the volume. Either name or UUID must be present to change an existing volume. type: str uuid: description: - UUID of the volume. Either name or UUID must be present to change an existing volume. type: str size_gb: description: - Size of the volume in GB. type: int type: description: - Type of the volume. Cannot be changed after creating the volume. Defaults to C(ssd) on volume creation. choices: [ ssd, bulk ] type: str zone: description: - Zone in which the volume resides (e.g. C(lpg1) or C(rma1)). Cannot be changed after creating the volume. Defaults to the project default zone. type: str servers: description: - UUIDs of the servers this volume is attached to. Set this to C([]) to detach the volume. Currently a volume can only be attached to a single server. - The aliases C(server_uuids) and C(server_uuid) are deprecated and will be removed in version 3.0.0 of this collection. aliases: [ server_uuids, server_uuid ] type: list elements: str revert: description: - 'UUID of the snapshot to revert the volume to. This must be the most recent snapshot of the volume. For root volumes: the respective server must be shut down. For non-root volumes: the volume to be reverted must be detached' type: str tags: description: - Tags associated with the volume. Set this to C({}) to clear any tags. type: dict extends_documentation_fragment: cloudscale_ch.cloud.api_parameters a # Create a new SSD volume - name: Create an SSD volume cloudscale_ch.cloud.volume: name: my_ssd_volume zone: 'lpg1' size_gb: 50 api_token: xxxxxx register: my_ssd_volume # Attach an existing volume to a server - name: Attach volume to server cloudscale_ch.cloud.volume: uuid: "{{ my_ssd_volume.uuid }}" servers: - ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48 api_token: xxxxxx # Create and attach a volume to a server - name: Create and attach volume to server cloudscale_ch.cloud.volume: name: my_ssd_volume zone: 'lpg1' size_gb: 50 servers: - ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48 api_token: xxxxxx # Detach volume from server - name: Detach volume from server cloudscale_ch.cloud.volume: uuid: "{{ my_ssd_volume.uuid }}" servers: [] api_token: xxxxxx # Revert a volume to the most recent snapshot - name: Revert volume to snapshot cloudscale_ch.cloud.volume: uuid: "{{ my_ssd_volume.uuid }}" revert: "e504dc99-ff01-4e89-ad89-7df080f97b4b" api_token: xxxxxx # Delete a volume - name: Delete volume cloudscale_ch.cloud.volume: name: my_ssd_volume state: absent api_token: xxxxxx a href: description: The API URL to get details about this volume. returned: state == present type: str sample: https://api.cloudscale.ch/v1/volumes/2db69ba3-1864-4608-853a-0771b6885a3a uuid: description: The unique identifier for this volume. returned: state == present type: str sample: 2db69ba3-1864-4608-853a-0771b6885a3a name: description: The display name of the volume. returned: state == present type: str sample: my_ssd_volume size_gb: description: The size of the volume in GB. returned: state == present type: str sample: 50 type: description: The type of the volume. returned: state == present type: str sample: bulk zone: description: The zone of the volume. returned: state == present type: dict sample: {'slug': 'lpg1'} server_uuids: description: The UUIDs of the servers this volume is attached to. This return value is deprecated and will disappear in the future when the field is removed from the API. returned: state == present type: list sample: ['47cec963-fcd2-482f-bdb6-24461b2d47b1'] servers: description: The list of servers this volume is attached to. returned: state == present type: list sample: [ { "href": "https://api.cloudscale.ch/v1/servers/47cec963-fcd2-482f-bdb6-24461b2d47b1", "name": "my_server", "uuid": "47cec963-fcd2-482f-bdb6-24461b2d47b1" } ] state: description: The current status of the volume. returned: success type: str sample: present tags: description: Tags associated with the volume. returned: state == present type: dict sample: { 'project': 'my project' } ) AnsibleModule)AnsibleCloudscaleBasecloudscale_argument_spec)deepcopyc.eZdZfdZfdZdZxZS)AnsibleCloudscaleVolumecd|jjddgtt||S)Nnamesize_gb)_modulefail_on_missing_paramssuperr create)selfresource __class__s n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cloudscale_ch/cloud/plugins/modules/volume.pyrzAnsibleCloudscaleVolume.creates- ++VY,?@,d:8DDcd}|dk7rtt| |||S||}|}t|t|k7rd}|S|D] }|d|vs d}|S)NFserversTuuid)rr find_differencelen) rkeyrparam is_different server_has server_wantedhasrs rrz'AnsibleCloudscaleVolume.find_differences~ ) 0$GXW\] ]c]  } Z 0L  " (v;m3#'L (rc|j}t|ddkDr|jjd|ddz}d|jjdi}|j ||}|j d d }d |d <|jjd|d<t|d <t||d d<t||d d<|d djd|jjdi|S)Nrrz1Cannot revert a volume that is attached to server)msghrefz/revertsnapshotrevertcurrent_operationFTchangeddiffbeforeafter) queryrr fail_jsonparams_postwait_for_statedictr update)rr revert_url revert_paramr(results rr(zAnsibleCloudscaleVolume.reverts ::< x " #a ' LL " "'Z " [f% 1 "DLL$7$7$AB J 5$$%8%@ y<<..x8xv#+H#5vx "*8"4vwvw&& dll))(3(   r)__name__ __module__ __qualname__rrr( __classcell__)rs@rr r sE "rr ct}|jttdddtdtdtdtdtddtd dd d g tdtd  t|dd}|jj d s|jj d r|j dddt|dgdgd}|jddk(r|j}n0|jdr|j}n|j}|jdi|y)Nstrpresent)r>absent)typedefaultchoices)r@int)ssdbulk)r@rBlist server_uuids server_uuid)r@elementsaliasesr3) staterrzonerr@rr(tags))rrT) argument_specrequired_one_ofsupports_check_modezmThe aliases "server_uuid" and "server_uuids" have been deprecated and will be removed, use "servers" instead.z3.0.0zcloudscale_ch.cloud)versioncollection_namevolumes)rr@rLrrrM)rrrrM) resource_nameresource_create_param_keysresource_update_param_keysrKr?r() r r4r3rr0get deprecater r?r(r> exit_json)rNmodulecloudscale_volumer7s rmainr]sK,.My:OP u  u  u % uo 6&5>=:YZ v   #+ F}}'6==+<+<^+L$"):O  Q 0$ $ &}}W)"))+ x "))+"**,Fvr__main__N) __future__rrrr@ __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrmodule_utils.apirr copyr r r]r8rWrrrgscA@ E N0 d; z5(3(V4n zFr