Vh~,ddlmZdZdZdZddlmZddlmZddl m Z dd l m Z Gd d eZ d Zed k(reyy)) annotationsaS --- module: volume short_description: Create and manage block Volume on the Hetzner Cloud. description: - Create, update and attach/detach block Volume on the Hetzner Cloud. author: - Christopher Schmitt (@cschmitt-hcloud) options: id: description: - The ID of the Hetzner Cloud Block Volume to manage. - Only required if no volume I(name) is given type: int name: description: - The Name of the Hetzner Cloud Block Volume to manage. - Only required if no volume I(id) is given or a volume does not exist. type: str size: description: - The size of the Block Volume in GB. - Required if volume does not yet exists. type: int automount: description: - Automatically mount the Volume. type: bool default: False format: description: - Automatically Format the volume on creation - Can only be used in case the Volume does not exist. type: str choices: [xfs, ext4] location: description: - Location of the Hetzner Cloud Volume. - Required if no I(server) is given and Volume does not exist. type: str server: description: - Server Name the Volume should be assigned to. - Required if no I(location) is given and Volume does not exist. type: str delete_protection: description: - Protect the Volume for deletion. type: bool labels: description: - User-defined key-value pairs. type: dict state: description: - State of the Volume. default: present choices: [absent, present] type: str extends_documentation_fragment: - hetzner.hcloud.hcloud a - name: Create a Volume hetzner.hcloud.volume: name: my-volume location: fsn1 size: 100 state: present - name: Create a Volume and format it with ext4 hetzner.hcloud.volume: name: my-volume location: fsn format: ext4 size: 100 state: present - name: Mount a existing Volume and automount hetzner.hcloud.volume: name: my-volume server: my-server automount: true state: present - name: Mount a existing Volume and automount hetzner.hcloud.volume: name: my-volume server: my-server automount: true state: present - name: Ensure the Volume is absent (remove if needed) hetzner.hcloud.volume: name: my-volume state: absent a hcloud_volume: description: The block Volume returned: Always type: complex contains: id: description: ID of the Volume type: int returned: Always sample: 12345 name: description: Name of the Volume type: str returned: Always sample: my-volume size: description: Size in GB of the Volume type: int returned: Always sample: 1337 linux_device: description: Path to the device that contains the Volume. returned: always type: str sample: /dev/disk/by-id/scsi-0HC_Volume_12345 version_added: "0.1.0" location: description: Location name where the Volume is located at type: str returned: Always sample: "fsn1" labels: description: User-defined labels (key-value pairs) type: dict returned: Always sample: key: value mylabel: 123 server: description: Server name where the Volume is attached to type: str returned: Always sample: "my-server" delete_protection: description: True if Volume is protected for deletion type: bool returned: always sample: false version_added: "0.1.0" ) AnsibleModule) AnsibleHCloud)HCloudException) BoundVolumec`eZdZUdZdZded<dZdZdZdZ dZ d Z e fd Z xZS) AnsibleHCloudVolume hcloud_volumeNzBoundVolume | Nonec t|jj|jj|jj|jj j|jj |jj |jjjnd|jj|jjddS)Ndelete)idnamesizelocationlabelsserver linux_devicedelete_protection) strr rrrrrrr protectionselfs i/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/hetzner/hcloud/plugins/modules/volume.py_prepare_resultz#AnsibleHCloudVolume._prepare_resultsd((++,&&++&&++**3388((//8<8J8J8Q8Q8]d((//44cg ..;;!%!3!3!>!>x!H  c |jjjdN|jjj |jjjd|_y|jjj|jjjd|_y#t$r}|j|Yd}~yd}~wwxYw)Nrr) moduleparamsgetclientvolumes get_by_idr get_by_namerfail_json_hcloud)r exceptions r _get_volumezAnsibleHCloudVolume._get_volumes -{{!!%%d+7%)[[%8%8%B%B4;;CUCUCYCYZ^C_%`"%)[[%8%8%D%DT[[EWEWE[E[\bEc%d" -  ! !) , , -sA2C5A C C' C""C'c|jjddg|jjjd|jjjd|jjjd|jjjd|jjjdd}|jjjdL|jj j |jjjd|d<n|jjjd L|jjj |jjjd |d <n|jjd |jjs |jjjdi|}|jj|jDcgc]}|jc}|jjjd }|<|j|j j#| }|j|j)|jycc}w#t$$r}|j'|Yd}~Ed}~wwxYw)Nrrrequired_params automountformatr)rrr+r,rrrzserver or location is required)msgrr )rfail_on_missing_paramsrr r!serversr$ locations fail_json check_moder"createactionwait_until_finished next_actionsr'r change_protectionrr%_mark_as_changed)rrrespr6rr&s r_create_volumez"AnsibleHCloudVolume._create_volumesH **FF;K*LKK&&**62KK&&**62++// <kk((,,X6kk((,,X6   ;;   ! !( + 7#{{22>>t{{?Q?Q?U?UV^?_`F8  [[   # #J / ;!%!6!6!B!B4;;CUCUCYCYZdCe!fF:  KK ! !&F ! G{{%% 11t{{**11;F; //1<@>Nc~|j|j|jy|jyN)r'r r<rDrs rpresent_volumez"AnsibleHCloudVolume.present_volumes2     %    !    !rc |j|j|jjso|jj*|jj }|j |jjj|j|jd|_y#t$r}|j|Yd}~yd}~wwxYwrF) r'r rr4rrAr7r!r"r r:rr%)rr6r&s r delete_volumez!AnsibleHCloudVolume.delete_volumes -    !!-{{--))00+-Z" -  rr c*tj}t|}|jjd}|dk(r$|j dg|j n|j |jdi|jy)NrUrSrr)r/) r r^rr r0rIrG exit_json get_result)rhcloudrUs rmainrj=s} . . 0F  (F MM  g &E %%vh%?F+v((*+r__main__N) __future__r DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrmodule_utils.hcloudrmodule_utils.vendor.hcloudr"module_utils.vendor.hcloud.volumesrr rjr_r/rrrtsY#C J @2 h5/8<Q -Q h , zFr