Synology APM Repository SDKΒΆ

Offline, read-only Python SDK for Synology APV/Object-Storage dedup repository formats.

Installation

pip install synology-apm-repo-sdk

Quick start

import asyncio
from synology_apm_repo.sdk import Session

async def main():
    async with Session() as session:
        async for repo in session.discover("/path/to/repository"):
            if repo.is_encrypted:
                verification = await repo.set_key("<userKeyID>@<base64 userKey>")
                if not verification.ok:
                    print(f"wrong key for {repo}")
                    continue
            for catalog in await repo.catalogs():
                for workload in await catalog.workloads():
                    print(workload.display_name)

asyncio.run(main())

Repository & catalog

Dedup engine

On-disk format primitives

Storage backends

Restorable units

Content Layer (units/content/)

SaaS workloads (M365 / GWS)

Profiles & presentation