[FEATURE REQUEST] RESTful API: Veeam organization id on repository users

[Integri_Sander]

Hello,

We have a situation where we want to retrieve backup repository users tied to a certain tenant, using this call: https://helpcenter.veeam.com/archive/vb ... rdata.html.

The property "organizationId" is of the following structure: "xxx.onmicrosoft.com:00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000".
This seems to be structured around how the object is retrieved from Microsoft (as explained to me by Veeam support).

To tie a user to its tenant we used to extract the tenant name (obtained from the following call: https://helpcenter.veeam.com/archive/vb ... ns_id.html) from the "organizationId" parameter.

It has come to our attention recently though that a tenant can change its name in the VBO application.
When this happens, we can no longer obtain the tenant name through the previously mentioned method and we can no longer tie a user to its organization.

It would be great if it was possible to add the Id of the organization in Veeam (the GUID) to a parameter on the user object so it's easier to tie these together.

Kind regards

Case #04889818

[nielsengelen]

Hi Sander, I may be missing a point here but if you want to get the users from an organization, why not use GET https://<hostname>:4443/v5/Organizations/{organizationId}/Users?displayName=<display_name/name>&username=<user_name>?

[Integri_Sander]

Hello Niels,

Thank you for your response.

The call you linked refers to all users of an organization (including ones that aren't backed up).
When we get the users from a backup repository, we only get the backed up users.

Kind regards

[nielsengelen]

What about using the licensing endpoint for this? It has 2 values: isBackedup & lastBackupDate.

[Integri_Sander]

Sadly this endpoint doesn't contain all the necessary parameters which the backup repository users call does return.
Specifically: "isMailboxBackedUp", "isOneDriveBackedUp", "isArchiveBackedUp", "isPersonalSiteBackedUp"

We currently have an overview of backed up users, from this overview we allow navigation to a restore session for either Exchange (+ archive), OneDrive, or personal SharePoint.

If the licensing endpoint provided us these parameters, then that would solve our issue as well.

[nielsengelen]

I have this logic currently in my community portal project and use this as a workaround.

1. First I use the licensing endpoint to gather the email, isBackedup, lastBackupDate & licenseState
2. I get the repositories for the organization and the information for exchange/OneDrive/SharePoint (id, email, name, isMailboxBackedUp, isOneDriveBackedUp, isArchiveBackedUp, isPersonalSiteBackedUp)
3. I match the email addresses and it allows me to show them all at once on a page.

The code is available via my GitHub.

[Integri_Sander]

Thanks for the solution Niels, I will consider implementing it this way.

My only worry is about performance, since the call to obtain users from a backup repository can be rather slow (especially on large environments).
Adding another call on top of this could add quite some time to the total duration.

[Integri_Sander]

Quick update:

It seems that if you use the parameter "officeName", you can reliably filter backed up users from a backup repository.
https://helpcenter.veeam.com/docs/vbo36 ... tml?ver=50

The parameter is only visible in the response body of the example so I was unaware that it existed.

Kind regards

[nielsengelen]

Hi Sander, thanks for the update. Good to know for future reference.