Skip to content

Cloud Storage Client API

This page documents the abstract Client class and the factory functions for cloud storage clients.

Bases: ABC

Defines the common operations that any cloud storage client should support.

upload_object(container_name, object_name, data) abstractmethod

Upload data as an object inside a container.

Implementations should return :class:UploadResult or a provider-specific result object, or None if they do not expose structured outcomes.

download_object(container_name, object_name) abstractmethod

Download and return the data of an object from a container.

delete_object(container_name, object_name) abstractmethod

Delete an object from a container.

Implementations should return :class:DeleteResult or a provider-specific result object.

list_objects(container_name) abstractmethod

Return the names of all objects stored in a container.