Unitrends UniView Spanning SaaS Backup
Overview
Spanning protects Microsoft 365 and Google Workspace mailboxes, drives and
sites. UniView lists each Spanning domain (tenant) with its origin, mapped
customer, user and license counts and expiration, and each domain's users with
their last backup status. All four Spanning tools are plain reads in Conduit;
none is admin-gated. Two of them return personal data.
Anti-triggers
- Appliance or endpoint backups: use
unitrends-uniview-backup-health-triage or
unitrends-uniview-protection-coverage.
- The user accounts themselves (licenses assigned in Microsoft 365, sign-in
state, offboarding): that is the tenant's own admin data, not Spanning's.
Use a Microsoft 365 plugin.
Key Concepts
| Tool |
Returns |
Personal data |
unitrends_uniview_spanning_domains_list |
Domains: origin, mapped customer, user and license counts, expiration |
Only with include: {"users": "true"} |
unitrends_uniview_spanning_domain_users_list |
One domain's users, active and archived, with last backup status and time |
Yes |
unitrends_uniview_spanning_domains_list_v1 |
Older v1 shape of the domain list |
Only with include: {"users": "true"} |
unitrends_uniview_spanning_domain_users_list_v1 |
Older v1 shape of the user list |
Yes |
Use the v2 tools (no _v1 suffix). Fall back to the v1 tools only when a field
you need is missing from v2.
Common Workflows
License and renewal review (all customers)
unitrends_uniview_spanning_domains_list with order_by: "number_of_users",
order_direction: "desc". Leave include unset so no user lists are
embedded. Page through every page.
- For each domain compare users with licenses:
- more users than licenses: users may be unprotected; true-up needed;
- far fewer users than licenses: over-licensed; reduce at renewal.
- List domains whose expiration falls in the next 60 days, by customer.
- List domains with no mapped customer; they are missing from per-customer
reporting and billing reconciliation.
Which users are not backing up (one domain)
- Find the domain in
unitrends_uniview_spanning_domains_list and take its ID.
unitrends_uniview_spanning_domain_users_list with that domain_id. Page
through every page.
- Report active users whose last backup status is not successful, or whose
last backup time is older than 48 hours. Archived users are expected to
stop backing up; list them separately.
Offboarding check
When a customer offboards a user, confirm the user's mailbox and drive were
backed up recently before the account is deleted: page through
unitrends_uniview_spanning_domain_users_list for the domain (the tool has no
user filter), find the user, and report the last backup time and status. The
API is read-only; archiving or restoring is done in Spanning.
Gotchas
- Do not embed users in the domain list.
include: {"users": "true"} adds
every user of every domain to one response. It is personal data and is often
too large to return. Use the per-domain user tool instead.
- The user tools return email addresses. Summarize counts in shared
channels and customer-facing reports; list names only to the technician who
needs them.
domain_id comes from the domain list. It is the Spanning domain or
tenant ID, not the customer UUID.
- Read every page. Large tenants have thousands of users; the default page
is 50.
Related Skills
1---2name: unitrends-uniview-spanning-saas-backup3description: >4 Spanning SaaS backup data in Unitrends UniView: Microsoft 365 and Google5 Workspace domains with their mapped customer, user and license counts and6 expiration, per-user last backup status, the v1 and v2 tool shapes, and the7 personal-data handling the user tools need. Covers license true-up, renewal8 and per-user backup failure reviews.9when_to_use: >-10 When reviewing Spanning backup for a customer's Microsoft 365 or Google11 Workspace tenant: license usage, upcoming expirations, or which users are not12 backing up. Use when: spanning backup, m365 backup, google workspace backup,13 spanning licenses, spanning expiration, saas backup users, or user not backed14 up.15metadata:16 source: https://skillmd.com/skills/wyre-ai/unitrends-uniview-spanning-saas-backup17---1819# Unitrends UniView Spanning SaaS Backup2021## Overview2223Spanning protects Microsoft 365 and Google Workspace mailboxes, drives and24sites. UniView lists each Spanning domain (tenant) with its origin, mapped25customer, user and license counts and expiration, and each domain's users with26their last backup status. All four Spanning tools are plain reads in Conduit;27none is admin-gated. Two of them return personal data.2829## Anti-triggers3031- **Appliance or endpoint backups**: use `unitrends-uniview-backup-health-triage` or32 `unitrends-uniview-protection-coverage`.33- **The user accounts themselves** (licenses assigned in Microsoft 365, sign-in34 state, offboarding): that is the tenant's own admin data, not Spanning's.35 Use a Microsoft 365 plugin.3637## Key Concepts3839| Tool | Returns | Personal data |40|------|---------|---------------|41| `unitrends_uniview_spanning_domains_list` | Domains: origin, mapped customer, user and license counts, expiration | Only with `include: {"users": "true"}` |42| `unitrends_uniview_spanning_domain_users_list` | One domain's users, active and archived, with last backup status and time | Yes |43| `unitrends_uniview_spanning_domains_list_v1` | Older v1 shape of the domain list | Only with `include: {"users": "true"}` |44| `unitrends_uniview_spanning_domain_users_list_v1` | Older v1 shape of the user list | Yes |4546Use the v2 tools (no `_v1` suffix). Fall back to the v1 tools only when a field47you need is missing from v2.4849## Common Workflows5051### License and renewal review (all customers)52531. `unitrends_uniview_spanning_domains_list` with `order_by: "number_of_users"`,54 `order_direction: "desc"`. Leave `include` unset so no user lists are55 embedded. Page through every page.562. For each domain compare users with licenses:57 - more users than licenses: users may be unprotected; true-up needed;58 - far fewer users than licenses: over-licensed; reduce at renewal.593. List domains whose expiration falls in the next 60 days, by customer.604. List domains with no mapped customer; they are missing from per-customer61 reporting and billing reconciliation.6263### Which users are not backing up (one domain)64651. Find the domain in `unitrends_uniview_spanning_domains_list` and take its ID.662. `unitrends_uniview_spanning_domain_users_list` with that `domain_id`. Page67 through every page.683. Report active users whose last backup status is not successful, or whose69 last backup time is older than 48 hours. Archived users are expected to70 stop backing up; list them separately.7172### Offboarding check7374When a customer offboards a user, confirm the user's mailbox and drive were75backed up recently before the account is deleted: page through76`unitrends_uniview_spanning_domain_users_list` for the domain (the tool has no77user filter), find the user, and report the last backup time and status. The78API is read-only; archiving or restoring is done in Spanning.7980## Gotchas8182- **Do not embed users in the domain list.** `include: {"users": "true"}` adds83 every user of every domain to one response. It is personal data and is often84 too large to return. Use the per-domain user tool instead.85- **The user tools return email addresses.** Summarize counts in shared86 channels and customer-facing reports; list names only to the technician who87 needs them.88- **`domain_id` comes from the domain list.** It is the Spanning domain or89 tenant ID, not the customer UUID.90- **Read every page.** Large tenants have thousands of users; the default page91 is 50.9293## Related Skills9495- [api-patterns](../api-patterns/SKILL.md): headers, paging, truncation, errors96- [protection-coverage](../protection-coverage/SKILL.md): all protection for one customer