File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/purefa.cpython-310.pyc
Back
o ;ja� � @ s� d Z ddlZddlZddlmZ ddlmZ zddlZdZW n ey) dZY nw dZ dZ d Z d Z d Z d d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � ZdLd d �ZdMd d!�ZdLd"d#�ZdLd$d%�ZdNd&d'�Zd(d)� Z d*d+� Z dNd,d-�Z dNd.d/�Z d0d1� Z d2d3� Z!dOd4d5�Z"dOd6d7�Z#d8d9� Z$dPd:d;�Z%dPd<d=�Z&d>d?� Z'dPd@dA�Z(dQdBdC�Z)dOdDdE�Z*dNdFdG�Z+dHdI� Z,dOdJdK�Z-dS )Ra, Management of Pure Storage FlashArray Installation Prerequisites -------------------------- - You will need the ``purestorage`` python package in your python installation path that is running salt. .. code-block:: bash pip install purestorage - Configure Pure Storage FlashArray authentication. Use one of the following three methods. 1) From the minion config .. code-block:: yaml pure_tags: fa: san_ip: management vip or hostname for the FlashArray api_token: A valid api token for the FlashArray being managed 2) From environment (PUREFA_IP and PUREFA_API) 3) From the pillar (PUREFA_IP and PUREFA_API) :maintainer: Simon Dodsley (simon@purestorage.com) :maturity: new :requires: purestorage :platform: all .. versionadded:: 2018.3.0 � N)�datetime)�CommandExecutionErrorTFzrestructuredtext enz1.0.0ZSaltZpurefa)Z23456789ZABCDEFGHJKLMNPQRSTUVWXYZZabcdefghijkmnopqrstuvwxyzc C s t rtS dS )z6 Determine whether or not to load this module )FzMpurefa execution module not loaded: purestorage python library not available.)�HAS_PURESTORAGE�__virtualname__� r r �G/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/purefa.py� __virtual__S s r c C s t ttt�� d�} djd i | ��}z td d �d�}td d �d�}|r0|r0tj|||d�}W nK t t t fy| zt j �d�}t j �d �}tj|||d�}W n( tt t fyy ztjtd td |d�}W n t t fyv td ��w Y nw Y nw z|�� W |S ty� td ��w )ae Get Pure Storage FlashArray configuration 1) From the minion config pure_tags: fa: san_ip: management vip or hostname for the FlashArray api_token: A valid api token for the FlashArray being managed 2) From environment (PUREFA_IP and PUREFA_API) 3) From the pillar (PUREFA_IP and PUREFA_API) )�base�class�version�platformz%{base} {class}/{version} ({platform})Z pure_tags�fa�san_ip� api_token)r � user_agentZ PUREFA_IPZ PUREFA_APIz-No Pure Storage FlashArray credentials found.z.Pure Storage FlashArray authentication failed.Nr )�USER_AGENT_BASE�__name__�VERSIONr �formatZ__opts__�get� purestorageZ FlashArray�KeyError� NameError� TypeError�os�environ� ValueErrorZ __pillar__r � Exception)Zagentr �arrayZapi�systemr r r r r � _get_system_ sR �� � ������� ��r c C s$ z|� | �W S tjy Y dS w )z Private function to check volumeN�Z get_volumer � PureError��namer r r r � _get_volume� s �r% c C sT | d | }z|j | dd�D ] }|d |kr| W S qW dS tjy) Y dS w )z"Private function to check snapshot�.T)�snapr$ Nr! )r$ �suffixr Zsnapshotr' r r r � _get_snapshot� s ���r) c C �( z|j | dd�W S tjy Y dS w )z(Private function to check deleted volume�true��pendingNr! r# r r r �_get_deleted_volume� � �r. c C �, d}|� � D ] }|d | kr|} |S q|S )z*Private function to check protection groupNr$ )Z list_pgroups)r$ r �pgroup�tempr r r � _get_pgroup� � �r3 c C r* )z2Private function to check deleted protection groupr+ r, N)Z get_pgroupr r" r# r r r �_get_deleted_pgroup� r/ r5 c C r0 )z#Private function to check hostgroupNr$ )Z list_hgroups)r$ r � hostgroupr2 r r r � _get_hgroup� r4 r7 c C r0 )z Private function to check hostNr$ )Z list_hosts)r$ r �hostr2 r r r � _get_host� r4 r9 c C s� t � }|du r!dtt�� tddddddd� �� � }|�dd�}t| |�dur>z |j| |d� W d S tj y= Y d S w d S ) a� Create a volume snapshot on a Pure Storage FlashArray. Will return False is volume selected to snap does not exist. .. versionadded:: 2018.3.0 name : string name of volume to snapshot suffix : string if specificed forces snapshot name suffix. If not specified defaults to timestamp. CLI Example: .. code-block:: bash salt '*' purefa.snap_create foo salt '*' purefa.snap_create foo suffix=bar Nzsnap-i� � r r& � )r( TF) r �strr �utcnow� total_seconds�replacer% Zcreate_snapshotr r" )r$ r( r r r r � snap_create� s � �r@ c C s� t � }t| ||�dur>z | d | }|�|� W n tjy# Y dS w |du r<z|�|� W dS tjy; Y dS w dS dS )a� Delete a volume snapshot on a Pure Storage FlashArray. Will return False if selected snapshot does not exist. .. versionadded:: 2018.3.0 name : string name of volume suffix : string name of snapshot eradicate : boolean Eradicate snapshot after deletion if True. Default is False CLI Example: .. code-block:: bash salt '*' purefa.snap_delete foo suffix=snap eradicate=True Nr& FT)r r) �destroy_volumer r" �eradicate_volume)r$ r( � eradicater �snapnamer r r � snap_delete� s" � �rE c C sN t � }t| ||�dur%| d | }z|�|� W dS tjy$ Y dS w dS )af Eradicate a deleted volume snapshot on a Pure Storage FlashArray. Will return False if snapshot is not in a deleted state. .. versionadded:: 2018.3.0 name : string name of volume suffix : string name of snapshot CLI Example: .. code-block:: bash salt '*' purefa.snap_eradicate foo suffix=snap Nr& TF)r r) rB r r" )r$ r( r rD r r r �snap_eradicate% s �rF c C sf t | �dkr | dd� } t� }t| |�du r1|du r d}z |�| |� W dS tjy0 Y dS w dS )a� Create a volume on a Pure Storage FlashArray. Will return False if volume already exists. .. versionadded:: 2018.3.0 name : string name of volume (truncated to 63 characters) size : string if specificed capacity of volume. If not specified default to 1G. Refer to Pure Storage documentation for formatting rules. CLI Example: .. code-block:: bash salt '*' purefa.volume_create foo salt '*' purefa.volume_create foo size=10T �? r NZ1GTF)�lenr r% Z create_volumer r" )r$ �sizer r r r � volume_createF s �rJ c C �r t � }t| |�dur7z|�| � W n tjy Y dS w |du r5z|�| � W dS tjy4 Y dS w dS dS )a� Delete a volume on a Pure Storage FlashArray. Will return False if volume doesn't exist is already in a deleted state. .. versionadded:: 2018.3.0 name : string name of volume eradicate : boolean Eradicate volume after deletion if True. Default is False CLI Example: .. code-block:: bash salt '*' purefa.volume_delete foo eradicate=True NFT)r r% rA r r" rB �r$ rC r r r r � volume_deletel s � �rM c C �@ t � }t| |�dur z|�| � W dS tjy Y dS w dS )a$ Eradicate a deleted volume on a Pure Storage FlashArray. Will return False is volume is not in a deleted state. .. versionadded:: 2018.3.0 name : string name of volume CLI Example: .. code-block:: bash salt '*' purefa.volume_eradicate foo NTF)r r. rB r r" r# r r r �volume_eradicate� � �rO c C s^ t � }t| |�}|dur-td |�|d kr+z |�| |� W dS tjy* Y dS w dS dS )a� Extend an existing volume on a Pure Storage FlashArray. Will return False if new size is less than or equal to existing size. .. versionadded:: 2018.3.0 name : string name of volume size : string New capacity of volume. Refer to Pure Storage documentation for formatting rules. CLI Example: .. code-block:: bash salt '*' purefa.volume_extend foo 10T Nzstringutils.human_to_bytesrI TF)r r% � __utils__Z extend_volumer r" )r$ rI r �volr r r � volume_extend� s �rS c C s� t � }| �d�\}}t|||�durIt||�du r.z |�| |� W dS tjy- Y dS w |rGz |j| ||d� W dS tjyF Y dS w dS dS )a Create R/W volume from snapshot on a Pure Storage FlashArray. Will return False if target volume already exists and overwrite is not specified, or selected snapshot doesn't exist. .. versionadded:: 2018.3.0 name : string name of volume snapshot target : string name of clone volume overwrite : boolean overwrite clone if already exists (default: False) CLI Example: .. code-block:: bash salt '*' purefa.snap_volume_create foo.bar clone overwrite=True r& NTF�� overwrite)r �splitr) r% � copy_volumer r" )r$ �targetrU r �sourcer( r r r �snap_volume_create� s& ��rZ c C s� t � }t| |�durAt||�du r&z |�| |� W dS tjy% Y dS w |r?z |j| ||d� W dS tjy> Y dS w dS dS )a� Clone an existing volume on a Pure Storage FlashArray. Will return False if source volume doesn't exist, or target volume already exists and overwrite not specified. .. versionadded:: 2018.3.0 name : string name of volume target : string name of clone volume overwrite : boolean overwrite clone if already exists (default: False) CLI Example: .. code-block:: bash salt '*' purefa.volume_clone foo bar overwrite=True NTFrT )r r% rW r r" )r$ rX rU r r r r � volume_clone s$ ��r[ c C sP t � }t| |�dur&t||�dur&z |�|| � W dS tjy% Y dS w dS )aJ Attach a volume to a host on a Pure Storage FlashArray. Host and volume must exist or else will return False. .. versionadded:: 2018.3.0 name : string name of volume host : string name of host CLI Example: .. code-block:: bash salt '*' purefa.volume_attach foo bar NTF)r r% r9 Z connect_hostr r" �r$ r8 r r r r � volume_attach1 s �r] c C st t � }t| |�du st||�du rdS t| |�dur6t||�dur8z |�|| � W dS tjy5 Y dS w dS dS )a� Detach a volume from a host on a Pure Storage FlashArray. Will return False if either host or volume do not exist, or if selected volume isn't already connected to the host. .. versionadded:: 2018.3.0 name : string name of volume host : string name of host CLI Example: .. code-block:: bash salt '*' purefa.volume_detach foo bar NFT)r r% r9 �disconnect_hostr r" r\ r r r � volume_detachQ s ��r_ c C s t � }t| �dkr| dd� } t| |�du r�z|�| � W n tjy( Y dS w |rFz |j| |gd� W n tjyE |�| � Y dS w |durez |j| |gd� W n tjyd |�| � Y dS w |dur�z |j| |gd� W dS tjy� |�| � Y dS w dS dS ) az Add a host on a Pure Storage FlashArray. Will return False if host already exists, or the iSCSI or Fibre Channel parameters are not in a valid format. See Pure Storage FlashArray documentation. .. versionadded:: 2018.3.0 name : string name of host (truncated to 63 characters) iqn : string iSCSI IQN of host nqn : string NVMeF NQN of host .. versionadded:: 3006.0 wwn : string Fibre Channel WWN of host CLI Example: .. code-block:: bash salt '*' purefa.host_create foo iqn='<Valid iSCSI IQN>' wwn='<Valid WWN>' nqn='<Valid NQN>' rG r NF�Z addnqnlist�Z addiqnlist�Z addwwnlistT)r rH r9 Z create_hostr r" �set_host� delete_host�r$ ZiqnZwwnZnqnr r r r � host_creater sB � � �� ��rf c C s� t � }t| |�durY|r"z |j| |gd� W n tjy! Y dS w |dur<z |j| |gd� W n tjy; Y dS w |durWz |j| |gd� W dS tjyV Y dS w dS dS )a� Update a hosts port definitions on a Pure Storage FlashArray. Will return False if new port definitions are already in use by another host, or are not in a valid format. See Pure Storage FlashArray documentation. .. versionadded:: 2018.3.0 name : string name of host nqn : string Additional NVMeF NQN of host .. versionadded:: 3006.0 iqn : string Additional iSCSI IQN of host wwn : string Additional Fibre Channel WWN of host CLI Example: .. code-block:: bash salt '*' purefa.host_update foo iqn='<Valid iSCSI IQN>' wwn='<Valid WWN>' nqn='<Valid NQN>' Nr` Fra rb T)r r9 rc r r" re r r r � host_update� s. ����rg c C s| t � }t| |�dur<|�| �D ]}z |�| |d � W q tjy' Y dS w z|�| � W dS tjy; Y dS w dS )a Delete a host on a Pure Storage FlashArray (detaches all volumes). Will return False if the host doesn't exist. .. versionadded:: 2018.3.0 name : string name of host CLI Example: .. code-block:: bash salt '*' purefa.host_delete foo NrR FT)r r9 Zlist_host_connectionsr^ r r" rd )r$ r rR r r r � host_delete� s � �rh c C s� t � }t| �dkr| dd� } t| |�du rxz|�| � W n tjy( Y dS w |durNt||�rHz |j| |gd� W n tjyG Y dS w t| � dS |durvt ||�rpz |� | |� W dS tjyo t| � Y dS w t| � dS dS dS )a� Create a hostgroup on a Pure Storage FlashArray. Will return False if hostgroup already exists, or if named host or volume do not exist. .. versionadded:: 2018.3.0 name : string name of hostgroup (truncated to 63 characters) host : string name of host to add to hostgroup volume : string name of volume to add to hostgroup CLI Example: .. code-block:: bash salt '*' purefa.hg_create foo host=bar volume=vol rG r NF�Z addhostlistT) r rH r7 Z create_hgroupr r" r9 � set_hgroup� hg_deleter% �connect_hgroup�r$ r8 �volumer r r r � hg_create s> � � ��ro c C s� t � }t| |�durM|dur+t||�r)z |j| |gd� W n tjy( Y dS w dS |durKt||�rIz |�| |� W dS tjyH Y dS w dS dS dS )a� Adds entries to a hostgroup on a Pure Storage FlashArray. Will return False is hostgroup doesn't exist, or host or volume do not exist. .. versionadded:: 2018.3.0 name : string name of hostgroup host : string name of host to add to hostgroup volume : string name of volume to add to hostgroup CLI Example: .. code-block:: bash salt '*' purefa.hg_update foo host=bar volume=vol Nri FT)r r7 r9 rj r r" r% rl rm r r r � hg_update; s* � ��rp c C s� t � }t| |�durJ|�| �D ]}z |�| |d � W q tjy' Y dS w |�| �}z|j| |d d� |�| � W dS tjyI Y dS w dS )a? Delete a hostgroup on a Pure Storage FlashArray (removes all volumes and hosts). Will return False is hostgroup is already in a deleted state. .. versionadded:: 2018.3.0 name : string name of hostgroup CLI Example: .. code-block:: bash salt '*' purefa.hg_delete foo NrR F�hosts�Z remhostlistT) r r7 �list_hgroup_connections�disconnect_hgroupr r" Z get_hgrouprj Z delete_hgroup)r$ r rR r8 r r r rk j s" � �rk c C s� t � }t| |�dury|dur<t||�r:|�| �D ] }|d |kr7z |�| |� W dS tjy6 Y dS w qdS dS |durkt||�rit||�}|d | krgz |j| |gd� W dS tjyf Y dS w dS dS |du ru|du rwdS dS dS dS )a� Remove a host and/or volume from a hostgroup on a Pure Storage FlashArray. Will return False is hostgroup does not exist, or named host or volume are not in the hostgroup. .. versionadded:: 2018.3.0 name : string name of hostgroup volume : string name of volume to remove from hostgroup host : string name of host to remove from hostgroup CLI Example: .. code-block:: bash salt '*' purefa.hg_remove foo volume=test host=bar NrR TFZhgrouprr ) r r7 r% rs rt r r" r9 rj )r$ rn r8 r r2 r r r � hg_remove� s> �� ��ru c C s t � }|du rE|du rE|du rEt| |�du rCz|�| � W n tjy( Y dS w z |j| |d� W dS tjyB t| � Y dS w dS td |||��r t| |�du �r z|�| � W n tjyh Y dS w z |j| |d� W n tjy� t| � Y dS w |dur�t||�dur�z |j| |gd� W dS tjy� t| � Y dS w t| � dS |dur�t ||�dur�z |j| |gd� W dS tjy� t| � Y dS w t| � dS |du�r t ||�du�rz |j| |gd� W dS tj�y t| � Y dS w t| � dS dS dS dS ) a. Create a protection group on a Pure Storage FlashArray. Will return False is the following cases: * Protection Grop already exists * Protection Group in a deleted state * More than one type is specified - protection groups are for only hostgroups, hosts or volumes * Named type for protection group does not exist .. versionadded:: 2018.3.0 name : string name of protection group hostgroup : string name of hostgroup to add to protection group host : string name of host to add to protection group volume : string name of volume to add to protection group CLI Example: .. code-block:: bash salt '*' purefa.pg_create foo [hostgroup=foo | host=bar | volume=vol] enabled=[true | false] NF)Z snap_enabledTz value.xor�Z addhgrouplistri �Z addvollist) r r3 Z create_pgroupr r" � set_pgroup� pg_deleterQ r7 r9 r% )r$ r6 r8 rn �enabledr r r r � pg_create� s� ������ �� r{ c C s t � }t| |�}|du�r |dur5|d dur5t||�dur3z |�|| � W dS tjy2 Y dS w dS |dur]|d dur]t||�dur[z |�|| � W dS tjyZ Y dS w dS |dur�|d dur�t||�dur�z |� || � W dS tjy� Y dS w dS |d du �r |d du �r |d du �r |dur�t||�dur�z |j | |gd� W dS tjy� Y dS w dS |dur�t||�dur�z |j | |gd� W dS tjy� Y dS w dS |du�r t||�du�rz |j | |gd � W dS tj�y Y dS w dS dS dS dS ) a� Update a protection group on a Pure Storage FlashArray. Will return False in the following cases: * Protection group does not exist * Incorrect type selected for current protection group type * Specified type does not exist .. versionadded:: 2018.3.0 name : string name of protection group hostgroup : string name of hostgroup to add to protection group host : string name of host to add to protection group volume : string name of volume to add to protection group CLI Example: .. code-block:: bash salt '*' purefa.pg_update foo [hostgroup=foo | host=bar | volume=vol] N�hgroupsTFrq �volumesrv ri rw ) r r3 r7 Z add_hgroupr r" r9 Zadd_hostr% Z add_volumerx �r$ r6 r8 rn r r1 r r r � pg_update' s~ � � ��� �� r c C rK )a3 Delete a protecton group on a Pure Storage FlashArray. Will return False if protection group is already in a deleted state. .. versionadded:: 2018.3.0 name : string name of protection group CLI Example: .. code-block:: bash salt '*' purefa.pg_delete foo NFT)r r3 Zdestroy_pgroupr r" �eradicate_pgrouprL r r r ry � s � �ry c C rN )a= Eradicate a deleted protecton group on a Pure Storage FlashArray. Will return False if protection group is not in a deleted state. .. versionadded:: 2018.3.0 name : string name of protection group CLI Example: .. code-block:: bash salt '*' purefa.pg_eradicate foo NTF)r r5 r� r r" r# r r r � pg_eradicate� rP r� c C s t � }t| |�}|dur�|dur4|d dur4t||�dur2z |�|| � W dS tjy1 Y dS w dS |dur\|d dur\t||�durZz |�|| � W dS tjyY Y dS w dS |dur�|d dur�t||�dur�z |� || � W dS tjy� Y dS w dS dS dS )a� Remove a hostgroup, host or volume from a protection group on a Pure Storage FlashArray. Will return False in the following cases: * Protection group does not exist * Specified type is not currently associated with the protection group .. versionadded:: 2018.3.0 name : string name of hostgroup hostgroup : string name of hostgroup to remove from protection group host : string name of host to remove from hostgroup volume : string name of volume to remove from hostgroup CLI Example: .. code-block:: bash salt '*' purefa.pg_remove foo [hostgroup=bar | host=test | volume=bar] Nr| TFrq r} ) r r3 r7 Z remove_hgroupr r" r9 Z remove_hostr% Z remove_volumer~ r r r � pg_remove� s@ � � �r� )N)NF)F)NNN)NN)NNNT).�__doc__r r r Zsalt.exceptionsr r r � ImportErrorZ __docformat__r r r ZDEFAULT_PASSWORD_SYMBOLSr r r% r) r. r3 r5 r7 r9 r@ rE rF rJ rM rO rS rZ r[ r] r_ rf rg rh ro rp rk ru r{ r ry r� r� r r r r �<module> s` & � 5 & * ! &' % .- ! <2 # 8/ % 9 _ a%
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings