Part of libcloud.storage.drivers.s3 View Source View In Hierarchy
Known subclasses: libcloud.storage.drivers.google_storage.GoogleStorageDriver, libcloud.storage.drivers.s3.S3APNEStorageDriver, libcloud.storage.drivers.s3.S3APSEStorageDriver, libcloud.storage.drivers.s3.S3EUWestStorageDriver, libcloud.storage.drivers.s3.S3USWestOregonStorageDriver, libcloud.storage.drivers.s3.S3USWestStorageDriver
| Method | list_containers | Return a list of containers. |
| Method | list_container_objects | Return a list of objects for the given container. |
| Method | get_container | Return a container instance. |
| Method | get_object | Return an object instance. |
| Method | create_container | Create a new container. |
| Method | delete_container | Delete a container. |
| Method | download_object | Download an object to the specified destination path. |
| Method | download_object_as_stream | Return a generator which yields object data. |
| Method | upload_object | @inherits: L{StorageDriver.upload_object} |
| Method | upload_object_via_stream | @inherits: L{StorageDriver.upload_object_via_stream} |
| Method | delete_object | Delete an object. |
| Method | _clean_object_name | Undocumented |
| Method | _get_more | Undocumented |
| Method | _put_object | Undocumented |
| Method | _to_containers | Undocumented |
| Method | _to_objs | Undocumented |
| Method | _to_container | Undocumented |
| Method | _headers_to_object | Undocumented |
| Method | _to_obj | Undocumented |
Inherited from StorageDriver:
| Method | __init__ | @param key: API key or username to used (required) @type key: C{str} |
| Method | get_container_cdn_url | Return a container CDN URL. |
| Method | get_object_cdn_url | Return a object CDN URL. |
| Method | enable_container_cdn | Enable container CDN. |
| Method | enable_object_cdn | Enable object CDN. |
| Method | _get_object | Call passed callback and start transfer of the object' |
| Method | _save_object | Save object to the provided path. |
| Method | _upload_object | Helper function for setting common request headers and calling the passed in callback which uploads an object. |
| Method | _upload_data | Upload data stored in a string. |
| Method | _stream_data | Stream a data over an http connection. |
| Method | _upload_file | Upload a file to the server. |
| Method | _get_hash_function | Return instantiated hash function for the hash type supported by the provider. |
Inherited from BaseDriver (via StorageDriver):
| Method | _ex_connection_class_kwargs | Return extra connection keyword arguments which are passed to the Connection class constructor. |
Return a list of containers.
@return: A list of Container instances.
@rtype: C{list} of L{Container}
Return a list of objects for the given container.
@param container: Container instance
@type container: L{Container}
@return: A list of Object instances.
@rtype: C{list} of L{Object}
Return a container instance.
@param container_name: Container name.
@type container_name: C{str}
@return: L{Container} instance.
@rtype: L{Container}
Return an object instance.
@param container_name: Container name.
@type container_name: C{str}
@param object_name: Object name.
@type object_name: C{str}
@return: L{Object} instance.
@rtype: L{Object}
Create a new container.
@type container_name: C{str}
@param container_name: Container name.
@return: C{Container} instance on success.
@rtype: L{Container}
Delete a container.
@type container: L{Container}
@param container: Container instance
@return: True on success, False otherwise.
@rtype: C{bool}
Download an object to the specified destination path.
@param obj: Object instance.
@type obj: L{Object}
@param destination_path: Full path to a file or a directory where the
incoming file will be saved.
@type destination_path: C{str}
@param overwrite_existing: True to overwrite an existing file,
defaults to False.
@type overwrite_existing: C{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: C{bool}
@return: True if an object has been successfully downloaded, False
otherwise.
@rtype: C{bool}
Return a generator which yields object data.
@param obj: Object instance
@type obj: L{Object}
@param chunk_size: Optional chunk size (in bytes).
@type chunk_size: C{int}
@rtype: C{object}
@inherits: L{StorageDriver.upload_object}
@param ex_storage_class: Storage class
@type ex_storage_class: C{str}
@inherits: L{StorageDriver.upload_object_via_stream}
@param ex_storage_class: Storage class
@type ex_storage_class: C{str}
Delete an object.
@type obj: L{Object}
@param obj: Object instance.
@return: C{bool} True on success.
@rtype: C{bool}