synology_apm_repo.sdk.units.verify_extents module

Per-workload-type extent resolution for units.verify_reachable: turns a Version into the composition extents its content lives in.

async synology_apm_repo.sdk.units.verify_extents.composition_extents_for_version(repo, version, saas_streams)

Every composition record this version’s content lives in — one per VM disk image (skipping one in a data_format this SDK can’t read), one per PC/PS disk fragment, one for an FS version’s dedup.img or a SaaS version’s saas_obj. Resolved through each workload type’s own provider/stream; guest filesystems and SaaS items are not walked, being byte-range views into these same records. saas_streams is the caller’s run-scoped cache.

Returns (extents, findings): a per-disk/fragment resolution failure is folded into findings rather than raised. FS/SaaS always return an empty findings.

Raises:

ApmRepoError – This version’s metadata claims it should resolve to real content but doesn’t resolve at all — the caller turns this into a Stage.VERSION Finding.

synology_apm_repo.sdk.units.verify_extents.unresolvable_finding(label, exc, *, missing_suffix='possibly a stale/rotated reference', ref=None)

A Stage.VERSION Finding for a catalog/workload/version that couldn’t be enumerated or resolved, or a single disk/fragment’s own resolution failure. NotFoundError is Symptom.DATA_MISSING, explained by missing_suffix (by default, “possibly a stale/rotated reference”); any other ApmRepoError is Symptom.CORRUPTION.