...
On This Page
| Table of Contents |
|---|
Overview
The Migrate Items report is available when viewing information for individual jobs through the Jobs menu option and when viewing reports through the Reports menu optionroll-up reports. The Items report lists all items analyzed for the job(s) and the status of each item. The job overview statistics can be viewed by files or by folders, but the item statistics aggregates all items, including the files, folders, and the root folder.
| Info |
|---|
If an item name is too long to display fully in the list, you can hover on the name. This will display a pop-up that displays the full name of the item. |
Understanding the Status
...
Transfer Audit Category Description | Description | ID | ||
|---|---|---|---|---|
Access Failures | "Files and folders that have failed due to access failures." |
| ||
Access Rule Import Failures | "Failure importing access rule." |
| ||
Access Rule Warnings | "Unable to apply permissions due to an incompatible or unsupported access rule." |
| ||
Conflict Failures | "Files that have failed due to unresolved conflicts." |
| ||
Conflict Warnings | "Files that have a conflict copy created." |
| ||
Connectivity Failure | "Files and folders that have failed due to connectivity issues with the platform provider." |
| ||
Conventions Skipped | "Convention skipped due to an convention mapping failure." |
| ||
Duplicate Item Failures | "Files and folders that have failed because the platform does not allow duplicate names." |
| ||
Invalid Item Failures | "Files and folders that are invalid in the platform provider." |
| ||
IO Failures | "Files and folders that have failed for IO reasons." |
| ||
Item Locked Failures | "Item Locked Failures" |
| ||
Item Locked Warnings | "Files that have warnings when locked or unlocked." |
| ||
Item Not Found Failures | "Files and folders that have failed because they were not found in the platform provider." |
| ||
License Failures | "Files and folders that have failed due an unlicensed product feature." |
| ||
Permission Failures | "Files and folders that have failed because the authorized account does not have permission to access the resource." |
| ||
Policy Failures | "Files and folders that have failed for violating a policy imposed by the platform provider." |
| ||
Property Value Import Failures | "Failure importing property values." |
| ||
Property Value Import Warnings | "Property Value Import Warnings" |
| ||
Property Value Warnings | "Unable to transfer property values due to an invalid property map." |
| ||
Restricted Content Skipped | "Files that were skipped due to restricted content." |
| ||
Security Identifier Warnings | "Unable to apply permissions due to an invalid user or group." |
| ||
Unknown Failures | "Files and folders that have failed for unknown reasons." |
|
Items Report Using the REST API
List all Items
Use the following call to list all items for all jobs.
| Code Block |
|---|
GET {{url}}v1/transfers/items |
List all Items for a job
| Code Block |
|---|
GET {{url}}v1/transfers/{{job}}/items?fields=all |
List all files and folders for a specific job
| Code Block |
|---|
GET {{url}}v1/transfers/items?jobs={{job}}&fields=all |
List Items by Parent Folder
For a given job, this call returns all items within a folder.
| Code Block |
|---|
GET {{url}}v1/transfers/items?jobs={{job}}&parent={{parent}}&fields=all |
List Items for a Job by Status
| Code Block |
|---|
GET {{url}}v1/transfers/items?jobs={{job}}&fields=all&item_status=success |
Statuses for REST API calls include:
none[0]: No remediation flag has been applied to the item.
success[1]: Item was moved successfully with no modifications by DryvIQ.
skipped: Item was skipped due to a policy configuration defined in your job such as Large Item Policy or Duplicate Name Policy.
processed[2]: Item was reviewed and changed by DryvIQ during transfer. See processed statuses section below for further details.
remediation: DryvIQ could not transfer the item and it was flagged for manual remediation. This is the status you would use to get all flagged items.
retry: DryvIQ could not transfer the item and flagged it for retry. Default retry attempts is set to 3.
pending: Item has not finished transferring to the destination. If a job is paused or canceled, an item could go to a pending status as well.
List Items by Processed Status
Processed status means the item was reviewed and changed by DryvIQ during transfer.
| Code Block |
|---|
{{url}}v1/transfers/items?jobs={{job}}&fields=all&processing_status=converted |
Processed statuses include:
none: No processing has occurred on the item.
filtered: Item was filtered by DryvIQ to meet Job Filter configurations defined in your job (Job Filters).
skipped: Item was skipped due to a policy configuration defined in your job such as Large Item Policy or Duplicate Name Policy.
truncated: Item was modified by DryvIQ to conform to the destination platform requirements such as Segment Transformation Policy.
converted: Item was compressed into a zip file by DryvIQ because the item is not supported on the destination (Restricted Content).
conflict_copy: A copy of the item was created due to the policy configuration defined in your job (Conflict Policy).
access_rules: Permissions were applied to an item (Permissions Import).
metadata: Metadata was applied to an item (Metadata Import).
unmapped: DryvIQ was not able to map permissions or owner of the item.
List Items for a Job by Transfer Audit Category
Failed: Indicates the job audit log has captured one or more error entries.
Warning: Indicates the job audit log has captured one or more warning entries.
List all audit categories
| Code Block |
|---|
GET {{url}}v1/transfers/categories?priority=all |
List all items for a specific job and category
| Code Block |
|---|
GET {{url}}v1/transfers/{{job}}/items?fields=all&audit_categories={{category}} |
Get items for a Job formatted as CSV
All of the previous parameters can be added to this URL.
List all items for a specific job in .csv format
| Code Block |
|---|
GET {{url}}v1/transfers/{{job}}/items.csv |
Example Response
...