...
On This Page
| Table of Contents |
|---|
Overview
The The Migrate Sharing Insights tab offers a breakdown of all permissions associated to your content (based on the source content). It shows the overall breakdown of how content is shared and the top user and group contributors. You can quickly identify the most shared files and folders. You even have the option to export a full permissions report to view the permissions assigned to each item in the transfer.
On the Shared Insights tab for a job, the The value "Not Shared" represents both items that have no permissions as well as content shared by inheritance from the parent folder. At this time, DryvIQ only tracks permissions applied during transfer; , not permissions that result from inheritance within the hierarchy.
...
Sharing Insights Using the REST API
You can pull the information reported in the Sharing Insights using the REST API.
Get User Access Rules
...
GET {{url}}v1/transfers/{{job_id/stats/by_sharing?field=user_access_rules
...
| Code Block |
|---|
{
"status": 200,
"item": {
"user_access_rules": {
"name": "Shared to users",
"source": {
"bytes": 14049,
"files": 8,
"folders": 13,
"versions": 9,
"storage": 15234
},
"destination": {
"bytes": 14049,
"files": 8,
"folders": 13
},
"order": 1
},
"group_access_rules": {
"name": "Shared to groups",
"source": {
"bytes": 297,
"files": 1,
"folders": 3,
"versions": 1,
"storage": 297
},
"destination": {
"bytes": 297,
"files": 1,
"folders": 3
},
"order": 2
},
"domain_shared_links": {
"name": "Shared to domain via link",
"source": null,
"destination": null,
"order": 3
},
"anyone_shared_links": {
"name": "Shared to anyone via link",
"source": null,
"destination": null,
"order": 4
},
"": {
"name": "Not shared",
"source": {
"bytes": 5416715,
"files": 20,
"folders": 9,
"versions": 20,
"storage": 5416715
},
"destination": {
"bytes": 5416715,
"files": 20,
"folders": 10
},
"order": 5
}
}
} |
Top User Contributors
The "resolution" indicates how the permission was mapped, such as by exception mapping, account map, email, or external account. The "permissions" value indicates how many items are shared with the user.
...
GET {{url}}v1/transfers/security_map?job={{job_id&type=account&exclude_unused=true&fields=source%2Cpermissions&sort=permission
...
| Code Block |
|---|
.......
...........
},
"item": [
{
"id": "54604b5d86a344ca8040f73f867cc980",
"source": {
"name": "John Smith 2",
"email": "jsmith2@email.com",
"id": "1497385045",
"type": "account"
},
"resolution": "exception",
"permissions": 6
},
{
"id": "44b1bf8179f9467b8f91126cba578bee",
"source": {
"name": "John Smith 3",
"email": "jsmith3@email.com",
"id": "389034265",
"type": "account"
},
"resolution": "exception",
"permissions": 7
},
..........
...... |
Top Group Contributors
The "resolution" indicates how the permission was mapped; such as by exception mapping, or account map. The "permissions" value indicates how many items are shared with the group.
...
GET {{url}}v1/transfers/security_map?job={{job_id&type=group&exclude_unused=true&fields=source%2Cpermissions&sort=permissions%20desc&offset=0&limit=5
...
| Code Block |
|---|
.......
...........
},
"item": [
{
"id": "edb58a6038a940158a794d8d3aeaed61",
"source": {
"name": "Group_Name",
"id": "1281879819",
"type": "group"
},
"resolution": "exception",
"permissions": 4
}
..........
...... |
Shared Analysis/Most Shared Files
The "permissions" value indicates how this item is shared with users/groups.
...
GET {{url}}v1/transfers/items?job={{job_id&type=items&sort=permissions%20desc&permissions=1%3A&fields=id%2Cname%2Csource.path%2Cpermissions%2Ctype%2Ccount&offset=0&limit=5
...
| Code Block |
|---|
.......
...........
},
"item": [
{
"id": 568,
"parent_id": 542,
"type": "item",
"source": {
"name": "appSettings.json",
"ext": ".json",
"path": "/{{folderName}}/appSettings.json" }, "destination": { "name": "appSettings.json", "ext": ".json" }, "permissions": 5 }, .......... ...... |
...
The "count" is the number of child items shared. The "permissions" value indicates how this container is shared with users/groups.
...
GET {{url}}v1/transfers/folders?job={{job_id&type=items&sort=permissions%20desc&permissions=1%3A&fields=id%2Cname%2Csource.path%2Cpermissions%2Ctype%2Ccount&offset=0&limit=5
...
Exporting the Permissions Report
The full Permissions Report export provides the permissions assigned to each item at all levels of the hierarchy that were applied during transfer. The report includes only applied or equal permissions. The export does not include failed, skipped, or removed permissions. In addition to providing information for the permissions applied for a job, the export can be used as a tool to expedite the creation of new permission mappings. The Permissions Import feature will accept the format of the Sharing Insights Permissions export, so you can use the export to create new permission maps as needed. Simply export the report, edit permissions as needed, and import the the CSV file as the permission mapping for the job you are creating.
The following features use permissions and will all generate the information for the report:
Basic transfer, Folder mapping, User account mapping, Network home drive mapping
Simulation Mode
Transfer in one direction
Transfer in both directions (sync)
Jobs using Impersonation (Run as user)
| Note |
|---|
To ensure performance, the permissions export is limited to one million rows. If your permissions report has more than one million results, you can use the REST API to pull the report using paging to retrieve all the results, or you can export the report in chunks using the information on the Exporting Large Data Sets in Chunks page. |