Current File : //usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l m
Z e j e
� Z d Z yu d d l Z d d l m Z e e d � r� e e j � e e � k r� e � � n e j d � j e j � e Z Wn e k
r� e Z n Xd � Z d
� Z d � Z d � Z d
� Z d � Z d � Z! d � Z" e e d � Z# d e d d � Z% d � Z& d � Z' d � Z( d S( u
Apache Libcloud Storage Management
==================================
Connection module for Apache Libcloud Storage (object/blob) management for a full list
of supported clouds, see http://libcloud.readthedocs.io/en/latest/storage/supported_providers.html
Clouds include Amazon S3, Google Storage, Aliyun, Azure Blobs, Ceph, OpenStack swift
.. versionadded:: 2018.3.0
:configuration:
This module uses a configuration profile for one or multiple Storage providers
.. code-block:: yaml
libcloud_storage:
profile_test1:
driver: google_storage
key: GOOG0123456789ABCXYZ
secret: mysecret
profile_test2:
driver: s3
key: 12345
secret: mysecret
:depends: apache-libcloud
i ( t absolute_importt unicode_literalst print_functionN( t LooseVersionu 1.5.0( t
get_driveru __version__u libcloudc C@ s# t s d j t � } t | f St S( u0
Only load if libcloud libraries exist.
uA A apache-libcloud library with version at least {0} was not found( t HAS_LIBCLOUDt formatt REQUIRED_LIBCLOUD_VERSIONt Falset True( t msg( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyt __virtual__< s
c C@ s t j j j t � d S( N( t saltt utilst compatt pack_dundert __name__( t opts( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyt __init__G s c C@ s� t d d � | } t | d � } | j � } | d =| j d � | d <| j d d � | d <| j d t � | d <| j d d � | d <| j d d � | d <| | � S( Nu
config.optionu libcloud_storageu driveru keyu secretu secureu hostu port( t __salt__R t copyt gett NoneR ( t profilet configt clst args( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyt _get_driverK s c K@ so t d | � } t j j j | � } | j | � } g } x/ | D]' } | j i | j d 6| j d 6� q@ W| S( uN
Return a list of containers.
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_containers method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.list_containers profile1
R u nameu extra( R R R
R t clean_kwargst list_containerst appendt namet extra( R t libcloud_kwargst connt
containerst rett container( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR X s
c K@ s� t d | � } | j | � } t j j j | � } | j | | � } g } xZ | D]R } | j i | j d 6| j d 6| j
d 6| j j d 6| j d 6| j
d 6� qR W| S( u�
List container objects (e.g. files) for the given container_id on the given profile
:param container_name: Container name
:type container_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's list_container_objects method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.list_container_objects MyFolder profile1
R u nameu sizeu hashu containeru extrau meta_data( R t
get_containerR R
R R t list_container_objectsR R t sizet hashR% R t meta_data( t container_nameR R! R" R% t objectsR$ t obj( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR' t s
c K@ sN t d | � } t j j j | � } | j | | � } i | j d 6| j d 6S( u�
Create a container in the cloud
:param container_name: Container name
:type container_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's create_container method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.create_container MyFolder profile1
R u nameu extra( R R R
R R t create_containerR R ( R+ R R! R" R% ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR. � s
c K@ sN t d | � } t j j j | � } | j | | � } i | j d 6| j d 6S( u�
List container details for the given container_name on the given profile
:param container_name: Container name
:type container_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's get_container method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.get_container MyFolder profile1
R u nameu extra( R R R
R R R& R R ( R+ R R! R" R% ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR& � s
c K@ s| t d | � } t j j j | � } | j | | | � } i | j d 6| j d 6| j d 6| j j d 6| j
d 6| j d 6S( u'
Get the details for a container object (file or object in the cloud)
:param container_name: Container name
:type container_name: ``str``
:param object_name: Object name
:type object_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's get_container_object method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.get_container_object MyFolder MyFile.xyz profile1
R u nameu sizeu hashu containeru extrau meta_data( R R R
R R t get_container_objectR R( R) R% R R* ( R+ t object_nameR R! R" R- ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR/ � s
c K@ sO t d | � } | j | | � } t j j j | � } | j | | | | | � S( u�
Download an object to the specified destination path.
:param container_name: Container name
:type container_name: ``str``
:param object_name: Object name
:type object_name: ``str``
:param destination_path: Full path to a file or a directory where the
incoming file will be saved.
:type destination_path: ``str``
:param profile: The profile key
:type profile: ``str``
:param overwrite_existing: True to overwrite an existing file,
defaults to False.
:type overwrite_existing: ``bool``
:param delete_on_failure: True to delete a partially downloaded file if
the download was not successful (hash
mismatch / file size).
:type delete_on_failure: ``bool``
:param libcloud_kwargs: Extra arguments for the driver's download_object method
:type libcloud_kwargs: ``dict``
:return: True if an object has been successfully downloaded, False
otherwise.
:rtype: ``bool``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.download_object MyFolder me.jpg /tmp/me.jpg profile1
R ( R t
get_objectR R
R R t download_object( R+ R0 t destination_pathR t overwrite_existingt delete_on_failureR! R" R- ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR2 � s )c K@ s[ t d | � } t j j j | � } | j | � } | j | | | | | | | � }
|
j S( u
Upload an object currently located on a disk.
:param file_path: Path to the object on disk.
:type file_path: ``str``
:param container_name: Destination container.
:type container_name: ``str``
:param object_name: Object name.
:type object_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param verify_hash: Verify hash
:type verify_hash: ``bool``
:param extra: Extra attributes (driver specific). (optional)
:type extra: ``dict``
:param headers: (optional) Additional request headers,
such as CORS headers. For example:
headers = {'Access-Control-Allow-Origin': 'http://mozilla.com'}
:type headers: ``dict``
:param libcloud_kwargs: Extra arguments for the driver's upload_object method
:type libcloud_kwargs: ``dict``
:return: The object name in the cloud
:rtype: ``str``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.upload_object /file/to/me.jpg MyFolder me.jpg profile1
R ( R R R
R R R& t
upload_objectR ( t file_pathR+ R0 R R t verify_hasht headersR! R" R% R- ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR6 ! s
)!c K@ sF t d | � } t j j j | � } | j | | | � } | j | � S( uc
Delete an object in the cloud
:param container_name: Container name
:type container_name: ``str``
:param object_name: Object name
:type object_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's delete_object method
:type libcloud_kwargs: ``dict``
:return: True if an object has been successfully deleted, False
otherwise.
:rtype: ``bool``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.delete_object MyFolder me.jpg profile1
R ( R R R
R R R1 t
delete_object( R+ R0 R R! R" R- ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR: Q s c K@ sC t d | � } t j j j | � } | j | � } | j | | � S( u1
Delete an object container in the cloud
:param container_name: Container name
:type container_name: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's delete_container method
:type libcloud_kwargs: ``dict``
:return: True if an object container has been successfully deleted, False
otherwise.
:rtype: ``bool``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.delete_container MyFolder profile1
R ( R R R
R R R& t delete_container( R+ R R! R" R% ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR; q s c K@ s= t j j j | � } t d | � } t | | � } | | � S( u�
Call an extended method on the driver
:param method: Driver's method name
:type method: ``str``
:param profile: The profile key
:type profile: ``str``
:param libcloud_kwargs: Extra arguments for the driver's delete_container method
:type libcloud_kwargs: ``dict``
CLI Example:
.. code-block:: bash
salt myminion libcloud_storage.extra ex_get_permissions google container_name=my_container object_name=me.jpg --out=yaml
R ( R R
R R R t getattr( t methodR R! R" t connection_method( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyR � s () t __doc__t
__future__R R R t loggingt salt.utils.argsR t salt.utils.compatt salt.utils.versionsR t
_LooseVersiont getLoggerR t logR t libcloudt libcloud.storage.providersR t hasattrt __version__t ImportErrort setLevelt CRITICALR R R R R R R R' R. R& R/ R2 R R6 R: R; R ( ( ( sA /usr/lib/python2.7/site-packages/salt/modules/libcloud_storage.pyt <module> s< *
$ #./
Mini Shell