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.imgor a SaaS version’ssaas_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_streamsis the caller’s run-scoped cache.Returns
(extents, findings): a per-disk/fragment resolution failure is folded intofindingsrather than raised. FS/SaaS always return an emptyfindings.- 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.VERSIONFinding.
- synology_apm_repo.sdk.units.verify_extents.unresolvable_finding(label, exc, *, missing_suffix='possibly a stale/rotated reference', ref=None)¶
A
Stage.VERSIONFindingfor a catalog/workload/version that couldn’t be enumerated or resolved, or a single disk/fragment’s own resolution failure.NotFoundErrorisSymptom.DATA_MISSING, explained bymissing_suffix(by default, “possibly a stale/rotated reference”); any otherApmRepoErrorisSymptom.CORRUPTION.