...

For several platforms, there is an option to share files and folders via a link. The preserved shared links policy determines whether "domain" or "anyone" links are transferred from the source to the destination. Permission Preservation must be configured in your job for Shared Links to be transferred.

...

Supported Platforms

The following platforms support shared links. Refer to the Platform Comparison to see conflict between platforms.

...

• (Anyone) People with the link: Anyone with the link view only.

• (Company) People in your company view only.

• (Company) Invited people only: shared link will be view only; invited users can be set as view or edit.

• Box has an additional option to view and download but we do not support transferring that and this is not an applicable option for SPO.

SkySync DryvIQ only supports anyone or domain (company). When transferring to SharePoint Online, the Box options will be translated as follows: 

• (Anyone) Anyone with the link can view.

• (Company) People in company with the link can view.

• (Company) Internal: People in company with the link can view and the invited users from within the company will be added to SPO direct access list with the corresponding edit or view rights.

• (Company) External Users: People in company with the link can view and the invited external user will go to the pending access & requests page.

...

These are the two REST API requests you can use to get the information on each type of shared link.

Code Block
GET url}}v1/transfers/items?processing=domain_shared_links&jobs={{job

Code Block
GET url}}v1/transfers/items?processing= anyone_shared_links&jobs={{job

Terms

Anyone/Anonymous: Links that can be shared with anyone

...

• Box: company

• Dropbox: team_only

• Google: domain

• SharePoint: organizational

Feature Support

SkySync DryvIQ handles shared links differently per platform. The following list defines different ways SkySync DryvIQ handles shared links.  Refer to the table below to see how SkySync DryvIQ handles shared links for each platform that supports this feature. 

...

...

REST API Examples

These are the two REST API requests you can use to get the information on each type of shared link.

GET {{url}}v1/transfers/items?processing=domain_shared_links&jobs={{job}}

GET {{url}}v1/transfers/items?processing=anyone_shared_links&jobs={{job}}

...

Example JSON

...

Example | Shared Links Basic Job

{
    "name":"Shared Links Example",
    "kind": "transfer",
    "transfer": {
        "transfer_type": "copy",
        "large_item": "skip",
        "batch_mode": "always",
    	"timestamps": "true",
    	"tags": "none",
    	"permissions": {
            "policy": "add",
            "links": true,
            "failures": "exceptions"
    	},
    	"segment_transform": true,
    	"preserve_owners": true,
    	"duplicate_names": "rename",
    	"empty_containers": "create",
    	"versioning": {
        	"preserve": "native",
        	"select": "all"
    	},
        "source": {
            "connection": { "id": "{{cloud_connection_source}}" },
            "target": {
                "path": "/sourcePath"
            }
        },
        "destination": {
            "connection": { "id": "{{cloud_connection_destination}}" },
            "target": {
                "path": "/destinationPath"
            }
        }
    },
    "schedule": {
        "mode": "manual"
    },
    "stop_policy": {
        "on_success": 2,
        "on_failure": 2
    },
    "category": {
    	"name": "Report | Shared Link Jobs"
   }
}

Example | Shared Links with Permissions Import

{
  "name":"Shared Links with Permissions Import",
  "kind": "transfer",
  "transfer": {
    "audit_level": "trace",
    "transfer_type": "copy",
    "permissions": {
      "policy": "add",
      "failures": "exceptions",
      "links": true,
      "import": {
        "source": {
          "text": {
            ["delimiter"]: ",", //optional, defaults to comma
            "target": {
              "path": "/permissions_import.csv"
            }
          }
        },
        "output": {
          "format": "text"
        }
      }
    }, 
    "source": {
      "connection": {
        "id": "{{nfs_connection}}" 
      },
      "target": {
        "path":"/"
      }
    },
    "destination": {
      "connection": {
        "id": "{{cloud_connection}}"
      },
      "target": {
        "path": "/destinationPath"
      }
    }
  },
    "schedule": {
        "mode": "manual"
    },
    "stop_policy": {
        "on_success": 2,
        "on_failure": 2
    },
    "category": {
    	"name": "Report | Shared Link Jobs"
   }
}