Use this operation to view the list of shared files and folders in Edge Drive.
Request
Syntax
GET <webservice>/drive/share?shareId={shareId} HTTP/1.1
Host: <host name>
Accept: application/xml
Authtoken: <authentication token>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Parameters
Name | Description | Required |
shareId | The unique identifier (syncWebFolderId response) returned when you share a file or folder or view the shared files and folders in Edge Drive. | No |
Request Headers
Name | Description |
Host | The host name of the Web Server or Web Console used in the API request. |
Accept | The format of the response. Valid values are: application/xml or application/json. |
Authtoken | The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication. |
Response
Response Parameters
Parameter | Description | Element |
permission | The capabilities assigned to Edge Drive users. | App_GetSharedFoldersResp |
cloudId | The ID generated for the newly created Edge Drive. | App_GetSharedFoldersResp |
contentIndexingEnabled | Indicates whether content indexing is enabled for the Edge Drive. Valid values are 1 and 0. | App_GetSharedFoldersResp |
dirDelim | Indicates the delimiter used for the file path in the Edge Drive. | App_GetSharedFoldersResp |
rootGUID | The GUID of the root folder in Edge Drive. | App_GetSharedFoldersResp |
backupsetId | The ID of the auto-created backup set for the Edge Drive. | App_GetSharedFoldersResp |
subclientId | The ID of the auto-created subclient for the Edge Drive. | App_GetSharedFoldersResp |
syncWebFolderId | The share ID of the auto-created sync web folder for the Edge Drive or the share ID of the file. | App_GetSharedFoldersResp |
syncWebFolderName | The name of the auto-created sync web folder for the Edge Drive or the name of the shared file. | App_GetSharedFoldersResp |
Examples
Sample Request
To view all the shared files and folders:
GET <webservice>/drive/share HTTP/1.1
Host: client1.mydomain.com
Accept: application/xml
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6
0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f
8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f
40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7
68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323
3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
To view the details for a specific shared file or folder:
GET <webservice>/drive/share?shareId=10 HTTP/1.1
Host: client1.mydomain.com
Accept: application/xml
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6
0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f
8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f
40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7
68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323
3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Sample Response
<App_GetSharedFoldersResp> <shares description="" userPermission="2" canUserEdit="1" ciEnabled="1" status="0"> <lastModified timeValue="1424922057"/> <client clientId="12" clientName="Edge Drive" applicationId="33" instanceId="1" backupsetId="46" subclientId="50"/> <owner userId="7" userName="user1"/> <shareFolder syncWebFolderId="36" syncWebFolderName="Pictures"/> <sharedTo permission="1" userType="1"> <sharedBy userId="7"/> <user userId="9" userName="domain\user1"/> <group/> <externalGroup/> </sharedTo> <browseInfo cloudId="1" edgeClient="1" driveType="testing"> <emailInfo browseUrl="/webconsole/browse/MyDrive.do?displayName=Pictures&isDirectoryShareBrowse=true&path=7c4e538afe864e25ae415357aa6fa04e&shareFolderId=36" dontSendEmail="1" emailMessage=""/> <paths directory="1" path="7c4e538afe864e25ae415357aa6fa04e"/> </browseInfo> </shares> </App_GetSharedFoldersResp>