Permission Level Transfer/Transfer Permissions



On This Page

Overview

The Permission Level Transfer Report can be exported through the DryvIQ Platform user interface or through the REST API. It 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 Permission Level Transfer 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/Analyzer

  • Transfer in one direction with copy & both directions with sync

  • Jobs using Impersonation / Run as user

 

Exporting the Report in the User Interface

The Permission report available for export in the DryvIQ user interface is a full permission export. The report is saved as a CSV file in your default downloads location. (Some browsers will also display the file at the bottom of the browser window for quick access.) You can export the report from the Jobs and Reports areas.

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.

Exporting the Report through Jobs

  1. Select Jobs.

  2. Select the job for which you want to view the report.

  3. Select Sharing Insights.

  4. Select Export full permissions report.

Exporting the Report through Reports

If a report includes multiple jobs, the export will include the permissions for all jobs in the report group.

  1. Select Reports.

  2. Select View full report on the report widget for which you want to view the report.

  3. Select Sharing Insights.

  4. Select Export full permissions report.

 


Exporting the Report Through the REST API

When exporting the report using a REST API call, you have the option of receiving a link through the call or viewing the CSV data within the response.

The following request produces a response that contains an href link. Copy and paste the link into your browser to download the CSV file.  

GET {{url}}v1/transfers/permissions

View the CSV in the response

The following request produces a response that contains the report information in CSV format within the body of the message.

GET {{url}}v1/transfers/permissions.csv

Override the Truncation Limit

Since the UI export only includes one million records, you can pull the report using the API to override the truncation limit. This is done by adding the page= and limit= parameters to the GET request. This allows you to pull the full report by page if needed.

GET {{url}}v1/transfers/permissions.csv?page=#&limit=#

Be sure to include both the page= and limit= parameter. If you only add the page= parameter, the report results will default to 100 and not one million.

Requesting Specific Permissions Through the REST API

Through the REST API, you have the option to request permissions by job, user/account map, item, audit trail, or a combination of each. Each can be passed in as a query string parameter. See the examples below for usage.

 

Option

Description

QUERY STRING PARAMETER

Example

Option

Description

QUERY STRING PARAMETER

Example

Transfer Item ID’s

The transfer item identifier for the item located on the source platform

"item"

"item_id"

"transfer_item_id"

"items"

"item_ids"

"transfer_item_ids"

Include

The indicator to include all

“all”

Security Map ID’s
(ID assigned to a user through the User / Account map)

The identifier assigned to the user mapped in the job leveraging the user / account map

"security_map"

"security_maps"

"security_map_id"

"security_map_ids"

Job ID’s

The identifier assigned to the job transferring the permissions and content

"job"

"jobs"

"job_id"

"job_ids"

audit_trail

The audit category for content

“null” (the permissions are new and haven’t been applied to the destination)

“created-by”

“modified-by”

 

Example Requests

The following examples show how to use the query parameters in combination with each other.

In this example, the permission report request is for 2 jobs, for 3 users and 1 specific item (such as a folder)

 

In this example, the permission report request will return all transfer permission levels by security map id’s for all items for a given job

 

 

DryvIQ Migrate Version: 5.6.1.4136
Release Date: February 9, 2024