synology_apm_repo.sdk.units.dispatch module¶
Provider dispatch. Lives in units, not catalog, so catalog never
has to import units and form a cycle. target_type in {VM,PC,PS} ->
DeviceProvider; FS -> FsProvider; SaaS (GWS/M365) routes through
saas_provider_for, which picks an application-layer provider by the
owning Workload’s catalog-derived sub_type and degrades to
RawObjectProvider on recognition failure.
- synology_apm_repo.sdk.units.dispatch.SUPPORTED_SAAS_SUB_TYPES = frozenset({SaasSubType.CALENDAR, SaasSubType.CONTACT, SaasSubType.DRIVE, SaasSubType.GROUP_EXCHANGE, SaasSubType.MAIL, SaasSubType.SITE, SaasSubType.TEAMS, SaasSubType.TEAM_DRIVE, SaasSubType.USER_CHAT, SaasSubType.USER_DRIVE, SaasSubType.USER_EXCHANGE})¶
Workload.sub_typevaluessaas_provider_forcan attempt a provider for.
- synology_apm_repo.sdk.units.dispatch.is_supported(workload)¶
Whether
workloadhas a chance at an application-layer provider (aDEVICE_TARGET_TYPEStype viaprovider_for, or aSUPPORTED_SAAS_SUB_TYPESsub_type viasaas_provider_for) — a plain, no-I/O check.Truedoesn’t guarantee every version resolves (a PC/PS version can have every disk fragment unresolvable).
- async synology_apm_repo.sdk.units.dispatch.provider_for(repo, version)¶
Return the right
ClosableUnitProviderforversion, based on itstarget_typealone (VM/PC/PS/FS only). Does no I/O.- Raises:
UnsupportedDataFormatError –
version.target_typeis a SaaS type (GWS/M365) — those need the owningWorkloadtoo (forsub_type); callsaas_provider_forinstead.
- async synology_apm_repo.sdk.units.dispatch.saas_provider_for(repo, workload, version, saas_streams)¶
Route one SaaS
Versionto its application-layer provider(s), by the owningWorkload.sub_type. Tries every candidate, since M365’sUSER_EXCHANGE/GROUP_EXCHANGEcan hold Mail, Contact and Calendar in one version. Zero matches degrades toRawObjectProvider; exactly one is returned directly; more than one is wrapped inCompositeSaasProvider.saas_streamsis borrowed by every candidate and the fallback, so a stream opened here is reused by later calls.