Python: Storage
Create and configure buckets, list, move and delete objects, and issue signed upload and download URLs with the Python SDK.
await sovaria.store_create_bucket({"name": "invoices", "public": False})
link = await sovaria.store_sign_download("invoices", f"{user_id}/2026-10.pdf", expires_in=3600)
print(link["url"])Methods
sovaria.store_create_bucket
Store create bucket.
await sovaria.store_create_bucket(
body: dict[str, Any],
) -> dict[str, Any]Parameters
bodydict[str, Any]required
- Returns
dict[str, Any]
sovaria.store_delete
Delete a Vault path.
await sovaria.store_delete(path: str) -> AnyParameters
pathstrrequired
- Returns
Any
sovaria.store_delete_bucket
Store delete bucket.
await sovaria.store_delete_bucket(name: str) -> dict[str, Any]Parameters
namestrrequired
- Returns
dict[str, Any]
sovaria.store_get
Read from a Vault path.
await sovaria.store_get(
path: str,
*, params: dict[str, str] | None = None,
) -> AnyParameters
pathstrrequiredparamsdict[str, str] | NoneoptionaldefaultNone
- Returns
Any
sovaria.store_get_bucket
Store get bucket.
await sovaria.store_get_bucket(name: str) -> dict[str, Any]Parameters
namestrrequired
- Returns
dict[str, Any]
sovaria.store_list_buckets
Store list buckets.
await sovaria.store_list_buckets() -> list[dict[str, Any]]- Returns
list[dict[str, Any]]
sovaria.store_list_objects
Store list objects.
await sovaria.store_list_objects(
bucket: str,
*, prefix: str = '',
limit: int | None = None,
offset: int | None = None,
) -> list[dict[str, Any]]Parameters
bucketstrrequiredprefixstroptionaldefault''limitint | NoneoptionaldefaultNoneoffsetint | NoneoptionaldefaultNone
- Returns
list[dict[str, Any]]
sovaria.store_move_object
Store move object.
await sovaria.store_move_object(
from_path: str,
to_path: str,
) -> dict[str, Any]Parameters
from_pathstrrequiredto_pathstrrequired
- Returns
dict[str, Any]
sovaria.store_put_json
Write JSON payload to a Vault path.
await sovaria.store_put_json(path: str, payload: dict[str, Any]) -> AnyParameters
pathstrrequiredpayloaddict[str, Any]required
- Returns
Any
sovaria.store_request
Call a Vault endpoint under /api/v1/store/*.
await sovaria.store_request(
method: str,
path: str,
*, json: dict[str, Any] | list[Any] | None = None,
params: dict[str, str] | None = None,
requires_auth: bool = True,
) -> AnyParameters
methodstrrequiredpathstrrequiredjsondict[str, Any] | list[Any] | NoneoptionaldefaultNoneparamsdict[str, str] | NoneoptionaldefaultNonerequires_authbooloptionaldefaultTrue
- Returns
Any
sovaria.store_sign_download
Store sign download.
await sovaria.store_sign_download(
bucket: str,
object_path: str,
*, expires_in: int | None = None,
) -> dict[str, Any]Parameters
bucketstrrequiredobject_pathstrrequiredexpires_inint | NoneoptionaldefaultNone
- Returns
dict[str, Any]
sovaria.store_sign_upload
Store sign upload.
await sovaria.store_sign_upload(
bucket: str,
object_path: str,
*, expires_in: int | None = None,
) -> dict[str, Any]Parameters
bucketstrrequiredobject_pathstrrequiredexpires_inint | NoneoptionaldefaultNone
- Returns
dict[str, Any]
sovaria.store_update_bucket
Store update bucket.
await sovaria.store_update_bucket(
name: str,
body: dict[str, Any],
) -> dict[str, Any]Parameters
namestrrequiredbodydict[str, Any]required
- Returns
dict[str, Any]
Something unclear or missing on this page?Tell us