AuroraObjects Storage Driver Documentation ========================================== `PCextreme B.V.`_ is a Dutch cloud provider. It provides a public cloud offering under the name AuroraCompute. All cloud services are under the family name Aurora. All data is stored on servers in the European Union. .. figure:: /_static/images/provider_logos/pcextreme.png :align: center :width: 300 :target: https://www.pcextreme.com/aurora/objects Protocol -------- AuroraObjects talks the Amazon S3 protocol and thus supports almost all functions which the Amazon S3 storage driver supports. It however does not support CDN support. Calling any of the CDN functions will raise a LibcloudError. As a backend AuroraObjects uses `Ceph`_ for storage. Instantiating a driver ---------------------- When instantiating the AuroraObjects you need a access key and secret key. These can be obtained from the `Control Panel`_ of AuroraObjects. With these credentials you can instantiate the driver: .. literalinclude:: /examples/storage/auroraobjects/instantiate.py :language: python Multipart uploads ----------------- AuroraObjects storage driver supports multipart uploads which means you can upload objects with a total size of up to 5 TB. Multipart upload works similar to Amazon S3. After uploading all the parts the AuroraObjects servers combine the parts into one large object. If you use :meth:`libcloud.storage.base.StorageDriver.upload_object_via_stream` method, Libcloud transparently handles all the splitting and uploading of the parts for you. By default, to prevent excessive buffering and use of memory, each part is 5 MB in size. This is also the smallest size of a part you can use with the multi part upload. Examples -------- Please refer to the Amazon S3 storage driver documentation for examples. API Docs -------- .. autoclass:: libcloud.storage.drivers.auroraobjects.AuroraObjectsStorageDriver :members: :inherited-members: .. _`PCextreme B.V.`: https://www.pcextreme.com/ .. _`Ceph`: https://ceph.com/ .. _`Control Panel`: https://cp.pcextreme.nl/